Get Thread Status

Beta

GET

https://api.athenaintel.com/api/v0/threads/:thread_id/status

GET

/api/v0/threads/:thread_id/status

curl https://api.athenaintel.com/api/v0/threads/thread_id/status \
     -H "X-API-KEY: <apiKey>"

{
  "conversation_asset": {
    "agent": "string",
    "athena_metadata": {
      "langchain_thread_id": "thread_12345-6789-abcd-efgh",
      "num_messages": 5,
      "state": "completed"
    },
    "conversation_asset_id": "asset_9249292-d118-42d3-95b4-00eccfe0754f",
    "created_at": "string",
    "created_by": "string",
    "last_channel": "string",
    "last_message": {
      "content": "Task completed successfully. Here are the key findings from the market research.",
      "id": "msg_2",
      "role": "assistant",
      "additional_kwargs": {}
    },
    "linked_aops": [
      {
        "asset_id": "asset_aop_123",
        "title": "Market Research AOP"
      }
    ],
    "linked_projects": [
      {}
    ],
    "model": "string",
    "num_messages": 5,
    "start_channel": "string",
    "state": "completed",
    "title": "AI Conversation",
    "updated_at": "string",
    "workspace_id": "string",
    "messages": [
      {
        "content": [
          {
            "text": "Run the task for [@Market Research](mention://asset?id=asset_123)",
            "type": "text"
          }
        ],
        "id": "msg_1",
        "role": "user",
        "additional_kwargs": {}
      },
      {
        "content": "Task completed successfully. Here are the key findings from the market research.",
        "id": "msg_2",
        "role": "assistant",
        "additional_kwargs": {}
      }
    ]
  },
  "created_at": "2024-01-15T10:30:00Z",
  "status": "completed",
  "thread_id": "thread_12345-6789-abcd-efgh",
  "updated_at": "2024-01-15T10:45:00Z"
}

Check the status of a thread execution by thread ID. Returns thread status and associated conversation asset information for tracking progress.

Authentication

X-API-KEYstring

API Key authentication via header

Path parameters

thread_idstringRequired

The unique thread ID to check status for

Query parameters

include_messagesboolean or nullOptional

Whether to materialize checkpoint messages. By default, deployments with lightweight active reads enabled omit messages while a run is scheduled, queued, or running, and include them once it is terminal. Set true to force messages or false to skip them.

Response

Thread status retrieved successfully

conversation_assetobject or null

Information about the associated conversation asset

created_atstring

ISO timestamp when thread was created

statusstring

Current status of the thread (e.g., ‘running’, ‘completed’, ‘failed’)

thread_idstring

The thread ID that was checked

updated_atstring

ISO timestamp when thread was last updated

errorstring or nullOptional

Error message if thread execution failed

Errors

401

Unauthorized Error

404

Not Found Error

422

Unprocessable Entity Error

500

Internal Server Error