Skip to main content
GET
/
conversations
/
{conversation_id}
Get Conversation Endpoint
curl --request GET \
  --url https://api.zo.computer/conversations/{conversation_id} \
  --header 'Authorization: Bearer <token>'
{
  "conversation": {
    "id": "<string>",
    "user_id": "<string>",
    "host_id": "<string>",
    "title": "<string>",
    "type": "<string>",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "deleted_at": "2023-11-07T05:31:56Z",
    "metadata": {}
  },
  "messages": [
    {
      "kind": "request",
      "parts": [
        {
          "part_kind": "<string>",
          "content": "<string>",
          "tool_name": "<string>",
          "tool_call_id": "<string>",
          "args": "<string>",
          "timestamp": "2023-11-07T05:31:56Z"
        }
      ],
      "timestamp": "2023-11-07T05:31:56Z",
      "model_name": "<string>",
      "persona_id": "<string>",
      "persona_name": "<string>",
      "persona_image": "<string>",
      "input_tokens": 123,
      "output_tokens": 123,
      "cache_read_tokens": 123,
      "cache_write_tokens": 123,
      "metadata": {}
    }
  ],
  "state": "idle"
}

Authorizations

Authorization
string
header
required

Zo API key (zo_sk_...)

Path Parameters

conversation_id
string
required

Response

Successful Response

Response for GET /conversations/{conversation_id}.

conversation
ConversationDetail · object
required

Conversation metadata

messages
ModelMessageResponse · object[]
required

Full message history

state
enum<string>
default:idle

Current conversation state. 'running' means agent is actively streaming.

Available options:
idle,
running,
stopping