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" } } } }