Chat

Get a conversation's status

GET
/api/v2/chat/{session_id}/status

The conversation's state and its messages so far. A turn queued and not yet picked up reads queued with no messages. An assistant message may carry reasoning and thoughts, the newest 20 of each, each at most 4,000 characters.

A self-hosted install adds worker_id, and writes times as 2026-10-04 17:55:02+00:00.

apiKey
headerAuthorizationBearer <token>

An API key, sk-syn- and 32 characters. On SynapseOrch Cloud an owner or admin makes it under Settings → Developer; on a self-hosted install, under Settings → API Keys.

session_id*string

The conversation, from the turn's answer.

Response Body

The conversation.

application/json
  1. response
session_id?string
agent_id?string
status?string
messages?array<>
last_message_at?string
curl -X GET "https://api.synapseorch.com/api/v2/chat/chat_01a1205c3e8f7a2b9d4c6e1f0a3b5d7c/status" \  -H "Authorization: Bearer sk-syn-..."
{  "session_id": "chat_01a1205c3e8f7a2b9d4c6e1f0a3b5d7c",  "agent_id": "agent_01a10b7e2c4d6f8a0b1c3d5e7f9a2b4c",  "status": "idle",  "messages": [    {      "role": "user",      "content": "What are your payment terms for a new account?"    },    {      "role": "assistant",      "content": "New accounts pay net-30 after the first order, which is paid on invoice."    }  ],  "last_message_at": "2026-10-04T17:55:02Z"}