Get conversation by ID Technical Preview; added in 9.2.0

View as Markdown
GET /api/agent_builder/conversations/{conversation_id}
Api key auth Basic auth

Spaces method and path for this operation:

get /s/{space_id}/api/agent_builder/conversations/{conversation_id}

Refer to Spaces for more information.

Get a specific conversation by ID. Use this endpoint to retrieve the complete conversation history including all messages and metadata.

[Required authorization] Route required privileges: read_onechat.

Path parameters

  • conversation_id string Required

    The unique identifier of the conversation to retrieve.

Responses

  • 200 application/json

    Indicates a successful response

GET /api/agent_builder/conversations/{conversation_id} 
curl \
 --request GET 'https://localhost:5601/api/agent_builder/conversations/{conversation_id}' \
 --header "Authorization: $API_KEY"
Response examples (200)
Example response containing the contents of a convesation with the chat agent 
{
  "id": "bcc176c5-38f6-40be-be0c-898e34fa1480",
  "user": {
    "username": "elastic"
  },
  "title": "General Greeting",
  "rounds": [
    {
      "id": "170ec3b2-0f5a-4538-8b60-549572386d2a",
      "input": {
        "message": "Hello, how are you?"
      },
      "steps": [],
      "response": {
        "message": "Since this is a general greeting that doesn't require any organizational or product-specific information, I can respond without using tools.\n\nHello! I'm doing well, thank you for asking. I'm here to help you with any questions you may have. How can I assist you today?"
      }
    }
  ],
  "agent_id": "elastic-ai-agent",
  "created_at": "2025-09-19T17:45:39.554Z",
  "updated_at": "2025-09-19T17:45:39.554Z"
}