---
updatedAt: 2026-04-08T10:20:19.000Z
agentTools:
projectIndex: https://developer.goacoustic.com/acoustic-content/llms.txt
---
# Delete an existing asset.
Use this endpoint to immediately delete an existing asset from the database.
User roles: admin, manager, editor
# OpenAPI definition
```json
{
"openapi": "3.0.0",
"info": {
"version": "1.0.142",
"x-ibm-name": "ibm-watson-content-hub-api",
"title": "Acoustic Content API",
"description": "Copyright © Acoustic, L.P. 2019"
},
"tags": [
{
"name": "Authoring assets",
"description": "\n## General\nUse the Content Asset service Rest APIs to work with assets. Assets are file types that are uploaded or created such as an image file, video file, or text that are used in content items. You can create, retrieve, update, and delete assets in a database. Managed assets are those located in the root dxdam directory as specified by its path and are visible on the Content UI.\n## Content workflow (status)\nThe status of a content item can be determined by the **suffix** of the ID:\n- An ID like xxxx:**draft** indicates that the item is a draft. This is the initial status of a new content item until it is published. A draft of a published content item will also have this suffix.\n- An ID like xxxx:***[publishing_job_id]*** - indicates that the content item has been scheduled for publish in the given publishing job.\n- An ID like xxxx with no suffix indicates that the content is **published** or **retired**.\nA draft can be created from published. When such a draft is published, it will override the previously published content.\n\n**Key notes:**\n- The base ID (xxxx) does not change. Only the suffix changes according to the workflow status of the item.\n- Where content and assets are referenced from within a content item, the 'raw' ID form, without a suffix, is always used. For example, when a draft content item is referenced by another draft content item, the reference appears as a raw ID, and thus does not change when the items are published.\n- API clients should not depend on the ID format and should not attempt to parse it. Instead, the ***linkedDocId*** and ***links*** properties should be used.\n- Draft item have a property ***linkedDocId***. This is the Id that the draft item will have when it is published.\n- Draft items that have a published version will have a ***linkedDoc*** property within the ***links*** property. This property will not appear for drafts that do not have a published version."
}
],
"paths": {
"/authoring/v1/assets/{id}": {
"delete": {
"tags": [
"Authoring assets"
],
"summary": "Delete an existing asset.",
"description": "Use this endpoint to immediately delete an existing asset from the database.
User roles: admin, manager, editor",
"parameters": [
{
"name": "id",
"in": "path",
"description": "Provide the ID of the asset that you want to delete.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "If-Match",
"in": "header",
"description": "Provide an Etag value from a previous request to check when an asset was last updated. If the Etag value that you provide is old, the call returns a 412 with the latest version of the asset.",
"required": false,
"schema": {
"type": "string"
}
}
],
"responses": {
"204": {
"description": "Successfully deleted the asset that matches the ID that you provided."
},
"404": {
"description": "The asset with the provided id was not found.",
"content": {
"application/json": {
"schema": {
"type": "object",
"description": "an error response.",
"properties": {
"requestId": {
"type": "string",
"description": "The current request ID",
"example": "d64dc285-0b62-aaa3-841f-de3588b64d34"
},
"service": {
"type": "string",
"description": "The name of the service that produced the error",
"example": "authoring-resource"
},
"requestMethod": {
"type": "string",
"description": "The Http method type of the current request",
"example": "GET"
},
"requestUri": {
"type": "string",
"description": "The request uri",
"example": "/authoring/v1/assets"
},
"errors": {
"type": "array",
"items": {
"type": "object",
"description": "an individual error, info or warning message.",
"properties": {
"code": {
"type": "integer",
"description": "The message code"
},
"key": {
"type": "string",
"description": "The message key",
"example": "error.asset.1"
},
"message": {
"type": "string",
"description": "The error message",
"example": "The id requested does not exist."
},
"description": {
"type": "string",
"description": "Optional detailed error message",
"example": "Please check the ID you provided is correct before retrying the request."
},
"category": {
"type": "string",
"description": "The message category whereby only user messages are designed to be shown to an end user",
"enum": [
"API",
"USER"
]
},
"level": {
"type": "string",
"description": "Indicates the message level",
"enum": [
"INFO",
"WARNING",
"ERROR"
]
},
"parameters": {
"type": "object",
"description": "The message parameters of this message."
},
"locale": {
"type": "string",
"description": "The current locale used to produce the error message.",
"example": "en"
}
},
"required": [
"code",
"key",
"message",
"description",
"category",
"level",
"parameters",
"locale"
]
}
}
},
"required": [
"requestId",
"service",
"requestMethod",
"requestUri",
"errors"
]
}
}
}
},
"409": {
"description": "The Etag provided in the If-Match header does not correspond to the latest version.",
"content": {
"application/json": {
"schema": {
"type": "object",
"description": "an error response.",
"properties": {
"requestId": {
"type": "string",
"description": "The current request ID",
"example": "d64dc285-0b62-aaa3-841f-de3588b64d34"
},
"service": {
"type": "string",
"description": "The name of the service that produced the error",
"example": "authoring-resource"
},
"requestMethod": {
"type": "string",
"description": "The Http method type of the current request",
"example": "GET"
},
"requestUri": {
"type": "string",
"description": "The request uri",
"example": "/authoring/v1/assets"
},
"errors": {
"type": "array",
"items": {
"type": "object",
"description": "an individual error, info or warning message.",
"properties": {
"code": {
"type": "integer",
"description": "The message code"
},
"key": {
"type": "string",
"description": "The message key",
"example": "error.asset.1"
},
"message": {
"type": "string",
"description": "The error message",
"example": "The id requested does not exist."
},
"description": {
"type": "string",
"description": "Optional detailed error message",
"example": "Please check the ID you provided is correct before retrying the request."
},
"category": {
"type": "string",
"description": "The message category whereby only user messages are designed to be shown to an end user",
"enum": [
"API",
"USER"
]
},
"level": {
"type": "string",
"description": "Indicates the message level",
"enum": [
"INFO",
"WARNING",
"ERROR"
]
},
"parameters": {
"type": "object",
"description": "The message parameters of this message."
},
"locale": {
"type": "string",
"description": "The current locale used to produce the error message.",
"example": "en"
}
},
"required": [
"code",
"key",
"message",
"description",
"category",
"level",
"parameters",
"locale"
]
}
}
},
"required": [
"requestId",
"service",
"requestMethod",
"requestUri",
"errors"
]
}
}
}
},
"429": {
"description": "Too Many Requests, the server has reached a limit, the request must be sent again at a later time.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
},
"503": {
"description": "Connection failed to data store.",
"content": {
"application/json": {
"schema": {
"type": "object",
"description": "an error response.",
"properties": {
"requestId": {
"type": "string",
"description": "The current request ID",
"example": "d64dc285-0b62-aaa3-841f-de3588b64d34"
},
"service": {
"type": "string",
"description": "The name of the service that produced the error",
"example": "authoring-resource"
},
"requestMethod": {
"type": "string",
"description": "The Http method type of the current request",
"example": "GET"
},
"requestUri": {
"type": "string",
"description": "The request uri",
"example": "/authoring/v1/assets"
},
"errors": {
"type": "array",
"items": {
"type": "object",
"description": "an individual error, info or warning message.",
"properties": {
"code": {
"type": "integer",
"description": "The message code"
},
"key": {
"type": "string",
"description": "The message key",
"example": "error.asset.1"
},
"message": {
"type": "string",
"description": "The error message",
"example": "The id requested does not exist."
},
"description": {
"type": "string",
"description": "Optional detailed error message",
"example": "Please check the ID you provided is correct before retrying the request."
},
"category": {
"type": "string",
"description": "The message category whereby only user messages are designed to be shown to an end user",
"enum": [
"API",
"USER"
]
},
"level": {
"type": "string",
"description": "Indicates the message level",
"enum": [
"INFO",
"WARNING",
"ERROR"
]
},
"parameters": {
"type": "object",
"description": "The message parameters of this message."
},
"locale": {
"type": "string",
"description": "The current locale used to produce the error message.",
"example": "en"
}
},
"required": [
"code",
"key",
"message",
"description",
"category",
"level",
"parameters",
"locale"
]
}
}
},
"required": [
"requestId",
"service",
"requestMethod",
"requestUri",
"errors"
]
}
}
}
},
"default": {
"description": "Unexpected error.",
"content": {
"application/json": {
"schema": {
"type": "object",
"description": "an error response.",
"properties": {
"requestId": {
"type": "string",
"description": "The current request ID",
"example": "d64dc285-0b62-aaa3-841f-de3588b64d34"
},
"service": {
"type": "string",
"description": "The name of the service that produced the error",
"example": "authoring-resource"
},
"requestMethod": {
"type": "string",
"description": "The Http method type of the current request",
"example": "GET"
},
"requestUri": {
"type": "string",
"description": "The request uri",
"example": "/authoring/v1/assets"
},
"errors": {
"type": "array",
"items": {
"type": "object",
"description": "an individual error, info or warning message.",
"properties": {
"code": {
"type": "integer",
"description": "The message code"
},
"key": {
"type": "string",
"description": "The message key",
"example": "error.asset.1"
},
"message": {
"type": "string",
"description": "The error message",
"example": "The id requested does not exist."
},
"description": {
"type": "string",
"description": "Optional detailed error message",
"example": "Please check the ID you provided is correct before retrying the request."
},
"category": {
"type": "string",
"description": "The message category whereby only user messages are designed to be shown to an end user",
"enum": [
"API",
"USER"
]
},
"level": {
"type": "string",
"description": "Indicates the message level",
"enum": [
"INFO",
"WARNING",
"ERROR"
]
},
"parameters": {
"type": "object",
"description": "The message parameters of this message."
},
"locale": {
"type": "string",
"description": "The current locale used to produce the error message.",
"example": "en"
}
},
"required": [
"code",
"key",
"message",
"description",
"category",
"level",
"parameters",
"locale"
]
}
}
},
"required": [
"requestId",
"service",
"requestMethod",
"requestUri",
"errors"
]
}
}
}
}
},
"x-ibm-dx-security-user-roles": [
"admin",
"manager",
"editor"
]
}
}
},
"components": {
"schemas": {
"ErrorResponse": {
"description": "This JSON record represents an error condition.",
"type": "object",
"properties": {
"errors": {
"type": "array",
"items": {
"description": "This JSON record represents an individual error or warning contained in an error message.",
"type": "object",
"properties": {
"code": {
"type": "integer",
"description": "An error code"
},
"message": {
"type": "string",
"description": "A message describing what went wrong."
},
"description": {
"type": "string",
"description": "Further explanation of the error condition and potential next steps to resolve the problem."
},
"more_info": {
"type": "string",
"description": "A URL pointing to a web site that provides more information on the given error condition."
},
"level": {
"type": "string",
"enum": [
"ERROR",
"WARNING"
],
"description": "The severity level of the message. Default is error."
},
"parameters": {
"type": "object",
"description": "Additional properties reflecting the dynamic parts of the error condition."
},
"cause": {
"type": "object",
"description": "This property can be used to transport causing error message records produced by a down stream service calls."
},
"locale": {
"type": "string",
"description": "This property represents the locale of the text contained in properties 'message', and 'description'. This property is mandatory if message and description contain translated text."
}
},
"required": [
"code",
"message"
]
}
},
"requestId": {
"type": "string",
"description": "The ID of the failing request."
},
"service": {
"type": "string",
"description": "The name of the service serving the error message."
}
},
"required": [
"errors",
"requestId"
]
}
}
},
"x-readme": {
"explorer-enabled": true,
"proxy-enabled": true
}
}
```