Sign in
OpenAPI 3.0.3raw.githubusercontent.com2026-08-207311,8115.6 MB

c36ed1cbdbb5

agent builder

Create conversation

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</span></div>

Refer to Spaces for more information.

Create an empty conversation without sending a message. Returns the created conversation immediately. Use this to obtain a conversation ID before starting a chat session. To learn more about agent conversations, refer to the agent chat documentation.<br/><br/>[Required authorization] Route required privileges: agentBuilder:read.

post/api/agent_builder/conversations

Headers

kbn-xsrfstring required
Example:true

A required header to protect against CSRF attacks

Request body

agent_idstring

The ID of the agent to associate with the conversation. Defaults to the default Elastic AI agent.

conversation_idstring

Optional client-supplied UUID for the conversation. Server-generated if omitted.

titlestring

Title for the conversation. Defaults to "New conversation".

Response

Indicates a successful response