Authorization

bearerAuth

AuthorizationBearer <token>

A personal API key (psk_…) or an OAuth access token (plan_at_…). Scopes: read, write.

In: header

Path Parameters

projectSlug*string

Project slug, e.g. recipe-box.

planShortId*string

Plan handle within the project, e.g. PLAN-12.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

filename*string

The original file name. Decides the type when none is sent.

content_type?string

Optional. application/octet-stream (what curl and most SDKs send) is ignored in favour of the extension.

size*integer

Bytes. Refused up front past the cap for this kind: 25 MB for a document, 2 GB for a recording.

duration_seconds?number

Optional, recordings only. Refused past 2 hours before the upload starts. Re-checked against the container once the bytes land.

Response Body

`application/json`

curl -X POST "https://example.com/v1/projects/string/plans/string/context/upload-url" \  -H "Content-Type: application/json" \  -d '{    "filename": "string",    "size": 0  }'

{  "storage_ref": "string",  "url": "string",  "token": "string"}

View as Markdown Open in Claude Open in ChatGPT

Mint a signed upload URL for a large file, then post its storage_ref

Authorization

Path Parameters

Request Body

Response Body

200application/json

401application/json

404application/json

429application/json

`application/json`

`application/json`

`application/json`

`application/json`