Delete an external storage item
- Helen Griffith
Beta/Early Access Program
This API is in the Beta/Early Access Program and is still under development. If you are interested in using this API, please contact your Customer Success Manager or Account Manager. Participation in this pilot program is at the discretion of Product Management and not guaranteed.
Use of this API outside of the program is prohibited.
The DELETE /interactions/external-storage/{id} endpoint enables you to delete an external storage item by ID.
Headers
Header parameters in Requests (Interaction Content Export API) apply to this endpoint.
Authorization scopes supported:
| Scope | Access granted |
|---|---|
interaction-content:read | Entire endpoint |
Parameters
The endpoint accepts the following path parameters:
id
Type | Required | Example |
|---|---|---|
| String | True | 74137e23-9716-4e5c-ad92-3634c248282 |
Unique external storage item identifier.
Request
Request to delete an external storage
curl -L -X DELETE "https://***.api.cc.vonage.com/interaction-content-export/external-storage/74137e23-9716-4e5c-ad92-3634c248282" \ -H "Authorization: Bearer <ACCESS_TOKEN>" \ -H "Accept: application/vnd.newvoicemedia.v1+json"
Responses
Responses to the endpoint return no content.
Successful response
For information about successful responses, see Success response code and parameters in Responses (Interaction Content Export API).
Error response
External storage delete failed due to conflict
After using the DELETE /interactions/external-storage/{id} endpoint to delete a storage item, the API performs check if there are any jobs that have status other than Cancelled or Completed. If the check fails, the API returns a 409 Conflict error with following message:
{
"message": "Can't delete external storage, it's referenced by unfinished job(s). To delete storage, jobs referencing it must be in (Completed, Cancelled) status."
}
For information, see Trying out Vonage Contact Center APIs.