Submit
All skills
Skillintermediate

Managed Agents — Endpoint Reference

# Managed Agents — Endpoint Reference

Claude Code Knowledge Pack7/10/2026

Overview

Managed Agents — Endpoint Reference

All endpoints require x-api-key and anthropic-version: 2023-06-01 headers. Managed Agents endpoints additionally require the anthropic-beta header.

Beta Headers

anthropic-beta: managed-agents-2026-04-01

The SDK adds this header automatically for all client.beta.{agents,environments,sessions,vaults,memory_stores}.* calls. Skills endpoints use skills-2025-10-02; Files endpoints use files-api-2025-04-14.

SDK Method Reference

All resources are under the beta namespace. Python and TypeScript share identical method names.

ResourcePython / TypeScript (client.beta.*)Go (client.Beta.*)
Agentsagents.create / retrieve / update / list / archiveAgents.New / Get / Update / List / Archive
Agent Versionsagents.versions.listAgents.Versions.List
Environmentsenvironments.create / retrieve / update / list / delete / archiveEnvironments.New / Get / Update / List / Delete / Archive
Sessionssessions.create / retrieve / update / list / delete / archiveSessions.New / Get / Update / List / Delete / Archive
Session Eventssessions.events.list / send / streamSessions.Events.List / Send / StreamEvents
Session Resourcessessions.resources.add / retrieve / update / list / deleteSessions.Resources.Add / Get / Update / List / Delete
Vaultsvaults.create / retrieve / update / list / delete / archiveVaults.New / Get / Update / List / Delete / Archive
Credentialsvaults.credentials.create / retrieve / update / list / delete / archiveVaults.Credentials.New / Get / Update / List / Delete / Archive
Memory Storesmemory_stores.create / retrieve / update / list / delete / archiveMemoryStores.New / Get / Update / List / Delete / Archive
Memoriesmemory_stores.memories.create / retrieve / update / list / deleteMemoryStores.Memories.New / Get / Update / List / Delete
Memory Versionsmemory_stores.memory_versions.list / retrieve / redactMemoryStores.MemoryVersions.List / Get / Redact

Naming quirks to watch for:

  • Agents have no delete — only archive. Archive is permanent: the agent becomes read-only, new sessions cannot reference it, and there is no unarchive. Confirm with the user before archiving a production agent. Environments, Sessions, Vaults, Credentials, and Memory Stores have both delete and archive; Session Resources, Files, Skills, and Memories are delete-only; Memory Versions have neither — only redact.
  • Session resources use add (not create).
  • Go's event stream is StreamEvents (not Stream).

Agent shorthand: agent on session create accepts either a bare string (agent="agent_abc123" — uses latest version) or the full reference object ({type: "agent", id: "agent_abc123", version: 123}).

Model shorthand: model on agent create accepts either a bare string (model="{{OPUS_ID}}" — uses standard speed) or the full config object ({type: "model_config", id: "claude-opus-4-6", speed: "fast"}). Note: speed: "fast" is only supported on Opus 4.6.

Agents

Step one of every flow. Sessions require a pre-created agent — there is no inline agent config under managed-agents-2026-04-01.

MethodPathOperationDescription
GET/v1/agentsListAgentsList agents
POST/v1/agentsCreateAgentCreate a saved agent configuration
GET/v1/agents/{agent_id}GetAgentGet agent details
POST/v1/agents/{agent_id}UpdateAgentUpdate agent configuration
POST/v1/agents/{agent_id}/archiveArchiveAgentArchive an agent. Makes it read-only; existing sessions continue, new sessions cannot reference it. No unarchive — this is the terminal state.
GET/v1/agents/{agent_id}/versionsListAgentVersionsList agent versions

Sessions

MethodPathOperationDescription
GET/v1/sessionsListSessionsList sessions (paginated)
POST/v1/sessionsCreateSessionCreate a new session
GET/v1/sessions/{session_id}GetSessionGet session details
POST/v1/sessions/{session_id}UpdateSessionUpdate session metadata/title
DELETE/v1/sessions/{session_id}DeleteSessionDelete a session
POST/v1/sessions/{session_id}/archiveArchiveSessionArchive a session

Events

MethodPathOperationDescription
GET/v1/sessions/{session_id}/eventsListEventsList events (polling, paginated)
POST/v1/sessions/{session_id}/eventsSendEventsSend events (user message, tool result)
GET/v1/sessions/{session_id}/events/streamStreamEventsStream events via SSE

Session Resources

MethodPathOperationDescription
GET/v1/sessions/{session_id}/resourcesListResourcesList resources attached to session
POST/v1/sessions/{session_id}/resourcesAddResourceAttach file or github_repository resource (SDK method: add, not create). memory_store resources attach at session-create time only.
GET/v1/sessions/{session_id}/resources/{resource_id}GetResourceGet a single resource
POST/v1/sessions/{session_id}/resources/{resource_id}UpdateResourceUpdate resource
DELETE/v1/sessions/{session_id}/resources/{resource_id}DeleteResourceRemove resource from session

