Skip to main content
GET
/
v1
/
sessions
/
{session_id}
curl https://api.dari.dev/v1/sessions/sess_123 \
  -H "Authorization: Bearer $DARI_API_KEY"
{
  "id": "sess_123",
  "agent_id": "agt_123",
  "version_id": "ver_9",
  "status": "idle",
  "last_message_id": "msg_123",
  "last_message_status": "completed",
  "created_at": "2026-03-31T18:40:00Z",
  "metadata": {
    "managed_run_id": "run_123",
    "kind": "tester"
  }
}

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.

Returns the current session record, including metadata, the agent version, and most recent message references.

Path Parameters

session_id
string
required
Session ID.

Headers

Authorization
string
required
Bearer token using your Dari API key.

Response Fields

id
string
Session ID.
agent_id
string
Agent ID.
version_id
string
Agent version used by this session.
status
string
Current session lifecycle state, such as idle or running.
last_message_id
string
Most recent message ID, if any.
last_message_status
string
Most recent message status, if any.
created_at
string
ISO 8601 creation timestamp.
metadata
object
Session metadata as string key/value pairs.
curl https://api.dari.dev/v1/sessions/sess_123 \
  -H "Authorization: Bearer $DARI_API_KEY"
{
  "id": "sess_123",
  "agent_id": "agt_123",
  "version_id": "ver_9",
  "status": "idle",
  "last_message_id": "msg_123",
  "last_message_status": "completed",
  "created_at": "2026-03-31T18:40:00Z",
  "metadata": {
    "managed_run_id": "run_123",
    "kind": "tester"
  }
}