v53

latestOpenAPI 3.0.3raw.githubusercontent.com2026-08-076771,7565.2 MB
agent builder

Create conversation attachment

Spaces method and path for this operation:

<div><span class="operation-verb post">post</span>&nbsp;<span class="operation-path">/s/{space_id}/api/agent_builder/conversations/{conversation_id}/attachments</span></div>

Refer to Spaces for more information.

Create a new attachment for a conversation with version tracking.<br/><br/>[Required authorization] Route required privileges: agentBuilder:read.

post/api/agent_builder/conversations/{conversation_id}/attachments

Path parameters

conversation_idstring required

The unique identifier of the conversation.

Headers

kbn-xsrfstring required
Example:true

A required header to protect against CSRF attacks

Request body

{"stackTrail":"paths:/api/agent_builder/conversations/{conversation_id}/attachments:post:requestBody:content:application/json:schema:properties:data","oasType":"schema","type":"unknown","description":"The attachment data/content. Required unless origin is provided.","nullable":true}
descriptionstring

Human-readable description of the attachment.

hiddenboolean

Whether the attachment should be hidden from the user.

idstring

Optional custom ID for the attachment.

originstring

Origin string (for example, saved object ID) for by-reference attachments. When provided without data, the content is resolved once at creation time.

typestring required

The type of the attachment (e.g., text, esql, visualization).

Response

Indicates a successful response