Delete conversation attachment

Base URL: https://{kibana_url}

DELETE /api/agent_builder/conversations/{conversation_id}/attachments/{attachment_id}

Auth

Delete an attachment. By default performs a soft delete (can be restored). Use permanent=true to permanently remove unreferenced attachments.

Required authorization

Privileges agentBuilder:read

Path parameters

conversation_id string · max length: 256 required: The unique identifier of the conversation.
attachment_id string · max length: 256 required: The unique identifier of the attachment to delete.

Query parameters

permanent boolean: If true, permanently removes the attachment (only for unreferenced attachments).

Header parameters

kbn-xsrf string required: A required header to protect against CSRF attacks

Response

200

Indicates a successful response

application/json

Base URL: https://{kibana_url}

Examples

Request Console 1 / 2 languages

Console Kibana Dev Tools

DELETE kbn:/api/agent_builder/conversations/CONVERSATION_ID/attachments/ATTACHMENT_ID

Generated from the API spec

curl Shell

curl -X DELETE "${KIBANA_URL}/api/agent_builder/conversations/${CONVERSATION_ID}/attachments/${ATTACHMENT_ID}" \
  -H "kbn-xsrf: true" \
  -H "Authorization: ApiKey ${API_KEY}"

Generated from the API spec

Response

Example response for permanent delete (cannot be restored)

{
  "permanent": true,
  "success": true
}