Create a presigned upload URL

POST 
/api/v1/files/presigned-url

Creates a short-lived, single-use presigned upload URL — the local-storage equivalent of an S3 presigned URL. The client then uploads the file content directly to the returned upload_url via POST /api/v1/files/upload/{token}, bypassing MCP payload size limits. When the server is configured with SOAT_BASE_URL, upload_url is a fully-qualified absolute URL so MCP agents and other clients can POST to it without knowing the server base URL in advance.

Request

Responses

201

Presigned URL created successfully

400

Missing or invalid project

401

Authentication required

403

Insufficient permissions

413

REQUEST_REJECTED — the request body is over the size the body parser accepts

429

QUOTA_EXCEEDED — a requests quota on the calling API key or its project is spent for the window; Retry-After says when it reopens

Response Headers

Retry-After

Seconds until the quota window admits a request again

500

Unexpected server error — INTERNAL_ERROR, with the raw message never forwarded