Blue Guardrails

Get Conversation

Get a specific conversation with its details.

Retrieve a single conversation by ID. Use embed=(messages) to include the full message history with generation metadata (tokens, model, latency).

GET
/v1/conversations/{conversation_id}

Path Parameters

conversation_id*string
Formatuuid

Query Parameters

embed?|

Embed resources: (messages)

Header Parameters

x-workspace-id?|

Workspace UUID for session-authenticated calls.

Response Body

application/json

application/json

curl -X GET "https://loading/v1/conversations/497f6eca-6276-4993-bfeb-53cbbbba6f08"
{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "external_id": "string",
  "created_at": "2019-08-24T14:15:22Z",
  "updated_at": "2019-08-24T14:15:22Z",
  "message_count": 0,
  "annotation_count": 0,
  "tool_call_annotation_count": 0,
  "total_input_tokens": 0,
  "total_output_tokens": 0,
  "generation_models": [
    "string"
  ],
  "tags": {
    "property1": "string",
    "property2": "string"
  },
  "first_message_preview": "string",
  "messages": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "role": "string",
      "parts": [
        {}
      ],
      "sequence_number": 0,
      "origin_agent_run_id": "string",
      "origin_run_tags": {
        "property1": "string",
        "property2": "string"
      },
      "created_at": "2019-08-24T14:15:22Z",
      "updated_at": "2019-08-24T14:15:22Z",
      "generation": {
        "model": "string",
        "input_tokens": 0,
        "output_tokens": 0,
        "cost_usd": 0,
        "response_id": "string",
        "provider": "string",
        "finish_reasons": [
          "string"
        ],
        "agent_description": "string",
        "agent_id": "string",
        "agent_name": "string"
      }
    }
  ]
}
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}