SPB Git

Repository Public

resources.md 32.2 KB 1,557 lines markdown

1---2title: Resources3url: https://platform.claude.com/docs/en/api/beta/sessions/resources4---56# Resources78## Add Session Resource910**POST** `/v1/sessions/{session_id}/resources`1112Add Session Resource1314### Path parameters1516- `session_id: string`1718### Headers1920- `"anthropic-beta": optional array of AnthropicBeta`2122  Optional header to specify the beta version(s) you want to use.2324  - `string`2526  - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 43 more`2728    - `"message-batches-2024-09-24"`2930    - `"prompt-caching-2024-07-31"`3132    - `"computer-use-2024-10-22"`3334    - `"computer-use-2025-01-24"`3536    - `"pdfs-2024-09-25"`3738    - `"token-counting-2024-11-01"`3940    - `"token-efficient-tools-2025-02-19"`4142    - `"output-128k-2025-02-19"`4344    - `"files-api-2025-04-14"`4546    - `"mcp-client-2025-04-04"`4748    - `"mcp-client-2025-11-20"`4950    - `"dev-full-thinking-2025-05-14"`5152    - `"interleaved-thinking-2025-05-14"`5354    - `"code-execution-2025-05-22"`5556    - `"extended-cache-ttl-2025-04-11"`5758    - `"context-1m-2025-08-07"`5960    - `"context-management-2025-06-27"`6162    - `"model-context-window-exceeded-2025-08-26"`6364    - `"skills-2025-10-02"`6566    - `"fast-mode-2026-02-01"`6768    - `"output-300k-2026-03-24"`6970    - `"user-profiles-2026-03-24"`7172    - `"user-profiles-2026-08-18"`7374    - `"user-profiles-2026-09-04"`7576    - `"advisor-tool-2026-03-01"`7778    - `"managed-agents-2026-04-01"`7980    - `"cache-diagnosis-2026-04-07"`8182    - `"dreaming-2026-04-21"`8384    - `"thinking-token-count-2026-05-13"`8586    - `"server-side-fallback-2026-06-01"`8788    - `"server-side-fallback-2026-07-01"`8990    - `"fallback-credit-2026-06-01"`9192    - `"fallback-credit-2026-07-01"`9394    - `"agent-memory-2026-07-22"`9596    - `"mid-conversation-tool-changes-2026-07-01"`9798    - `"compact-2026-01-12"`99100    - `"computer-use-2025-11-24"`101102    - `"mcp-tunnels-2026-06-22"`103104    - `"structured-outputs-2025-11-13"`105106    - `"task-budgets-2026-03-13"`107108    - `"thinking-display-updates-2026-08-18"`109110    - `"ce-user-management-2026-07-13"`111112    - `"mid-conversation-output-config-2026-07-01"`113114    - `"thinking-binding-controls-2026-08-01"`115116    - `"mid-conversation-system-clear-at-2026-08-21"`117118    - `"compact-2026-09-04"`119120- `"anthropic-workspace-id": optional string`121122### Body parameters123124- `file_id: string`125126  ID of a previously uploaded file.127128  minLength: 1, maxLength: 128129130- `type: "file"`131132- `mount_path: optional string or null`133134  Mount path in the container. Defaults to `/mnt/session/uploads/<file_id>`.135136  minLength: 1, maxLength: 4096137138### Returns139140- `BetaManagedAgentsFileResource object`141142  - `type: "file"`143144  - `id: string`145146  - `created_at: string`147148    A timestamp in RFC 3339 format149150    format: date-time151152  - `file_id: string`153154  - `mount_path: string`155156  - `updated_at: string`157158    A timestamp in RFC 3339 format159160    format: date-time161162### Example163164```bash165curl https://api.anthropic.com/v1/sessions/$SESSION_ID/resources \166    -H 'Content-Type: application/json' \167    -H 'anthropic-version: 2023-06-01' \168    -H 'anthropic-beta: managed-agents-2026-04-01' \169    -H "X-Api-Key: $ANTHROPIC_API_KEY" \170    -d '{171          "file_id": "file_011CNha8iCJcU1wXNR6q4V8w",172          "type": "file",173          "mount_path": "/uploads/receipt.pdf"174        }'175```176177#### Response (200)178179```json180{181  "id": "sesrsc_011CZkZBJq5dWxk9fVLNcPht",182  "created_at": "2026-03-15T10:00:00Z",183  "file_id": "file_011CNha8iCJcU1wXNR6q4V8w",184  "mount_path": "/uploads/receipt.pdf",185  "type": "file",186  "updated_at": "2026-03-15T10:00:00Z"187}188```189190## List Session Resources191192**GET** `/v1/sessions/{session_id}/resources`193194List Session Resources195196### Path parameters197198- `session_id: string`199200### Query parameters201202- `limit: optional number`203204  Maximum number of resources to return per page (max 1000). If omitted, returns all resources.205206  format: int32207208- `page: optional string`209210  Opaque cursor from a previous response's `next_page` field.211212### Headers213214- `"anthropic-beta": optional array of AnthropicBeta`215216  Optional header to specify the beta version(s) you want to use.217218  - `string`219220  - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 43 more`221222    - `"message-batches-2024-09-24"`223224    - `"prompt-caching-2024-07-31"`225226    - `"computer-use-2024-10-22"`227228    - `"computer-use-2025-01-24"`229230    - `"pdfs-2024-09-25"`231232    - `"token-counting-2024-11-01"`233234    - `"token-efficient-tools-2025-02-19"`235236    - `"output-128k-2025-02-19"`237238    - `"files-api-2025-04-14"`239240    - `"mcp-client-2025-04-04"`241242    - `"mcp-client-2025-11-20"`243244    - `"dev-full-thinking-2025-05-14"`245246    - `"interleaved-thinking-2025-05-14"`247248    - `"code-execution-2025-05-22"`249250    - `"extended-cache-ttl-2025-04-11"`251252    - `"context-1m-2025-08-07"`253254    - `"context-management-2025-06-27"`255256    - `"model-context-window-exceeded-2025-08-26"`257258    - `"skills-2025-10-02"`259260    - `"fast-mode-2026-02-01"`261262    - `"output-300k-2026-03-24"`263264    - `"user-profiles-2026-03-24"`265266    - `"user-profiles-2026-08-18"`267268    - `"user-profiles-2026-09-04"`269270    - `"advisor-tool-2026-03-01"`271272    - `"managed-agents-2026-04-01"`273274    - `"cache-diagnosis-2026-04-07"`275276    - `"dreaming-2026-04-21"`277278    - `"thinking-token-count-2026-05-13"`279280    - `"server-side-fallback-2026-06-01"`281282    - `"server-side-fallback-2026-07-01"`283284    - `"fallback-credit-2026-06-01"`285286    - `"fallback-credit-2026-07-01"`287288    - `"agent-memory-2026-07-22"`289290    - `"mid-conversation-tool-changes-2026-07-01"`291292    - `"compact-2026-01-12"`293294    - `"computer-use-2025-11-24"`295296    - `"mcp-tunnels-2026-06-22"`297298    - `"structured-outputs-2025-11-13"`299300    - `"task-budgets-2026-03-13"`301302    - `"thinking-display-updates-2026-08-18"`303304    - `"ce-user-management-2026-07-13"`305306    - `"mid-conversation-output-config-2026-07-01"`307308    - `"thinking-binding-controls-2026-08-01"`309310    - `"mid-conversation-system-clear-at-2026-08-21"`311312    - `"compact-2026-09-04"`313314- `"anthropic-workspace-id": optional string`315316### Returns317318- `data: array of BetaManagedAgentsSessionResource`319320  Resources for the session, ordered by `created_at`.321322  - `BetaManagedAgentsGitHubRepositoryResource object`323324    - `type: "github_repository"`325326    - `id: string`327328    - `created_at: string`329330      A timestamp in RFC 3339 format331332      format: date-time333334    - `mount_path: string`335336    - `updated_at: string`337338      A timestamp in RFC 3339 format339340      format: date-time341342    - `url: string`343344    - `checkout: optional BetaManagedAgentsBranchCheckout or BetaManagedAgentsCommitCheckout or null`345346      - `BetaManagedAgentsBranchCheckout object`347348        - `type: "branch"`349350        - `name: string`351352          Branch name to check out.353354          minLength: 1, maxLength: 255355356      - `BetaManagedAgentsCommitCheckout object`357358        - `type: "commit"`359360        - `sha: string`361362          Full commit SHA to check out.363364          minLength: 7, maxLength: 64365366  - `BetaManagedAgentsFileResource object`367368    - `type: "file"`369370    - `id: string`371372    - `created_at: string`373374      A timestamp in RFC 3339 format375376      format: date-time377378    - `file_id: string`379380    - `mount_path: string`381382    - `updated_at: string`383384      A timestamp in RFC 3339 format385386      format: date-time387388  - `BetaManagedAgentsMemoryStoreResource object`389390    A memory store attached to an agent session.391392    - `type: "memory_store"`393394    - `memory_store_id: string`395396      The memory store ID (memstore_...). Must belong to the caller's organization and workspace.397398    - `access: optional "read_write" or "read_only" or null`399400      Access mode for an attached memory store.401402      - `"read_write"`403404      - `"read_only"`405406    - `description: optional string`407408      Description of the memory store, snapshotted at attach time. Rendered into the agent's system prompt. Empty string when the store has no description.409410    - `instructions: optional string or null`411412      Per-attachment guidance for the agent on how to use this store. Rendered into the memory section of the system prompt. Max 4096 chars.413414      maxLength: 4096415416    - `mount_path: optional string or null`417418      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.419420    - `name: optional string or null`421422      Display name of the memory store, snapshotted at attach time. Later edits to the store's name do not propagate to this resource.423424- `next_page: optional string or null`425426  Opaque cursor for the next page. Null when no more results.427428### Example429430```bash431curl https://api.anthropic.com/v1/sessions/$SESSION_ID/resources \432    -H 'anthropic-version: 2023-06-01' \433    -H 'anthropic-beta: managed-agents-2026-04-01' \434    -H "X-Api-Key: $ANTHROPIC_API_KEY"435```436437#### Response (200)438439```json440{441  "data": [442    {443      "id": "sesrsc_011CZkZBJq5dWxk9fVLNcPht",444      "created_at": "2026-03-15T10:00:00Z",445      "file_id": "file_011CNha8iCJcU1wXNR6q4V8w",446      "mount_path": "/uploads/receipt.pdf",447      "type": "file",448      "updated_at": "2026-03-15T10:00:00Z"449    },450    {451      "id": "sesrsc_011CZkZCKr6eXyl0gWMOdQiu",452      "created_at": "2026-03-15T10:00:00Z",453      "mount_path": "/workspace/example-repo",454      "type": "github_repository",455      "updated_at": "2026-03-15T10:00:00Z",456      "url": "https://github.com/example-org/example-repo",457      "checkout": {458        "name": "main",459        "type": "branch"460      }461    }462  ],463  "next_page": "page_MjAyNS0wNS0xNFQwMDowMDowMFo="464}465```466467## Get Session Resource468469**GET** `/v1/sessions/{session_id}/resources/{resource_id}`470471Get Session Resource472473### Path parameters474475- `session_id: string`476477- `resource_id: string`478479### Headers480481- `"anthropic-beta": optional array of AnthropicBeta`482483  Optional header to specify the beta version(s) you want to use.484485  - `string`486487  - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 43 more`488489    - `"message-batches-2024-09-24"`490491    - `"prompt-caching-2024-07-31"`492493    - `"computer-use-2024-10-22"`494495    - `"computer-use-2025-01-24"`496497    - `"pdfs-2024-09-25"`498499    - `"token-counting-2024-11-01"`500501    - `"token-efficient-tools-2025-02-19"`502503    - `"output-128k-2025-02-19"`504505    - `"files-api-2025-04-14"`506507    - `"mcp-client-2025-04-04"`508509    - `"mcp-client-2025-11-20"`510511    - `"dev-full-thinking-2025-05-14"`512513    - `"interleaved-thinking-2025-05-14"`514515    - `"code-execution-2025-05-22"`516517    - `"extended-cache-ttl-2025-04-11"`518519    - `"context-1m-2025-08-07"`520521    - `"context-management-2025-06-27"`522523    - `"model-context-window-exceeded-2025-08-26"`524525    - `"skills-2025-10-02"`526527    - `"fast-mode-2026-02-01"`528529    - `"output-300k-2026-03-24"`530531    - `"user-profiles-2026-03-24"`532533    - `"user-profiles-2026-08-18"`534535    - `"user-profiles-2026-09-04"`536537    - `"advisor-tool-2026-03-01"`538539    - `"managed-agents-2026-04-01"`540541    - `"cache-diagnosis-2026-04-07"`542543    - `"dreaming-2026-04-21"`544545    - `"thinking-token-count-2026-05-13"`546547    - `"server-side-fallback-2026-06-01"`548549    - `"server-side-fallback-2026-07-01"`550551    - `"fallback-credit-2026-06-01"`552553    - `"fallback-credit-2026-07-01"`554555    - `"agent-memory-2026-07-22"`556557    - `"mid-conversation-tool-changes-2026-07-01"`558559    - `"compact-2026-01-12"`560561    - `"computer-use-2025-11-24"`562563    - `"mcp-tunnels-2026-06-22"`564565    - `"structured-outputs-2025-11-13"`566567    - `"task-budgets-2026-03-13"`568569    - `"thinking-display-updates-2026-08-18"`570571    - `"ce-user-management-2026-07-13"`572573    - `"mid-conversation-output-config-2026-07-01"`574575    - `"thinking-binding-controls-2026-08-01"`576577    - `"mid-conversation-system-clear-at-2026-08-21"`578579    - `"compact-2026-09-04"`580581- `"anthropic-workspace-id": optional string`582583### Returns584585- `BetaManagedAgentsGitHubRepositoryResource object`586587  - `type: "github_repository"`588589  - `id: string`590591  - `created_at: string`592593    A timestamp in RFC 3339 format594595    format: date-time596597  - `mount_path: string`598599  - `updated_at: string`600601    A timestamp in RFC 3339 format602603    format: date-time604605  - `url: string`606607  - `checkout: optional BetaManagedAgentsBranchCheckout or BetaManagedAgentsCommitCheckout or null`608609    - `BetaManagedAgentsBranchCheckout object`610611      - `type: "branch"`612613      - `name: string`614615        Branch name to check out.616617        minLength: 1, maxLength: 255618619    - `BetaManagedAgentsCommitCheckout object`620621      - `type: "commit"`622623      - `sha: string`624625        Full commit SHA to check out.626627        minLength: 7, maxLength: 64628629- `BetaManagedAgentsFileResource object`630631  - `type: "file"`632633  - `id: string`634635  - `created_at: string`636637    A timestamp in RFC 3339 format638639    format: date-time640641  - `file_id: string`642643  - `mount_path: string`644645  - `updated_at: string`646647    A timestamp in RFC 3339 format648649    format: date-time650651- `BetaManagedAgentsMemoryStoreResource object`652653  A memory store attached to an agent session.654655  - `type: "memory_store"`656657  - `memory_store_id: string`658659    The memory store ID (memstore_...). Must belong to the caller's organization and workspace.660661  - `access: optional "read_write" or "read_only" or null`662663    Access mode for an attached memory store.664665    - `"read_write"`666667    - `"read_only"`668669  - `description: optional string`670671    Description of the memory store, snapshotted at attach time. Rendered into the agent's system prompt. Empty string when the store has no description.672673  - `instructions: optional string or null`674675    Per-attachment guidance for the agent on how to use this store. Rendered into the memory section of the system prompt. Max 4096 chars.676677    maxLength: 4096678679  - `mount_path: optional string or null`680681    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.682683  - `name: optional string or null`684685    Display name of the memory store, snapshotted at attach time. Later edits to the store's name do not propagate to this resource.686687### Example688689```bash690curl https://api.anthropic.com/v1/sessions/$SESSION_ID/resources/$RESOURCE_ID \691    -H 'anthropic-version: 2023-06-01' \692    -H 'anthropic-beta: managed-agents-2026-04-01' \693    -H "X-Api-Key: $ANTHROPIC_API_KEY"694```695696#### Response (200)697698```json699{700  "id": "sesrsc_011CZkZCKr6eXyl0gWMOdQiu",701  "created_at": "2026-03-15T10:00:00Z",702  "mount_path": "/workspace/example-repo",703  "type": "github_repository",704  "updated_at": "2026-03-15T10:00:00Z",705  "url": "https://github.com/example-org/example-repo",706  "checkout": {707    "name": "main",708    "type": "branch"709  }710}711```712713## Update Session Resource714715**POST** `/v1/sessions/{session_id}/resources/{resource_id}`716717Update Session Resource718719### Path parameters720721- `session_id: string`722723- `resource_id: string`724725### Headers726727- `"anthropic-beta": optional array of AnthropicBeta`728729  Optional header to specify the beta version(s) you want to use.730731  - `string`732733  - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 43 more`734735    - `"message-batches-2024-09-24"`736737    - `"prompt-caching-2024-07-31"`738739    - `"computer-use-2024-10-22"`740741    - `"computer-use-2025-01-24"`742743    - `"pdfs-2024-09-25"`744745    - `"token-counting-2024-11-01"`746747    - `"token-efficient-tools-2025-02-19"`748749    - `"output-128k-2025-02-19"`750751    - `"files-api-2025-04-14"`752753    - `"mcp-client-2025-04-04"`754755    - `"mcp-client-2025-11-20"`756757    - `"dev-full-thinking-2025-05-14"`758759    - `"interleaved-thinking-2025-05-14"`760761    - `"code-execution-2025-05-22"`762763    - `"extended-cache-ttl-2025-04-11"`764765    - `"context-1m-2025-08-07"`766767    - `"context-management-2025-06-27"`768769    - `"model-context-window-exceeded-2025-08-26"`770771    - `"skills-2025-10-02"`772773    - `"fast-mode-2026-02-01"`774775    - `"output-300k-2026-03-24"`776777    - `"user-profiles-2026-03-24"`778779    - `"user-profiles-2026-08-18"`780781    - `"user-profiles-2026-09-04"`782783    - `"advisor-tool-2026-03-01"`784785    - `"managed-agents-2026-04-01"`786787    - `"cache-diagnosis-2026-04-07"`788789    - `"dreaming-2026-04-21"`790791    - `"thinking-token-count-2026-05-13"`792793    - `"server-side-fallback-2026-06-01"`794795    - `"server-side-fallback-2026-07-01"`796797    - `"fallback-credit-2026-06-01"`798799    - `"fallback-credit-2026-07-01"`800801    - `"agent-memory-2026-07-22"`802803    - `"mid-conversation-tool-changes-2026-07-01"`804805    - `"compact-2026-01-12"`806807    - `"computer-use-2025-11-24"`808809    - `"mcp-tunnels-2026-06-22"`810811    - `"structured-outputs-2025-11-13"`812813    - `"task-budgets-2026-03-13"`814815    - `"thinking-display-updates-2026-08-18"`816817    - `"ce-user-management-2026-07-13"`818819    - `"mid-conversation-output-config-2026-07-01"`820821    - `"thinking-binding-controls-2026-08-01"`822823    - `"mid-conversation-system-clear-at-2026-08-21"`824825    - `"compact-2026-09-04"`826827- `"anthropic-workspace-id": optional string`828829### Body parameters830831- `authorization_token: string`832833  New authorization token for the resource. Currently only `github_repository` resources support token rotation.834835  minLength: 1, maxLength: 4096836837### Returns838839- `BetaManagedAgentsGitHubRepositoryResource object`840841  - `type: "github_repository"`842843  - `id: string`844845  - `created_at: string`846847    A timestamp in RFC 3339 format848849    format: date-time850851  - `mount_path: string`852853  - `updated_at: string`854855    A timestamp in RFC 3339 format856857    format: date-time858859  - `url: string`860861  - `checkout: optional BetaManagedAgentsBranchCheckout or BetaManagedAgentsCommitCheckout or null`862863    - `BetaManagedAgentsBranchCheckout object`864865      - `type: "branch"`866867      - `name: string`868869        Branch name to check out.870871        minLength: 1, maxLength: 255872873    - `BetaManagedAgentsCommitCheckout object`874875      - `type: "commit"`876877      - `sha: string`878879        Full commit SHA to check out.880881        minLength: 7, maxLength: 64882883- `BetaManagedAgentsFileResource object`884885  - `type: "file"`886887  - `id: string`888889  - `created_at: string`890891    A timestamp in RFC 3339 format892893    format: date-time894895  - `file_id: string`896897  - `mount_path: string`898899  - `updated_at: string`900901    A timestamp in RFC 3339 format902903    format: date-time904905- `BetaManagedAgentsMemoryStoreResource object`906907  A memory store attached to an agent session.908909  - `type: "memory_store"`910911  - `memory_store_id: string`912913    The memory store ID (memstore_...). Must belong to the caller's organization and workspace.914915  - `access: optional "read_write" or "read_only" or null`916917    Access mode for an attached memory store.918919    - `"read_write"`920921    - `"read_only"`922923  - `description: optional string`924925    Description of the memory store, snapshotted at attach time. Rendered into the agent's system prompt. Empty string when the store has no description.926927  - `instructions: optional string or null`928929    Per-attachment guidance for the agent on how to use this store. Rendered into the memory section of the system prompt. Max 4096 chars.930931    maxLength: 4096932933  - `mount_path: optional string or null`934935    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.936937  - `name: optional string or null`938939    Display name of the memory store, snapshotted at attach time. Later edits to the store's name do not propagate to this resource.940941### Example942943```bash944curl https://api.anthropic.com/v1/sessions/$SESSION_ID/resources/$RESOURCE_ID \945    -H 'Content-Type: application/json' \946    -H 'anthropic-version: 2023-06-01' \947    -H 'anthropic-beta: managed-agents-2026-04-01' \948    -H "X-Api-Key: $ANTHROPIC_API_KEY" \949    -d '{950          "authorization_token": "ghp_exampletoken"951        }'952```953954#### Response (200)955956```json957{958  "id": "sesrsc_011CZkZCKr6eXyl0gWMOdQiu",959  "created_at": "2026-03-15T10:00:00Z",960  "mount_path": "/workspace/example-repo",961  "type": "github_repository",962  "updated_at": "2026-03-15T10:00:00Z",963  "url": "https://github.com/example-org/example-repo",964  "checkout": {965    "name": "main",966    "type": "branch"967  }968}969```970971## Delete Session Resource972973**DELETE** `/v1/sessions/{session_id}/resources/{resource_id}`974975Delete Session Resource976977### Path parameters978979- `session_id: string`980981- `resource_id: string`982983### Headers984985- `"anthropic-beta": optional array of AnthropicBeta`986987  Optional header to specify the beta version(s) you want to use.988989  - `string`990991  - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 43 more`992993    - `"message-batches-2024-09-24"`994995    - `"prompt-caching-2024-07-31"`996997    - `"computer-use-2024-10-22"`998999    - `"computer-use-2025-01-24"`10001001    - `"pdfs-2024-09-25"`10021003    - `"token-counting-2024-11-01"`10041005    - `"token-efficient-tools-2025-02-19"`10061007    - `"output-128k-2025-02-19"`10081009    - `"files-api-2025-04-14"`10101011    - `"mcp-client-2025-04-04"`10121013    - `"mcp-client-2025-11-20"`10141015    - `"dev-full-thinking-2025-05-14"`10161017    - `"interleaved-thinking-2025-05-14"`10181019    - `"code-execution-2025-05-22"`10201021    - `"extended-cache-ttl-2025-04-11"`10221023    - `"context-1m-2025-08-07"`10241025    - `"context-management-2025-06-27"`10261027    - `"model-context-window-exceeded-2025-08-26"`10281029    - `"skills-2025-10-02"`10301031    - `"fast-mode-2026-02-01"`10321033    - `"output-300k-2026-03-24"`10341035    - `"user-profiles-2026-03-24"`10361037    - `"user-profiles-2026-08-18"`10381039    - `"user-profiles-2026-09-04"`10401041    - `"advisor-tool-2026-03-01"`10421043    - `"managed-agents-2026-04-01"`10441045    - `"cache-diagnosis-2026-04-07"`10461047    - `"dreaming-2026-04-21"`10481049    - `"thinking-token-count-2026-05-13"`10501051    - `"server-side-fallback-2026-06-01"`10521053    - `"server-side-fallback-2026-07-01"`10541055    - `"fallback-credit-2026-06-01"`10561057    - `"fallback-credit-2026-07-01"`10581059    - `"agent-memory-2026-07-22"`10601061    - `"mid-conversation-tool-changes-2026-07-01"`10621063    - `"compact-2026-01-12"`10641065    - `"computer-use-2025-11-24"`10661067    - `"mcp-tunnels-2026-06-22"`10681069    - `"structured-outputs-2025-11-13"`10701071    - `"task-budgets-2026-03-13"`10721073    - `"thinking-display-updates-2026-08-18"`10741075    - `"ce-user-management-2026-07-13"`10761077    - `"mid-conversation-output-config-2026-07-01"`10781079    - `"thinking-binding-controls-2026-08-01"`10801081    - `"mid-conversation-system-clear-at-2026-08-21"`10821083    - `"compact-2026-09-04"`10841085- `"anthropic-workspace-id": optional string`10861087### Returns10881089- `BetaManagedAgentsDeleteSessionResource object`10901091  Confirmation of resource deletion.10921093  - `type: "session_resource_deleted"`10941095  - `id: string`10961097### Example10981099```bash1100curl https://api.anthropic.com/v1/sessions/$SESSION_ID/resources/$RESOURCE_ID \1101    -X DELETE \1102    -H 'anthropic-version: 2023-06-01' \1103    -H 'anthropic-beta: managed-agents-2026-04-01' \1104    -H "X-Api-Key: $ANTHROPIC_API_KEY"1105```11061107#### Response (200)11081109```json1110{1111  "id": "sesrsc_011CZkZBJq5dWxk9fVLNcPht",1112  "type": "session_resource_deleted"1113}1114```11151116## Domain types11171118### Beta Managed Agents Delete Session Resource11191120- `BetaManagedAgentsDeleteSessionResource object`11211122  Confirmation of resource deletion.11231124  - `type: "session_resource_deleted"`11251126  - `id: string`11271128### Beta Managed Agents File Resource11291130- `BetaManagedAgentsFileResource object`11311132  - `type: "file"`11331134  - `id: string`11351136  - `created_at: string`11371138    A timestamp in RFC 3339 format11391140    format: date-time11411142  - `file_id: string`11431144  - `mount_path: string`11451146  - `updated_at: string`11471148    A timestamp in RFC 3339 format11491150    format: date-time11511152### Beta Managed Agents GitHub Repository Resource11531154- `BetaManagedAgentsGitHubRepositoryResource object`11551156  - `type: "github_repository"`11571158  - `id: string`11591160  - `created_at: string`11611162    A timestamp in RFC 3339 format11631164    format: date-time11651166  - `mount_path: string`11671168  - `updated_at: string`11691170    A timestamp in RFC 3339 format11711172    format: date-time11731174  - `url: string`11751176  - `checkout: optional BetaManagedAgentsBranchCheckout or BetaManagedAgentsCommitCheckout or null`11771178    - `BetaManagedAgentsBranchCheckout object`11791180      - `type: "branch"`11811182      - `name: string`11831184        Branch name to check out.11851186        minLength: 1, maxLength: 25511871188    - `BetaManagedAgentsCommitCheckout object`11891190      - `type: "commit"`11911192      - `sha: string`11931194        Full commit SHA to check out.11951196        minLength: 7, maxLength: 6411971198### Beta Managed Agents Memory Store Resource11991200- `BetaManagedAgentsMemoryStoreResource object`12011202  A memory store attached to an agent session.12031204  - `type: "memory_store"`12051206  - `memory_store_id: string`12071208    The memory store ID (memstore_...). Must belong to the caller's organization and workspace.12091210  - `access: optional "read_write" or "read_only" or null`12111212    Access mode for an attached memory store.12131214    - `"read_write"`12151216    - `"read_only"`12171218  - `description: optional string`12191220    Description of the memory store, snapshotted at attach time. Rendered into the agent's system prompt. Empty string when the store has no description.12211222  - `instructions: optional string or null`12231224    Per-attachment guidance for the agent on how to use this store. Rendered into the memory section of the system prompt. Max 4096 chars.12251226    maxLength: 409612271228  - `mount_path: optional string or null`12291230    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.12311232  - `name: optional string or null`12331234    Display name of the memory store, snapshotted at attach time. Later edits to the store's name do not propagate to this resource.12351236### Beta Managed Agents Session Resource12371238- `BetaManagedAgentsSessionResource = BetaManagedAgentsGitHubRepositoryResource or BetaManagedAgentsFileResource or BetaManagedAgentsMemoryStoreResource`12391240  - `BetaManagedAgentsGitHubRepositoryResource object`12411242    - `type: "github_repository"`12431244    - `id: string`12451246    - `created_at: string`12471248      A timestamp in RFC 3339 format12491250      format: date-time12511252    - `mount_path: string`12531254    - `updated_at: string`12551256      A timestamp in RFC 3339 format12571258      format: date-time12591260    - `url: string`12611262    - `checkout: optional BetaManagedAgentsBranchCheckout or BetaManagedAgentsCommitCheckout or null`12631264      - `BetaManagedAgentsBranchCheckout object`12651266        - `type: "branch"`12671268        - `name: string`12691270          Branch name to check out.12711272          minLength: 1, maxLength: 25512731274      - `BetaManagedAgentsCommitCheckout object`12751276        - `type: "commit"`12771278        - `sha: string`12791280          Full commit SHA to check out.12811282          minLength: 7, maxLength: 6412831284  - `BetaManagedAgentsFileResource object`12851286    - `type: "file"`12871288    - `id: string`12891290    - `created_at: string`12911292      A timestamp in RFC 3339 format12931294      format: date-time12951296    - `file_id: string`12971298    - `mount_path: string`12991300    - `updated_at: string`13011302      A timestamp in RFC 3339 format13031304      format: date-time13051306  - `BetaManagedAgentsMemoryStoreResource object`13071308    A memory store attached to an agent session.13091310    - `type: "memory_store"`13111312    - `memory_store_id: string`13131314      The memory store ID (memstore_...). Must belong to the caller's organization and workspace.13151316    - `access: optional "read_write" or "read_only" or null`13171318      Access mode for an attached memory store.13191320      - `"read_write"`13211322      - `"read_only"`13231324    - `description: optional string`13251326      Description of the memory store, snapshotted at attach time. Rendered into the agent's system prompt. Empty string when the store has no description.13271328    - `instructions: optional string or null`13291330      Per-attachment guidance for the agent on how to use this store. Rendered into the memory section of the system prompt. Max 4096 chars.13311332      maxLength: 409613331334    - `mount_path: optional string or null`13351336      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.13371338    - `name: optional string or null`13391340      Display name of the memory store, snapshotted at attach time. Later edits to the store's name do not propagate to this resource.13411342### Resource Retrieve Response13431344- `ResourceRetrieveResponse = BetaManagedAgentsGitHubRepositoryResource or BetaManagedAgentsFileResource or BetaManagedAgentsMemoryStoreResource`13451346  The requested session resource.13471348  - `BetaManagedAgentsGitHubRepositoryResource object`13491350    - `type: "github_repository"`13511352    - `id: string`13531354    - `created_at: string`13551356      A timestamp in RFC 3339 format13571358      format: date-time13591360    - `mount_path: string`13611362    - `updated_at: string`13631364      A timestamp in RFC 3339 format13651366      format: date-time13671368    - `url: string`13691370    - `checkout: optional BetaManagedAgentsBranchCheckout or BetaManagedAgentsCommitCheckout or null`13711372      - `BetaManagedAgentsBranchCheckout object`13731374        - `type: "branch"`13751376        - `name: string`13771378          Branch name to check out.13791380          minLength: 1, maxLength: 25513811382      - `BetaManagedAgentsCommitCheckout object`13831384        - `type: "commit"`13851386        - `sha: string`13871388          Full commit SHA to check out.13891390          minLength: 7, maxLength: 6413911392  - `BetaManagedAgentsFileResource object`13931394    - `type: "file"`13951396    - `id: string`13971398    - `created_at: string`13991400      A timestamp in RFC 3339 format14011402      format: date-time14031404    - `file_id: string`14051406    - `mount_path: string`14071408    - `updated_at: string`14091410      A timestamp in RFC 3339 format14111412      format: date-time14131414  - `BetaManagedAgentsMemoryStoreResource object`14151416    A memory store attached to an agent session.14171418    - `type: "memory_store"`14191420    - `memory_store_id: string`14211422      The memory store ID (memstore_...). Must belong to the caller's organization and workspace.14231424    - `access: optional "read_write" or "read_only" or null`14251426      Access mode for an attached memory store.14271428      - `"read_write"`14291430      - `"read_only"`14311432    - `description: optional string`14331434      Description of the memory store, snapshotted at attach time. Rendered into the agent's system prompt. Empty string when the store has no description.14351436    - `instructions: optional string or null`14371438      Per-attachment guidance for the agent on how to use this store. Rendered into the memory section of the system prompt. Max 4096 chars.14391440      maxLength: 409614411442    - `mount_path: optional string or null`14431444      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.14451446    - `name: optional string or null`14471448      Display name of the memory store, snapshotted at attach time. Later edits to the store's name do not propagate to this resource.14491450### Resource Update Response14511452- `ResourceUpdateResponse = BetaManagedAgentsGitHubRepositoryResource or BetaManagedAgentsFileResource or BetaManagedAgentsMemoryStoreResource`14531454  The updated session resource.14551456  - `BetaManagedAgentsGitHubRepositoryResource object`14571458    - `type: "github_repository"`14591460    - `id: string`14611462    - `created_at: string`14631464      A timestamp in RFC 3339 format14651466      format: date-time14671468    - `mount_path: string`14691470    - `updated_at: string`14711472      A timestamp in RFC 3339 format14731474      format: date-time14751476    - `url: string`14771478    - `checkout: optional BetaManagedAgentsBranchCheckout or BetaManagedAgentsCommitCheckout or null`14791480      - `BetaManagedAgentsBranchCheckout object`14811482        - `type: "branch"`14831484        - `name: string`14851486          Branch name to check out.14871488          minLength: 1, maxLength: 25514891490      - `BetaManagedAgentsCommitCheckout object`14911492        - `type: "commit"`14931494        - `sha: string`14951496          Full commit SHA to check out.14971498          minLength: 7, maxLength: 6414991500  - `BetaManagedAgentsFileResource object`15011502    - `type: "file"`15031504    - `id: string`15051506    - `created_at: string`15071508      A timestamp in RFC 3339 format15091510      format: date-time15111512    - `file_id: string`15131514    - `mount_path: string`15151516    - `updated_at: string`15171518      A timestamp in RFC 3339 format15191520      format: date-time15211522  - `BetaManagedAgentsMemoryStoreResource object`15231524    A memory store attached to an agent session.15251526    - `type: "memory_store"`15271528    - `memory_store_id: string`15291530      The memory store ID (memstore_...). Must belong to the caller's organization and workspace.15311532    - `access: optional "read_write" or "read_only" or null`15331534      Access mode for an attached memory store.15351536      - `"read_write"`15371538      - `"read_only"`15391540    - `description: optional string`15411542      Description of the memory store, snapshotted at attach time. Rendered into the agent's system prompt. Empty string when the store has no description.15431544    - `instructions: optional string or null`15451546      Per-attachment guidance for the agent on how to use this store. Rendered into the memory section of the system prompt. Max 4096 chars.15471548      maxLength: 409615491550    - `mount_path: optional string or null`15511552      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.15531554    - `name: optional string or null`15551556      Display name of the memory store, snapshotted at attach time. Later edits to the store's name do not propagate to this resource.1557
Files main
Menu

Theme