v1

latestOpenAPI 3.1.1MIT License2026-07-122354100.9 KB
Uploads

Create presigned URL for file upload

Generate a presigned URL for uploading a single file to the specified namespace. Files are limited to 5 MB on the Free plan and 200 MB on paid plans.

post/v1/namespace/{namespaceId}/uploads

Path parameters

namespaceIdstring required

The id of the namespace (prefixed with ns_)

Example:ns_123

The id of the namespace (prefixed with ns_)

Request body

fileNamestring required

File name

contentTypestring required

Content type

fileSizenumber required

File size in bytes. The maximum is 200 MB (5 MB on the Free plan).

Example request

{
  "fileName": "document.pdf",
  "contentType": "application/pdf",
  "fileSize": 1024
}

Response

Presigned URL generated successfully

successtrue required