agent builder

Create conversation attachment

Changed on

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

Request

  • Base URL
    https://localhost:5601
  • URL
    https://localhost:5601/api/agent_builder/conversations/{conversation_id}/attachments
  • Auth
    • API key in header Authorization
    • or HTTP basic

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

dataunknown required
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.

render_inlineboolean

When true, the attachment is rendered inline in the UI when the conversation is opened, without the agent referencing it.

typestring required

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

Response

Indicates a successful response

Changes

  • 94842f326dc0Revision changes
    • info

      added the new optional request property

  • 640b2c77ef00Revision changes
    • warning

      for the path request parameter conversation_id, the maxLength was set to 256

    • warning

      the request property's maxLength was set to 2048

    • warning

      the request property's maxLength was set to 256

    • warning

      the request property's maxLength was set to 2048

    • warning

      the request property's maxLength was set to 256