Skip to main content
GET
/
v1
/
session-batches
/
{batch_id}
curl https://api.dari.dev/v1/session-batches/batch_123 \
  -H "Authorization: Bearer $DARI_API_KEY"

{
  "batch_id": "batch_123",
  "status": "partial_failed",
  "counts": {
    "queued": 0,
    "running": 0,
    "completed": 17,
    "failed": 1
  },
  "sessions": [
    {
      "index": 0,
      "session_id": "sess_123",
      "status": "completed",
      "last_message_status": "completed",
      "agent_id": "agt_123",
      "version_id": "ver_9",
      "llm_id": "medium-claude",
      "metadata": { "managed_run_id": "run_123", "task_index": "1" },
      "transcript_url": "/v1/sessions/sess_123/transcript",
      "error": null
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.dari.dev/llms.txt

Use this file to discover all available pages before exploring further.

Use this endpoint as the recovery path for batch clients. Webhooks can be delivered more than once or out of order, so a client should store batch_id and call this endpoint whenever it needs the current source of truth.

​
Path Parameters

​
batch_id
string
required
Session batch ID.

​
Headers

​
Authorization
string
required
Bearer token using your Dari API key.

​
Response Fields

​
batch_id
string
Batch ID.
​
status
string
Aggregate status derived from child sessions: queued, running, completed, failed, or partial_failed.
​
counts
object
Counts of child sessions by batch status.
​
sessions
array
Per-item session status in the original input order. Each item includes index, session_id, status, last_message_status, agent_id, version_id, llm_id, metadata, transcript_url, and error.
curl https://api.dari.dev/v1/session-batches/batch_123 \
  -H "Authorization: Bearer $DARI_API_KEY"

{
  "batch_id": "batch_123",
  "status": "partial_failed",
  "counts": {
    "queued": 0,
    "running": 0,
    "completed": 17,
    "failed": 1
  },
  "sessions": [
    {
      "index": 0,
      "session_id": "sess_123",
      "status": "completed",
      "last_message_status": "completed",
      "agent_id": "agt_123",
      "version_id": "ver_9",
      "llm_id": "medium-claude",
      "metadata": { "managed_run_id": "run_123", "task_index": "1" },
      "transcript_url": "/v1/sessions/sess_123/transcript",
      "error": null
    }
  ]
}