v1

latestOpenAPI 3.1.0Proprietary2026-07-173298155.5 KB
Files

Files - request an upload URL

Returns a pre-signed URL for uploading a file via PUT.

post/api/v1/files/upload

Request body

filenamestring required

Original filename including extension (e.g. 'part.step', 'model.obj'). Used for display and format detection.

contentTypestring required

MIME type of the file (e.g. 'application/step', 'model/gltf-binary'). Must match the actual file content.

bytesinteger required

Exact file size in bytes. Must match the Content-Length of the subsequent PUT to the upload URL. Maximum: 1 GB.

sha256string

SHA-256 hex digest of the file content. When provided, enables server-side deduplication - if an identical file was previously uploaded under this API key, the existing file is reused and no upload is needed.

Response

Upload URL and file ID

oktrue required