Add Session Resource

post/v1/sessions/{session_id}/resources?beta=true

Path parameters

session_idstring required

Path parameter session_id

Headers

anthropic-versionstring
anthropic-betastring

Request body

type'file' required
file_idstring required

ID of a previously uploaded file.

mount_pathstring nullable

Mount path in the container. Defaults to /mnt/session/uploads/<file_id>.

Example request

{
  "type": "file",
  "file_id": "file_011CNha8iCJcU1wXNR6q4V8w",
  "mount_path": "/uploads/receipt.pdf"
}

Response

Successful response (OK)

type'file' required
idstring required
file_idstring required
mount_pathstring required
created_atstring date-time required

A timestamp in RFC 3339 format

updated_atstring date-time required

A timestamp in RFC 3339 format

Example response

{
  "type": "file",
  "id": "sesrsc_011CZkZBJq5dWxk9fVLNcPht",
  "file_id": "file_011CNha8iCJcU1wXNR6q4V8w",
  "mount_path": "/uploads/receipt.pdf",
  "created_at": "2026-03-15T10:00:00Z",
  "updated_at": "2026-03-15T10:00:00Z"
}

Changes

Changed in 2 of the 68 revisions of this API.13

  • d2b230555b7f12See the full diff
    • the request property //// became not nullable

      request-property-became-not-nullable

    • request property //// list-of-types was widened by adding types null to media type application/json

      request-property-list-of-types-widened

    • the //// request property's minLength was decreased from 1 to 0

      request-property-min-length-decreased

    • endpoint added

      endpoint-added