Environments

MethodPathOperationDescription
POST/v1/environmentsCreateEnvironmentCreate environment
GET/v1/environmentsListEnvironmentsList environments
GET/v1/environments/{environment_id}GetEnvironmentGet environment details
POST/v1/environments/{environment_id}UpdateEnvironmentUpdate environment
DELETE/v1/environments/{environment_id}DeleteEnvironmentDelete environment. Returns 204.
POST/v1/environments/{environment_id}/archiveArchiveEnvironmentArchive environment. Makes it read-only; existing sessions continue, new sessions cannot reference it. No unarchive — this is the terminal state.

Vaults

Vaults store MCP credentials that Anthropic manages on your behalf — OAuth credentials with auto-refresh, or static bearer tokens. Attach to sessions via vault_ids. See managed-agents-tools.md §Vaults for the conceptual guide and credential shapes.

MethodPathOperationDescription
POST/v1/vaultsCreateVaultCreate a vault
GET/v1/vaultsListVaultsList vaults
GET/v1/vaults/{vault_id}GetVaultGet vault details
POST/v1/vaults/{vault_id}UpdateVaultUpdate vault
DELETE/v1/vaults/{vault_id}DeleteVaultDelete vault
POST/v1/vaults/{vault_id}/archiveArchiveVaultArchive vault

Credentials

Credentials are individual secrets stored inside a vault.

MethodPathOperationDescription
POST/v1/vaults/{vault_id}/credentialsCreateCredentialCreate a credential
GET/v1/vaults/{vault_id}/credentialsListCredentialsList credentials in vault
GET/v1/vaults/{vault_id}/credentials/{credential_id}GetCredentialGet credential metadata
POST/v1/vaults/{vault_id}/credentials/{credential_id}UpdateCredentialUpdate credential
DELETE/v1/vaults/{vault_id}/credentials/{credential_id}DeleteCredentialDelete credential
POST/v1/vaults/{vault_id}/credentials/{credential_id}/archiveArchiveCredentialArchive credential

Memory Stores

Workspace-scoped persistent memory that survives across sessions. Attach to a session via a {"type": "memory_store", "memory_store_id": ...} entry in resources[] (session-create time only). See shared/managed-agents-memory.md for the conceptual guide, the FUSE-mount agent interface, preconditions, and versioning.

MethodPathOperationDescription
POST/v1/memory_storesCreateMemoryStoreCreate a store (name, description, metadata)
GET/v1/memory_storesListMemoryStoresList stores (include_archived, created_at_{gte,lte})
GET/v1/memory_stores/{memory_store_id}GetMemoryStoreGet store details
POST/v1/memory_stores/{memory_store_id}UpdateMemoryStoreUpdate store
DELETE/v1/memory_stores/{memory_store_id}DeleteMemoryStoreDelete store
POST/v1/memory_stores/{memory_store_id}/archiveArchiveMemoryStoreArchive store. Makes it read-only; existing sessions continue, new sessions cannot reference it. No unarchive.

Memories

Individual text documents inside a store (≤ 100KB each). create creates at a path and returns 409 (memory_path_conflict_error, with conflicting_memory_id) if the path is occupied; update mutates by mem_... ID (rename and/or content). Only update accepts a precondition ({"type": "content_sha256", "content_sha256": ...}) — on mismatch returns 409 (memory_precondition_failed_error). List endpoints accept view: "basic"|"full" (controls whether content is populated; retrieve defaults to full).

MethodPathOperationDescription
GET/v1/memory_stores/{memory_store_id}/memoriesListMemoriesReturns `Memory \
POST/v1/memory_stores/{memory_store_id}/memoriesCreateMemoryCreate at path (SDK: memories.create); 409 memory_path_conflict_error if occupied
GET/v1/memory_stores/{memory_store_id}/memories/{memory_id}GetMemoryRead one memory (defaults to view="full")
PATCH/v1/memory_stores/{memory_store_id}/memories/{memory_id}UpdateMemoryChange content, path, or both by ID; optional precondition
DELETE/v1/memory_stores/{memory_store_id}/memories/{memory_id}DeleteMemoryDelete (optional expected_content_sha256)

Memory Versions

Immutable per-mutation snapshots (memver_...) — the audit and rollback surface. operation ∈ created / modified / deleted.

MethodPathOperationDescription
GET/v1/memory_stores/{memory_store_id}/memory_versionsListMemoryVersionsNewest-first; filter by memory_id, operation, session_id, api_key_id, created_at_{gte,lte}
GET/v1/memory_stores/{memory_store_id}/memory_versions/{version_id}GetMemoryVersionList fields + full content
POST/v1/memory_stores/{memory_store_id}/memory_versions/{version_id}/redactRedactMemoryVersionClear content/content_sha256/content_size_bytes/path; preserve actor + timestamps

Files

MethodPathOperationDescription
POST/v1/filesUploadFileUpload a file
GET/v1/filesListFilesList files