Get chat conversation | Astro AI

{
  "conversation_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "title": "Project Kickoff Discussion",
  "updated_at": "2024-01-15T09:30:00Z",
  "assistant_streaming": true,
  "messages": [
    {
      "id": "msg-00123",
      "role": "user",
      "content": "Can you provide the project timeline and key milestones?",
      "attachments": [
        {
          "key": "file-7890abc",
          "name": "project_overview.pdf",
          "content_type": "application/pdf",
          "size": 245760
        }
      ]
    }
  ],
  "has_more": true,
  "oldest_seq": 42
}

Returns one conversation’s thread (messages in order) plus assistant_streaming (true while an assistant reply is still being persisted). Omit limit for the full thread; pass limit for the tail and before_seq to page older messages. When a page is returned, has_more and oldest_seq describe the remaining history.

Authentication

AuthorizationBearer

OAuth 2.0 device flow or platform session token

Path parameters

deploymentIdstringRequired

Deployment ID

conversationIdstringRequired

Conversation ID (client-chosen UUID v4)

Query parameters

limitintegerOptional

Return only the most recent N messages (tail). Omit for the full thread.

before_seqintegerOptional

Return messages older than this sequence number (pagination cursor).

Response

Conversation thread

conversation_idstring

titlestring

updated_atdatetime

assistant_streamingboolean

messageslist of objects

has_moreboolean

Present when a page was returned; more (older) messages exist.

oldest_seqinteger

Sequence number of the oldest message in this page (pagination cursor).

Errors

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error

$	curl https://astropods.com/api/v1/deployments/deploymentId/chat/conversations/conversationId \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json"