Skip to content

Delete Content
Stable

Request

Permanently deletes a content item from the enterprise's Content Management library by content_id. This action is irreversible — the file and its metadata are removed immediately and cannot be recovered.

Common Use Cases

Removing outdated or superseded files from the content library Cleaning up test or temporary files uploaded during development Maintaining a tidy library by removing content that is no longer referenced in any active device operations

Best Practices

Confirm the correct content_id using GET /v0/enterprise/{enterprise_id}/content/{content_id}/ before deleting — this action cannot be undone Verify the file is not actively referenced in any pending or scheduled device push operations before deleting to avoid broken references Use GET /v0/enterprise/{enterprise_id}/content/ to audit the library and identify candidates for deletion

Security
esper_cloud_api_apiKey
Path
content_idstring, (uuid)required

A UUID string identifying a content instance.

enterprise_idstringrequired

A UUID string identifying enterprise.

cURL
curl -i -X DELETE \
  'https://api.esper.io/_mock/openapi/v0/enterprise/{enterprise_id}/content/{content_id}/' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

The resource was deleted successfully.

Response
No content