Sessions
An agent session: one conversation with an agent, from trigger to terminal state.
An agent session is one conversation with an agent, from trigger to terminal state. It is GET /v1/sessions/{id} and the session stream's session and snapshot frames — REST and stream never disagree about what a session looks like.
For how a session executes and what each status means, see the lifecycle.
Example
{
"agent": {
"config": {
"budget": {
"day": 0,
"month": 0,
"session": 0,
"week": 0
},
"claude": {
"effort": "low",
"fallback_model": "string",
"max_turns": 0,
"model": "claude-opus-5",
"settings": {
"path": "string",
"repository": {
"name": "string",
"owner": "string",
"ref": "string"
}
},
"system": "string"
},
"codex": {
"model": "gpt-5.6-terra",
"system": "string"
},
"ellipsis": {
"description": "string",
"enabled": true,
"interactive": true,
"metadata": {
"annotations": {},
"labels": []
},
"name": "string",
"version": "v1"
},
"environment": {
"compute": {
"cpu": 0,
"memory": "string",
"timeout": "string"
},
"hooks": {
"post_clone": "string",
"post_start": "string"
},
"image": {
"dockerfile_append": "string",
"setup": "string"
},
"repositories": [],
"variables": []
},
"input": {
"json_schema": {},
"message": "string"
},
"mcp_servers": [],
"output": {
"json_schema": {}
},
"permissions": {
"ellipsis": true,
"github": {
"permissions": "string",
"repositories": [
"string"
]
}
},
"skills": [],
"trigger": "string"
},
"config_id": "string",
"override": {},
"source": "explicit"
},
"attribution": {
"id": "string",
"type": "github_user",
"user": {
"avatar_url": "string",
"id": 0,
"login": "string",
"type": "User"
}
},
"budget": {
"cents": 0,
"source": "system"
},
"context_repository": "string",
"cost": {
"fee": 0,
"llm": 0,
"sandbox_cpu": 0,
"sandbox_memory": 0,
"total": 0
},
"created_at": "2026-01-01T00:00:00Z",
"exit_status": "completed",
"git": {
"repos": []
},
"harness": "claude_code",
"id": "string",
"last_activity_at": "2026-01-01T00:00:00Z",
"last_message_at": "2026-01-01T00:00:00Z",
"metadata": {},
"parent": {
"kind": "continuation",
"replayed_from_session_id": "string",
"session_id": "string"
},
"prompt": "string",
"prompting": {
"blocked_reason": "mention_surface",
"detail": "string",
"enabled": false,
"surface_name": "string"
},
"session_state": "idle",
"source": "react",
"status": "scheduled",
"status_reason": "string",
"stopped": {
"at": "2026-01-01T00:00:00Z",
"by": 0,
"by_user": {
"avatar_url": "string",
"id": 0,
"login": "string",
"type": "User"
}
},
"summary": {
"created_at": "2026-01-01T00:00:00Z",
"description": "string"
},
"surface": {
"run": "scheduled",
"session": "alive",
"status": "string"
},
"tokens": {
"cache_creation": 0,
"cache_read": 0,
"input": 0,
"model": "",
"output": 0,
"total": 0
},
"updated_at": "2026-01-01T00:00:00Z"
}