Sign in
agent builder

Send chat message

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

Refer to Spaces for more information.

Send a message to an agent and receive a complete response. This synchronous endpoint waits for the agent to fully process your request before returning the final result. Use this for simple chat interactions where you need the complete response. To learn more about agent chat, refer to the agent chat documentation.<br/><br/>[Required authorization] Route required privileges: agentBuilder:read.

post/api/agent_builder/converse

Headers

kbn-xsrfstring required
Example:true

A required header to protect against CSRF attacks

Request body

_execution_mode'local' | 'task_manager'

define how to execute the agent (local execution or via task_manager)

action'regenerate'

Deprecated and ignored. The "regenerate" action has been removed; the field is still accepted for backward compatibility.

agent_idstring

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

connector_idstring nullable

Optional connector ID for the agent to use for model routing. Mutually exclusive with inference_id; omit or use only one.

conversation_idstring

Optional existing conversation ID to continue a previous conversation.

execution_idstring

Optional client-generated execution ID. Provide it to address this execution later (for example, to abort it). Must be unique; defaults to a server-generated ID.

inference_idstring nullable

Optional inference endpoint ID for model routing (public alias for the same internal identifier as connector_id). Mutually exclusive with connector_id.

inputstring

The user input message to send to the agent.

project_routingstring

Cross-project search routing expression resolved from the header project picker, applied to the run's searches. Serverless (CPS) only; ignored elsewhere.

promptsobject

Use this field to respond to a confirmation, authorization, or ask_user_question prompt. Send an allow boolean to answer a confirmation prompt, an authorized boolean to answer an authorization prompt, or an answers array (one entry per question) to answer an ask_user_question prompt.

read_onlyboolean

When true, the created conversation is presented as read-only in the UI: its history is shown but no message input is offered. This carries no authorization meaning — the conversation can still be continued through the API. This setting is ignored when continuing an existing conversation.

reasoning_level'none' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh'

Reasoning effort level for the LLM. One of: none, minimal, low, medium, high, xhigh. Support depends on the underlying model and provider.

Response

Indicates a successful response

Changes

Changed in 7 of the 176 revisions of this API.26

  • 94842f326dc01See the full diff
    • ○

      request property deprecated

      request-property-deprecated

  • 1e4ce06e38091See the full diff
    • ●

      the request property's maxLength was set to 256

      request-property-max-length-set

  • b098d0a133f11See the full diff
    • ○

      added the new optional request property

      new-optional-request-property

  • 52979c990ed31See the full diff
    • ●

      removed the request property

      request-property-removed

  • 9949109ac0ad1See the full diff
    • ○

      added the new optional request property

      new-optional-request-property

  • 0cf33784b2ed1See the full diff
    • ○

      added the new optional request property

      new-optional-request-property

  • e38d633f77af2See the full diff
    • ○

      added the new optional request property /

      new-optional-request-property

    • ○

      added the new optional request property /

      new-optional-request-property

Of the 176 revisions, 20 have no diff computed.