Polaris

Get A Thread And Its Message History

GEThttps://api.getcovent.com/api/v1/polaris/threads/thread_123

Retrieve a thread and its message history.

How to Call

Use one of the examples below to call this endpoint from your own integration.

curl -X GET "https://api.getcovent.com/api/v1/polaris/threads/thread_123" \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Accept: application/json"

Request

Review headers, parameters, and body fields before calling this endpoint.

AuthorizationstringRequired

Bearer token for the proposed external API contract.

Example: Bearer <API_KEY>
AcceptstringRequired

Response format header.

Example: application/json

idstringRequired

id path parameter.

Example: thread_123

Response

200application/json

idstringRequired

id response field.

Example: thread_123
titlestringRequired

title response field.

Example: Phoenix buyer follow-up
metadataobjectRequired

metadata response field.

Example: {"workspace":"phoenix-team","source":"api"}
messagesarrayRequired

messages response field.

Example: [{"id":"msg_123","role":"user","content":"Summarize this buyer's activity in Phoenix.","created_at":"2026-04-17T20:01:00Z"}]
approvalsarrayRequired

approvals response field.

Example: []
attachmentsarrayRequired

attachments response field.

Example: []

Response Example

{
  "id": "thread_123",
  "title": "Phoenix buyer follow-up",
  "metadata": {
    "workspace": "phoenix-team",
    "source": "api"
  },
  "messages": [
    {
      "id": "msg_123",
      "role": "user",
      "content": "Summarize this buyer's activity in Phoenix.",
      "created_at": "2026-04-17T20:01:00Z"
    }
  ],
  "approvals": [],
  "attachments": []
}