LoudVoice API \ Discussions \ Delete discussion
LoudVoice API Resources
| Resource/URI - Discussions | GET | POST | PUT | DELETE |
|---|---|---|---|---|
Discussions
/loudvoice/discussions.json
|
List all discussions | Create a discussion | – | – |
Discussion
/loudvoice/discussions/<discussion_token>.json
|
Read a discussion | – | Update a discussion | Delete a discussion |
Discussion messages
/loudvoice/comments/<discussion_token>/comments.json
|
Read discussion comments | – | – | – |
| Resource/URI - Authors | GET | POST | PUT | DELETE |
|---|---|---|---|---|
Authors
/loudvoice/authors.json
|
List all authors | Create an author | – | – |
Author
/loudvoice/authors/<author_token>.json
|
Read an author | – | Update an author | Delete an author |
| Resource/URI - Author Sessions | GET | POST | PUT | DELETE |
|---|---|---|---|---|
Author Sessions
/loudvoice/authors/sessions.json
|
List all sessions | – | Create or update a session | – |
Author Session
/loudvoice/authors/sessions/<session_token>.json
|
– | – | – | Delete a session |
| Resource/URI - Comments | GET | POST | PUT | DELETE |
|---|---|---|---|---|
Comments
/loudvoice/comments.json
|
List all comments | Create a comment | – | – |
Comment
/loudvoice/comments/<comment_token>.json
|
Read a comment | – | Update a comment | Delete a comment |
| Resource/URI - Votes | GET | POST | PUT | DELETE |
|---|---|---|---|---|
Votes
/loudvoice/votes.json
|
List all votes |
– | – | – |
Vote
/loudvoice/votes/comments/<comment_token>/authors/<author_token>.json
|
Read a vote | – | Cast a vote | Delete a vote |
Workflow
Request: the code to send to the API
Send an API request to one of these endpoints in order to delete an existing discussion:
DELETE
/loudvoice/discussion/<discussion_token>.json
DELETE
/loudvoice/discussions/discussion.json?discussion_reference=<discussion_reference>
The <discussion_token> represents the unique identifier of the discussion.
The <discussion_reference> is the unique reference that you optionally specified when you created the discussion.
To prevent you from unintentionally deleting an entry by mixing up the DELETE/GET methods you have to include the url parameter confirm_deletion=true when calling the endpoint.
Result: the code returned by the API
The API will either return a HTTP status code 200 if the entry was successfully deleted
or an appropriate message body with further details on the error that occured.
Response Example
{
"response": {
"request": {
"date": "Thu, 07 Nov 2019 17:20:32 +0100",
"resource": "/loudvoice/discussions/5eb7c907-ce29-477f-afd5-aedda0e0c255.json?confirm_deletion=true",
"status": {
"flag": "success",
"code": 200,
"info": "The specified discussion has successfully been removed"
}
}
}
}