Get Thread Status | Athena | API Reference Docs

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

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

thread_idstringRequired

The unique thread ID to check status for

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 null

Error message if thread execution failed

Errors

401

Unauthorized Error

404

Not Found Error

422

Unprocessable Entity Error

500

Internal Server Error