Skip to main content
GET
/
v1
/
sessions
/
{session_id}
/
messages
/
{message_id}
curl https://api.dari.dev/v1/sessions/sess_123/messages/msg_123 \
  -H "Authorization: Bearer $DARI_API_KEY"
{
  "id": "msg_123",
  "session_id": "sess_123",
  "status": "completed",
  "attempt": 1,
  "output": {
    "parts": [
      {
        "type": "text",
        "text": "Here is a draft response for the customer..."
      }
    ]
  },
  "created_at": "2026-03-31T18:40:00Z",
  "completed_at": "2026-03-31T18:40:12Z"
}
Returns the current message record, including status, attempts, and terminal output when available. This is the canonical polling resource for async message execution.

Path Parameters

session_id
string
required
Session ID.
message_id
string
required
Message ID.

Headers

Authorization
string
required
Bearer token using your Dari API key.

Response Fields

id
string
Message ID.
session_id
string
Session ID.
status
string
Current message status: queued, running, completed, or failed.
attempt
integer
Current attempt count.
output
object
Structured output when available. Null while the message is still running.
created_at
string
ISO 8601 creation timestamp.
completed_at
string
ISO 8601 completion timestamp. Null until the message reaches a terminal state.
curl https://api.dari.dev/v1/sessions/sess_123/messages/msg_123 \
  -H "Authorization: Bearer $DARI_API_KEY"
{
  "id": "msg_123",
  "session_id": "sess_123",
  "status": "completed",
  "attempt": 1,
  "output": {
    "parts": [
      {
        "type": "text",
        "text": "Here is a draft response for the customer..."
      }
    ]
  },
  "created_at": "2026-03-31T18:40:00Z",
  "completed_at": "2026-03-31T18:40:12Z"
}