Get Status of Many Threads

Beta

POST

https://api.athenaintel.com/api/v0/threads/status-batch

POST

/api/v0/threads/status-batch

curl -X POST https://api.athenaintel.com/api/v0/threads/status-batch \
     -H "X-API-KEY: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "thread_ids": [
    "thread_12345-6789-abcd-efgh",
    "thread_22345-6789-abcd-efgh"
  ]
}'

{
  "counts": {
    "canceled": 0,
    "completed": 1,
    "failed": 0,
    "needs_input": 0,
    "queued": 0,
    "running": 1,
    "scheduled": 0
  },
  "found": 2,
  "is_complete": false,
  "not_found": [
    "thread_unknown"
  ],
  "requested": 3,
  "terminal": 1,
  "threads": [
    {
      "is_terminal": true,
      "output_available": true,
      "status": "completed",
      "thread_id": "thread_12345-6789-abcd-efgh",
      "aop_asset_id": "asset_9249292-d118-42d3-95b4-00eccfe0754f",
      "completed_at": "2026-09-13T20:04:10+00:00",
      "created_at": "2026-09-13T20:00:00Z",
      "updated_at": "2026-09-13T20:04:10Z"
    },
    {
      "is_terminal": false,
      "output_available": false,
      "status": "running",
      "thread_id": "thread_22345-6789-abcd-efgh",
      "aop_asset_id": "asset_9249292-d118-42d3-95b4-00eccfe0754f",
      "batch_id": "batch_1f3c1b9e-7f7d-4c2c-9d5e-2b1f0a9c8d7e",
      "client_ref": "row-2",
      "created_at": "2026-09-13T20:00:02Z",
      "updated_at": "2026-09-13T20:00:05Z"
    }
  ]
}

Read the lifecycle status of up to 200 threads in one call, whether they were started by POST /aop/execute-async or POST /aop/execute-batch. Returns aggregate counts plus one compact entry per thread (status, terminal flag, output availability, timestamps) without loading any messages; fetch results with GET /threads/{thread_id}/status once output_available is true. Only threads you launched are returned: unknown IDs and other users’ threads are listed in not_found and are indistinguishable.

Authentication

X-API-KEYstring

API Key authentication via header

Request

This endpoint expects an object.

thread_idslist of stringsRequired

Thread IDs to check (1-200 per request), from POST /aop/execute-async or POST /aop/execute-batch. Duplicates are collapsed.

Response

Status of every requested thread you own

countsobject

Found threads per canonical status

foundinteger

Requested threads that exist and belong to you

is_completeboolean

True when every found thread has finished

not_foundlist of strings

Requested thread IDs that do not exist or are not yours; the two cases are indistinguishable

requestedinteger

Distinct thread IDs in the request

terminalinteger

Found threads that have finished (completed + failed + canceled)

threadslist of objects

One entry per found thread, in request order

Errors

401

Unauthorized Error

422

Unprocessable Entity Error

500

Internal Server Error

Authentication

Headers

Request

Response

Errors