--- title: Resources url: https://platform.claude.com/docs/en/api/php/beta/sessions/resources --- # Resources ## Add Session Resource `$client->beta->sessions->resources->add(string sessionID, string fileID, "file" type, ?string mountPath, ?list betas, ?string workspaceID): ManagedAgentsFileResource` **POST** `/v1/sessions/{session_id}/resources` Add Session Resource ### Parameters - `sessionID: string` (path parameter) - `fileID: string` ID of a previously uploaded file. - `type: "file"` - `mountPath?: optional string` Mount path in the container. Defaults to `/mnt/session/uploads/`. - `betas?: optional list` (header parameter) This endpoint is in beta: requests must send `managed-agents-2026-04-01` in this header. - `workspaceID?: optional string` (header parameter) Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`). Only needed for credentials that can act on more than one Workspace. A credential that belongs to a specific Workspace may omit it; if sent, it must match that Workspace. ### Returns - `class ManagedAgentsFileResource` - `"file" type` - `string id` - `\Datetime createdAt` A timestamp in RFC 3339 format - `string fileID` - `string mountPath` - `\Datetime updatedAt` A timestamp in RFC 3339 format ### Example ```php beta->sessions->resources->add( 'sesn_011CZkZAtmR3yMPDzynEDxu7', fileID: 'file_011CNha8iCJcU1wXNR6q4V8w', type: 'file', mountPath: '/uploads/receipt.pdf', betas: [AnthropicBeta::MESSAGE_BATCHES_2024_09_24], workspaceID: 'wrkspc_011CZkZaBF1tNoB5wlCeusgy', ); var_dump($betaManagedAgentsFileResource); ``` #### Response (200) ```json { "id": "sesrsc_011CZkZBJq5dWxk9fVLNcPht", "created_at": "2026-03-15T10:00:00Z", "file_id": "file_011CNha8iCJcU1wXNR6q4V8w", "mount_path": "/uploads/receipt.pdf", "type": "file", "updated_at": "2026-03-15T10:00:00Z" } ``` ## List Session Resources `$client->beta->sessions->resources->list(string sessionID, ?int limit, ?string page, ?list betas, ?string workspaceID): PageCursor` **GET** `/v1/sessions/{session_id}/resources` List Session Resources ### Parameters - `sessionID: string` (path parameter) - `limit?: optional int` (query parameter) Maximum number of resources to return per page (max 1000). If omitted, returns all resources. - `page?: optional string` (query parameter) Opaque cursor from a previous response's `next_page` field. - `betas?: optional list` (header parameter) This endpoint is in beta: requests must send `managed-agents-2026-04-01` in this header. - `workspaceID?: optional string` (header parameter) Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`). Only needed for credentials that can act on more than one Workspace. A credential that belongs to a specific Workspace may omit it; if sent, it must match that Workspace. ### Returns - `class ManagedAgentsSessionResource` - `class ManagedAgentsGitHubRepositoryResource` - `"github_repository" type` - `string id` - `\Datetime createdAt` A timestamp in RFC 3339 format - `string mountPath` - `\Datetime updatedAt` A timestamp in RFC 3339 format - `string url` - `?Checkout checkout` - `class ManagedAgentsFileResource` - `"file" type` - `string id` - `\Datetime createdAt` A timestamp in RFC 3339 format - `string fileID` - `string mountPath` - `\Datetime updatedAt` A timestamp in RFC 3339 format - `class ManagedAgentsMemoryStoreResource` - `"memory_store" type` - `string memoryStoreID` The memory store ID (memstore_...). Must belong to the caller's organization and workspace. - `?Access access` Access mode for the mounted store. Defaults to `read_write`. `read_only` mounts the store as a read-only filesystem. - `?string description` Description of the memory store, snapshotted at attach time. Rendered into the agent's system prompt. Empty string when the store has no description. - `?string instructions` Per-attachment guidance for the agent on how to use this store. Rendered into the memory section of the system prompt. Max 4096 chars. - `?string mountPath` 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. - `?string name` Display name of the memory store, snapshotted at attach time. Later edits to the store's name do not propagate to this resource. ### Example ```php beta->sessions->resources->list( 'sesn_011CZkZAtmR3yMPDzynEDxu7', limit: 0, page: 'page', betas: [AnthropicBeta::MESSAGE_BATCHES_2024_09_24], workspaceID: 'wrkspc_011CZkZaBF1tNoB5wlCeusgy', ); var_dump($page); ``` #### Response (200) ```json { "data": [ { "id": "sesrsc_011CZkZBJq5dWxk9fVLNcPht", "created_at": "2026-03-15T10:00:00Z", "file_id": "file_011CNha8iCJcU1wXNR6q4V8w", "mount_path": "/uploads/receipt.pdf", "type": "file", "updated_at": "2026-03-15T10:00:00Z" }, { "id": "sesrsc_011CZkZCKr6eXym1gWMPdQiu", "created_at": "2026-03-15T10:00:00Z", "mount_path": "/workspace/example-repo", "type": "github_repository", "updated_at": "2026-03-15T10:00:00Z", "url": "https://github.com/example-org/example-repo", "checkout": { "name": "main", "type": "branch" } } ], "next_page": "page_MjAyNS0wNS0xNFQwMDowMDowMFo=" } ``` ## Get Session Resource `$client->beta->sessions->resources->retrieve(string resourceID, string sessionID, ?list betas, ?string workspaceID): ResourceGetResponse` **GET** `/v1/sessions/{session_id}/resources/{resource_id}` Get Session Resource ### Parameters - `sessionID: string` (path parameter) - `resourceID: string` (path parameter) - `betas?: optional list` (header parameter) This endpoint is in beta: requests must send `managed-agents-2026-04-01` in this header. - `workspaceID?: optional string` (header parameter) Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`). Only needed for credentials that can act on more than one Workspace. A credential that belongs to a specific Workspace may omit it; if sent, it must match that Workspace. ### Returns - `class ResourceGetResponse` - `class ManagedAgentsGitHubRepositoryResource` - `"github_repository" type` - `string id` - `\Datetime createdAt` A timestamp in RFC 3339 format - `string mountPath` - `\Datetime updatedAt` A timestamp in RFC 3339 format - `string url` - `?Checkout checkout` - `class ManagedAgentsFileResource` - `"file" type` - `string id` - `\Datetime createdAt` A timestamp in RFC 3339 format - `string fileID` - `string mountPath` - `\Datetime updatedAt` A timestamp in RFC 3339 format - `class ManagedAgentsMemoryStoreResource` - `"memory_store" type` - `string memoryStoreID` The memory store ID (memstore_...). Must belong to the caller's organization and workspace. - `?Access access` Access mode for the mounted store. Defaults to `read_write`. `read_only` mounts the store as a read-only filesystem. - `?string description` Description of the memory store, snapshotted at attach time. Rendered into the agent's system prompt. Empty string when the store has no description. - `?string instructions` Per-attachment guidance for the agent on how to use this store. Rendered into the memory section of the system prompt. Max 4096 chars. - `?string mountPath` 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. - `?string name` Display name of the memory store, snapshotted at attach time. Later edits to the store's name do not propagate to this resource. ### Example ```php beta->sessions->resources->retrieve( 'sesrsc_011CZkZBJq5dWxk9fVLNcPht', sessionID: 'sesn_011CZkZAtmR3yMPDzynEDxu7', betas: [AnthropicBeta::MESSAGE_BATCHES_2024_09_24], workspaceID: 'wrkspc_011CZkZaBF1tNoB5wlCeusgy', ); var_dump($resource); ``` #### Response (200) ```json { "id": "sesrsc_011CZkZCKr6eXym1gWMPdQiu", "created_at": "2026-03-15T10:00:00Z", "mount_path": "/workspace/example-repo", "type": "github_repository", "updated_at": "2026-03-15T10:00:00Z", "url": "https://github.com/example-org/example-repo", "checkout": { "name": "main", "type": "branch" } } ``` ## Update Session Resource `$client->beta->sessions->resources->update(string resourceID, string sessionID, string authorizationToken, ?list betas, ?string workspaceID): ResourceUpdateResponse` **POST** `/v1/sessions/{session_id}/resources/{resource_id}` Update Session Resource ### Parameters - `sessionID: string` (path parameter) - `resourceID: string` (path parameter) - `authorizationToken: string` New authorization token for the resource. Currently only `github_repository` resources support token rotation. - `betas?: optional list` (header parameter) This endpoint is in beta: requests must send `managed-agents-2026-04-01` in this header. - `workspaceID?: optional string` (header parameter) Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`). Only needed for credentials that can act on more than one Workspace. A credential that belongs to a specific Workspace may omit it; if sent, it must match that Workspace. ### Returns - `class ResourceUpdateResponse` - `class ManagedAgentsGitHubRepositoryResource` - `"github_repository" type` - `string id` - `\Datetime createdAt` A timestamp in RFC 3339 format - `string mountPath` - `\Datetime updatedAt` A timestamp in RFC 3339 format - `string url` - `?Checkout checkout` - `class ManagedAgentsFileResource` - `"file" type` - `string id` - `\Datetime createdAt` A timestamp in RFC 3339 format - `string fileID` - `string mountPath` - `\Datetime updatedAt` A timestamp in RFC 3339 format - `class ManagedAgentsMemoryStoreResource` - `"memory_store" type` - `string memoryStoreID` The memory store ID (memstore_...). Must belong to the caller's organization and workspace. - `?Access access` Access mode for the mounted store. Defaults to `read_write`. `read_only` mounts the store as a read-only filesystem. - `?string description` Description of the memory store, snapshotted at attach time. Rendered into the agent's system prompt. Empty string when the store has no description. - `?string instructions` Per-attachment guidance for the agent on how to use this store. Rendered into the memory section of the system prompt. Max 4096 chars. - `?string mountPath` 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. - `?string name` Display name of the memory store, snapshotted at attach time. Later edits to the store's name do not propagate to this resource. ### Example ```php beta->sessions->resources->update( 'sesrsc_011CZkZBJq5dWxk9fVLNcPht', sessionID: 'sesn_011CZkZAtmR3yMPDzynEDxu7', authorizationToken: 'ghp_exampletoken', betas: [AnthropicBeta::MESSAGE_BATCHES_2024_09_24], workspaceID: 'wrkspc_011CZkZaBF1tNoB5wlCeusgy', ); var_dump($resource); ``` #### Response (200) ```json { "id": "sesrsc_011CZkZCKr6eXym1gWMPdQiu", "created_at": "2026-03-15T10:00:00Z", "mount_path": "/workspace/example-repo", "type": "github_repository", "updated_at": "2026-03-15T10:00:00Z", "url": "https://github.com/example-org/example-repo", "checkout": { "name": "main", "type": "branch" } } ``` ## Delete Session Resource `$client->beta->sessions->resources->delete(string resourceID, string sessionID, ?list betas, ?string workspaceID): ManagedAgentsDeleteSessionResource` **DELETE** `/v1/sessions/{session_id}/resources/{resource_id}` Delete Session Resource ### Parameters - `sessionID: string` (path parameter) - `resourceID: string` (path parameter) - `betas?: optional list` (header parameter) This endpoint is in beta: requests must send `managed-agents-2026-04-01` in this header. - `workspaceID?: optional string` (header parameter) Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`). Only needed for credentials that can act on more than one Workspace. A credential that belongs to a specific Workspace may omit it; if sent, it must match that Workspace. ### Returns - `class ManagedAgentsDeleteSessionResource` - `"session_resource_deleted" type` - `string id` ### Example ```php beta ->sessions ->resources ->delete( 'sesrsc_011CZkZBJq5dWxk9fVLNcPht', sessionID: 'sesn_011CZkZAtmR3yMPDzynEDxu7', betas: [AnthropicBeta::MESSAGE_BATCHES_2024_09_24], workspaceID: 'wrkspc_011CZkZaBF1tNoB5wlCeusgy', ); var_dump($betaManagedAgentsDeleteSessionResource); ``` #### Response (200) ```json { "id": "sesrsc_011CZkZBJq5dWxk9fVLNcPht", "type": "session_resource_deleted" } ``` ## Domain types ### Beta Managed Agents Delete Session Resource - `class ManagedAgentsDeleteSessionResource` - `"session_resource_deleted" type` - `string id` ### Beta Managed Agents File Resource - `class ManagedAgentsFileResource` - `"file" type` - `string id` - `\Datetime createdAt` A timestamp in RFC 3339 format - `string fileID` - `string mountPath` - `\Datetime updatedAt` A timestamp in RFC 3339 format ### Beta Managed Agents GitHub Repository Resource - `class ManagedAgentsGitHubRepositoryResource` - `"github_repository" type` - `string id` - `\Datetime createdAt` A timestamp in RFC 3339 format - `string mountPath` - `\Datetime updatedAt` A timestamp in RFC 3339 format - `string url` - `?Checkout checkout` ### Beta Managed Agents Memory Store Resource - `class ManagedAgentsMemoryStoreResource` - `"memory_store" type` - `string memoryStoreID` The memory store ID (memstore_...). Must belong to the caller's organization and workspace. - `?Access access` Access mode for the mounted store. Defaults to `read_write`. `read_only` mounts the store as a read-only filesystem. - `?string description` Description of the memory store, snapshotted at attach time. Rendered into the agent's system prompt. Empty string when the store has no description. - `?string instructions` Per-attachment guidance for the agent on how to use this store. Rendered into the memory section of the system prompt. Max 4096 chars. - `?string mountPath` 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. - `?string name` Display name of the memory store, snapshotted at attach time. Later edits to the store's name do not propagate to this resource. ### Beta Managed Agents Session Resource - `class ManagedAgentsSessionResource` - `class ManagedAgentsGitHubRepositoryResource` - `"github_repository" type` - `string id` - `\Datetime createdAt` A timestamp in RFC 3339 format - `string mountPath` - `\Datetime updatedAt` A timestamp in RFC 3339 format - `string url` - `?Checkout checkout` - `class ManagedAgentsFileResource` - `"file" type` - `string id` - `\Datetime createdAt` A timestamp in RFC 3339 format - `string fileID` - `string mountPath` - `\Datetime updatedAt` A timestamp in RFC 3339 format - `class ManagedAgentsMemoryStoreResource` - `"memory_store" type` - `string memoryStoreID` The memory store ID (memstore_...). Must belong to the caller's organization and workspace. - `?Access access` Access mode for the mounted store. Defaults to `read_write`. `read_only` mounts the store as a read-only filesystem. - `?string description` Description of the memory store, snapshotted at attach time. Rendered into the agent's system prompt. Empty string when the store has no description. - `?string instructions` Per-attachment guidance for the agent on how to use this store. Rendered into the memory section of the system prompt. Max 4096 chars. - `?string mountPath` 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. - `?string name` Display name of the memory store, snapshotted at attach time. Later edits to the store's name do not propagate to this resource.