Skip to content
Last updated
🔨 In Development — This section is still being developed and may change.

This endpoint allows you to check the current streaming status of a specific thread. It's useful for determining if a response is still being generated or if the thread is inactive.

GET /v1/threads/{thread_id}/status

Path Parameters

NameTypeDescription
thread_idstringRequired. The ID of the thread.

Response

The response is a JSON object containing the status of the thread.

NameTypeDescription
threadIdstringThe ID of the thread.
statusstringThe current status, either streaming or inactive.
detailsobjectAn object containing more details if the status is streaming. This will be null otherwise.

Example Success Response

{
  "threadId": "thread_abc123",
  "status": "streaming",
  "details": {
    "threadId": "thread_abc123",
    "organizationId": "org_xyz789",
    "assistantId": "asst_def456",
    "startedAt": "2025-10-26T10:30:00Z",
    "lastMessageId": "msg_ghi789",
    "modelUsed": "claude-3-opus-20240229",
    "status": "streaming"
  }
}

Example Inactive Response

{
  "threadId": "thread_abc123",
  "status": "inactive",
  "details": null
}

Errors

This endpoint will return a 404 Not Found error if the thread does not exist or if the user does not have permission to access it.