Retrieve a conversation

Fetch a conversation by ID, including the full message thread.

Scope: conversations:read

Path parameters

Query parameters

Example request

curl https://dashboard.getmacha.com/api/v1/conversations/conv_6a392325b438d825ccaf0dc1 \
  -H "Authorization: Bearer $MACHA_API_KEY"

Example request with trigger payload

curl 'https://dashboard.getmacha.com/api/v1/conversations/conv_6a392325...?include_trigger_payload=true' \
  -H "Authorization: Bearer $MACHA_API_KEY"

Example response

{
  "data": {
    "id": "conv_6a392325b438d825ccaf0dc1",
    "title": "process ticket 549",
    "source": "autonomous",
    "agent_id": "agent_6a28e310f2ec711ef6dc1dcf",
    "model": "gpt-5",
    "autonomous": true,
    "is_onboarding": false,
    "is_simulation": false,
    "conversation_number": 225,
    "parent_conversation_id": null,
    "credits_used": 3,
    "metadata": { "ticketId": 549 },
    "message_count": 6,
    "last_message_at": "2026-06-10T05:26:55.455Z",
    "created_at": "2026-06-10T05:25:59.447Z",
    "updated_at": "2026-06-10T05:26:56.048Z",
    "messages": [
      { "id": "msg_...", "role": "user", "content": "process ticket 549", "created_at": "2026-06-10T05:25:59.500Z" },
      { "id": "msg_...", "role": "assistant", "content": "", "tool_calls": [...], "created_at": "..." }
    ]
  },
  "meta": { "request_id": "req_..." }
}

For very long conversations

If message_count is in the hundreds, loading the full thread on every request is wasteful. Use List conversation messages instead to paginate.

Errors