> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.astropods.com/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.astropods.com/_mcp/server. # Get chat conversation GET https://astropods.com/api/v1/deployments/{deploymentId}/chat/conversations/{conversationId} 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. Reference: https://docs.astropods.com/api-reference/astro-ai-api/chat/get-chat-conversation ## OpenAPI Specification ```yaml openapi: 3.1.0 info: title: astro-api version: 1.0.0 paths: /deployments/{deploymentId}/chat/conversations/{conversationId}: get: operationId: get-chat-conversation summary: Get chat conversation description: > 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. tags: - chat parameters: - name: deploymentId in: path description: Deployment ID required: true schema: type: string - name: conversationId in: path description: Conversation ID (client-chosen UUID v4) required: true schema: type: string - name: limit in: query description: >- Return only the most recent N messages (tail). Omit for the full thread. required: false schema: type: integer - name: before_seq in: query description: Return messages older than this sequence number (pagination cursor). required: false schema: type: integer - name: Authorization in: header description: OAuth 2.0 device flow or platform session token required: true schema: type: string responses: '200': description: Conversation thread content: application/json: schema: $ref: '#/components/schemas/ChatConversation' '401': description: Authentication required content: application/json: schema: $ref: '#/components/schemas/Error' '403': description: Insufficient permissions for this account content: application/json: schema: $ref: '#/components/schemas/Error' '404': description: Resource not found content: application/json: schema: $ref: '#/components/schemas/Error' '500': description: Server error content: application/json: schema: $ref: '#/components/schemas/Error' servers: - url: https://astropods.com/api/v1 description: Astro AI API server components: schemas: ChatMessageRole: type: string enum: - user - assistant title: ChatMessageRole ChatFileAttachment: type: object properties: key: type: string name: type: string description: User-facing filename. content_type: type: string size: type: integer format: int64 required: - key - name - content_type - size title: ChatFileAttachment ChatMessage: type: object properties: id: type: string role: $ref: '#/components/schemas/ChatMessageRole' content: type: string attachments: type: array items: $ref: '#/components/schemas/ChatFileAttachment' title: ChatMessage ChatConversation: type: object properties: conversation_id: type: string title: type: string updated_at: type: string format: date-time assistant_streaming: type: boolean messages: type: array items: $ref: '#/components/schemas/ChatMessage' has_more: type: boolean description: Present when a page was returned; more (older) messages exist. oldest_seq: type: integer description: >- Sequence number of the oldest message in this page (pagination cursor). title: ChatConversation Error: type: object properties: error: type: string details: type: string title: Error securitySchemes: BearerAuth: type: http scheme: bearer description: OAuth 2.0 device flow or platform session token ``` ## Examples **Request** ```json {} ``` **Response** ```json { "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 } ``` **SDK Code** ```python import requests url = "https://astropods.com/api/v1/deployments/deploymentId/chat/conversations/conversationId" payload = {} headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.get(url, json=payload, headers=headers) print(response.json()) ``` ```javascript const url = 'https://astropods.com/api/v1/deployments/deploymentId/chat/conversations/conversationId'; const options = { method: 'GET', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://astropods.com/api/v1/deployments/deploymentId/chat/conversations/conversationId" payload := strings.NewReader("{}") req, _ := http.NewRequest("GET", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby require 'uri' require 'net/http' url = URI("https://astropods.com/api/v1/deployments/deploymentId/chat/conversations/conversationId") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Get.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{}" response = http.request(request) puts response.read_body ``` ```java import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.get("https://astropods.com/api/v1/deployments/deploymentId/chat/conversations/conversationId") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{}") .asString(); ``` ```php request('GET', 'https://astropods.com/api/v1/deployments/deploymentId/chat/conversations/conversationId', [ 'body' => '{}', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp using RestSharp; var client = new RestClient("https://astropods.com/api/v1/deployments/deploymentId/chat/conversations/conversationId"); var request = new RestRequest(Method.GET); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://astropods.com/api/v1/deployments/deploymentId/chat/conversations/conversationId")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "GET" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```