The DELETE /interactions/delete-batch endpoint deletes up to 1000 interactions together with their interaction content (call recordings, transcripts, and categorization results). Specify the interactions to delete using a list of interaction GUIDs. Send deletion requests individually. Concurrent deletions result in 429 Too Many Requests errors.
| Panel |
|---|
| borderColor | #eeeeee |
|---|
| bgColor | white |
|---|
| titleColor | white |
|---|
| borderWidth | 1 |
|---|
| titleBGColor | #ffa78c |
|---|
| borderStyle | solid |
|---|
| title | In this page |
|---|
|
|
| Insert excerpt |
|---|
| _ExcerptAPICloudNextGen |
|---|
| _ExcerptAPICloudNextGen |
|---|
| nopanel | true |
|---|
|
Parameters
The endpoint accepts the following body parameters:
guids
Type | Required | Example |
|---|
| Array of strings | True | {
"guids": [
"1870c11f-a216-4967-9f84-e5f39aff17f1",
"ba11953e-dfdf-4f98-a53b-49ad6c31df58"
]
} |
An array of unique identifiers (GUIDs) of the interactions to be deleted.
Request
Delete a batch of interactions
| Code Block |
|---|
| language | powershell |
|---|
| theme | Midnight |
|---|
|
curl -L -X DELETE "https://***.api.newvoicemedia.com/interaction-content/interactions/delete-batch" \
-H "Accept: application/vnd.newvoicemedia.v3+json" \
-H "Authorization: Bearer <ACCESS_TOKEN>" \
-H "Content-Type: application/json" \
--data-raw "{
\"guids\": [
\"1870c11f-a216-4967-9f84-e5f39aff17f1\",
\"ba11953e-dfdf-4f98-a53b-49ad6c31df58\"
]
}" |
Body:
| Code Block |
|---|
|
{
"guids": [
"1870c11f-a216-4967-9f84-e5f39aff17f1",
"ba11953e-dfdf-4f98-a53b-49ad6c31df58"
]
} |
Responses
Successful response
...
failures. A array of failed deletions messages.guid. The unique identifier of the interaction that was not deleted.message. Error message that describes what went wrong during deletion.statusCode. HTTP response code for the error