--- title: "List Sessions" method: GET path: "/v1/sessions?beta=true" --- # List Sessions `GET /v1/sessions?beta=true` ## Query parameters - `limit` integer - `page` string - `include_archived` boolean - `created_at[gte]` string, date-time — A timestamp in RFC 3339 format - `created_at[gt]` string, date-time — A timestamp in RFC 3339 format - `created_at[lte]` string, date-time — A timestamp in RFC 3339 format - `created_at[lt]` string, date-time — A timestamp in RFC 3339 format - `agent_id` string - `agent_version` integer - `order` 'asc' | 'desc' — ListOrder enum - `memory_store_id` string - `deployment_id` string - `statuses[]` BetaManagedAgentsSessionStatus[] ## Headers - `x-api-key` string - `anthropic-version` string - `anthropic-beta` string ## Response `200` Successful response (OK) - BetaManagedAgentsListSessions — Paginated list of sessions. - `data` BetaManagedAgentsSession[] — List of sessions. - `type` 'session', required - `id` string, required - `status` 'rescheduling' | 'running' | 'idle' | 'terminated', required — SessionStatus enum - `created_at` string, date-time, required — A timestamp in RFC 3339 format - `updated_at` string, date-time, required — A timestamp in RFC 3339 format - `environment_id` string, required - `title` string, nullable, required - `metadata` object, required - `agent` BetaManagedAgentsSessionAgent, required — Resolved `agent` definition for a `session`. Snapshot of the `agent` at `session` creation time. - `type` 'agent', required - `id` string, required - `version` integer, required - `name` string, required - `description` string, nullable, required - `model` BetaManagedAgentsModelConfig, required — Model identifier and configuration. - `id` union, required — The model that will power your agent. See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options. - string - 'claude-sonnet-5' — High-performance model for coding and agents - 'claude-fable-5' — Next generation of intelligence for the hardest knowledge work and coding problems - 'claude-opus-5' — Powerful intelligence for long-running agents and coding - 'claude-opus-4-8' — Powerful intelligence for long-running agents and coding - 'claude-opus-4-7' — Powerful intelligence for long-running agents and coding - 'claude-opus-4-6' — Powerful intelligence for long-running agents and coding - 'claude-sonnet-4-6' — Best combination of speed and intelligence - 'claude-haiku-4-5' — Fastest model with near-frontier intelligence - 'claude-haiku-4-5-20251001' — Fastest model with near-frontier intelligence - 'claude-opus-4-5' — Powerful intelligence for long-running agents and coding - 'claude-opus-4-5-20251101' — Powerful intelligence for long-running agents and coding - 'claude-sonnet-4-5' — High-performance model for agents and coding - 'claude-sonnet-4-5-20250929' — High-performance model for agents and coding - `speed` 'standard' | 'fast' — Inference speed mode. `fast` provides significantly faster output token generation at premium pricing. Not all models support `fast`; invalid combinations are rejected at create time. - `effort` union — How hard Claude works on each turn. Sets `output_config.effort` on every Messages call the session makes. - object — Low effort. Favors latency over reasoning depth. - `type` 'low', required - object — Medium effort. Balances latency and reasoning depth. - `type` 'medium', required - object — High effort. Favors reasoning depth. - `type` 'high', required - object — Extra-high effort. Not all models accept this level. - `type` 'xhigh', required - object — Maximum effort. Favors reasoning depth over latency. - `type` 'max', required - `inference_geo` string — Geographic region for model inference. When unset, requests fall through to the workspace's default_inference_geo. - `system` string, nullable, required - `tools` BetaManagedAgentsAgentTool[], required - union — Union type for tool configurations returned in API responses. - object - `type` 'agent_toolset_20260401', required - `default_config` BetaManagedAgentsAgentToolsetDefaultConfig, required — Resolved default configuration for agent tools. - … - `configs` BetaManagedAgentsAgentToolConfig[], required - … - object - `type` 'mcp_toolset', required - `mcp_server_name` string, required - `default_config` BetaManagedAgentsMCPToolsetDefaultConfig, required — Resolved default configuration for all tools from an MCP server. - … - `configs` BetaManagedAgentsMCPToolConfig[], required - … - object — A custom tool as returned in API responses. - `type` 'custom', required - `name` string, required - `description` string, required - `input_schema` BetaManagedAgentsCustomToolInputSchema, required — JSON Schema for custom tool input parameters. - … - `mcp_servers` BetaManagedAgentsMCPServer[], required - `type` 'url', required - `name` string, required - `url` string, required - `skills` BetaManagedAgentsSkill[], required - union — Resolved skill as returned in API responses. - BetaManagedAgentsAnthropicSkill — A resolved Anthropic-managed skill. - `type` 'anthropic', required - `skill_id` string, required - `version` string, required - BetaManagedAgentsCustomSkill — A resolved user-created custom skill. - `type` 'custom', required - `skill_id` string, required - `version` string, required - `multiagent` BetaManagedAgentsSessionMultiagent, required — Resolved coordinator topology with full agent definitions for each roster member. - `type` 'coordinator', required - `agents` BetaManagedAgentsSessionRosterEntry[], required — Full `agent` definitions the coordinator may spawn as session threads. - union — A session-resolved multiagent roster entry. - BetaManagedAgentsSessionThreadAgent — Resolved `agent` definition for a single `session_thread`. Snapshot of the agent at thread creation time. The multiagent roster is not repeated here; read it from `Session.agent`. - … - BetaManagedAgentsAdvisor — Platform advisor roster entry: a model the session's primary thread may consult mid-turn. - … - `resources` BetaManagedAgentsSessionResource[], required - union - object - `type` 'github_repository', required - `id` string, required - `url` string, required - `mount_path` string, required - `checkout` union - object - … - object - … - `created_at` string, date-time, required — A timestamp in RFC 3339 format - `updated_at` string, date-time, required — A timestamp in RFC 3339 format - object - `type` 'file', required - `id` string, required - `file_id` string, required - `mount_path` string, required - `created_at` string, date-time, required — A timestamp in RFC 3339 format - `updated_at` string, date-time, required — A timestamp in RFC 3339 format - object — A memory store attached to an agent session. - `type` 'memory_store', required - `memory_store_id` string, required — The memory store ID (memstore_...). Must belong to the caller's organization and workspace. - `access` 'read_write' | 'read_only' — Access mode for an attached memory store. - `name` string, nullable — Display name of the memory store, snapshotted at attach time. Later edits to the store's name do not propagate to this resource. - `description` string — Description of the memory store, snapshotted at attach time. Rendered into the agent's system prompt. Empty string when the store has no description. - `instructions` string, nullable — Per-attachment guidance for the agent on how to use this store. Rendered into the memory section of the system prompt. Max 4096 chars. - `mount_path` string, nullable — Filesystem path where the store is mounted in the session container, e.g. /mnt/memory/user-preferences. Derived from the store's name. Output-only. - `vault_ids` string[], required — Vault IDs attached to the session at creation. Empty when no vaults were supplied. - `outcome_evaluations` BetaManagedAgentsOutcomeEvaluationResource[], required — Per-outcome evaluation state. One entry per define_outcome event sent to the session. - `type` 'outcome_evaluation', required - `outcome_id` string, required — Server-generated outc_ ID for this outcome. - `description` string, required — What the agent should produce. - `result` string, required — Current evaluation state. `pending` before the agent begins work; `running` while producing or revising; `evaluating` while the grader scores; `satisfied`/`max_iterations_reached`/`failed`/`interrupted` are terminal. - `iteration` integer, required — 0-indexed revision cycle the outcome is currently on. - `completed_at` string, date-time, required — A timestamp in RFC 3339 format - `explanation` string, nullable, required — Grader's verdict text from the most recent evaluation. For satisfied, explains why criteria are met; for needs_revision (intermediate), what's missing; for failed, why unrecoverable. - `usage` BetaManagedAgentsSessionUsage, required — Cumulative token usage for a session across all turns. - `input_tokens` integer — Total input tokens consumed across all turns. - `output_tokens` integer — Total output tokens generated across all turns. - `cache_read_input_tokens` integer — Total tokens read from prompt cache. - `cache_creation` BetaManagedAgentsCacheCreationUsage — Prompt-cache creation token usage broken down by cache lifetime. - `ephemeral_1h_input_tokens` integer — Tokens used to create 1-hour ephemeral cache entries. - `ephemeral_5m_input_tokens` integer — Tokens used to create 5-minute ephemeral cache entries. - `list_cost` BetaMonetaryAmount — A monetary amount in a specific currency. - `currency` 'USD', required - `amount` string, required — Amount in minor units of the currency, as an integer decimal string with no leading zeros: "2500" is $25.00 and "50" is fifty cents. A string rather than a number so no float rounding is ever applied. - `server_tool_use` BetaManagedAgentsServerToolUsage — Cumulative count of server-executed tool invocations, broken down by tool. - `web_search_requests` integer — Number of server-executed web search requests. - `web_fetch_requests` integer — Number of server-executed web fetch requests. - `active_seconds` number, double — Cumulative time in seconds during which the session had at least one thread in running status. Overlapping activity from concurrent threads is counted once, unlike `stats.active_seconds`, which sums each thread's own active time. This is the duration the session's runtime cost is priced on. - `stats` BetaManagedAgentsSessionStats, required — Timing statistics for a session. - `duration_seconds` number, double — Elapsed time since session creation in seconds. For terminated sessions, frozen at the final update. - `active_seconds` number, double — Cumulative time in seconds the session spent in running status. Excludes idle time. - `archived_at` string, date-time, required — A timestamp in RFC 3339 format - `deployment_id` string, nullable — Deployment ID when the session was created from a deployment reference. Null otherwise. - `budget` BetaManagedAgentsBudget, required — A hard spend ceiling. The session stops issuing new model requests once the tracked list cost reaches `max_list_cost`. - `type` 'limit', required - `max_list_cost` BetaMonetaryAmount, required — A monetary amount in a specific currency. - `currency` 'USD', required - `amount` string, required — Amount in minor units of the currency, as an integer decimal string with no leading zeros: "2500" is $25.00 and "50" is fifty cents. A string rather than a number so no float rounding is ever applied. - `next_page` string, nullable — Opaque cursor for the next page. Null when no more results. - `prev_page` string, nullable — Opaque cursor for the previous page. Null when on the first page. Pass as the `page` parameter to navigate backward. ## Other responses - `400` — Invalid argument - The client specified an invalid argument - `401` — Unauthenticated - The request does not have valid authentication credentials - `403` — Permission denied - The caller does not have permission to execute the specified operation - `404` — Not found - Some requested entity was not found - `408` — Deadline exceeded - The deadline expired before the operation could complete - `409` — Aborted - The operation was aborted due to concurrency issue - `412` — Failed precondition - Operation was rejected because the system is not in required state - `413` — Out of range - Operation was attempted past the valid range - `429` — Resource exhausted - Some resource has been exhausted (rate limiting) - `431` — Request header fields too large - Request metadata was too large - `499` — Cancelled - The operation was cancelled by the client - `500` — Internal - Internal server error - `501` — Unimplemented - The operation is not implemented or supported - `503` — Unavailable - The service is currently unavailable - `504` — Deadline exceeded - Upstream service did not respond in time --- [API](https://skmtc.net/anthropics/apis/anthropic-api.md) · [All operations](https://skmtc.net/anthropics/apis/anthropic-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/anthropics/anthropic-api/revisions/93d8fd7d6493/schema)