v3

OpenAPI 3.1.0Proprietary2026-07-31692196.8 KB

Assets

Initialize an asset upload

Creates a pending asset and returns presigned upload URL(s). Files at or below the single-PUT threshold get one PUT URL; larger files get multipart part URLs. If a ready asset with the same checksum already exists, the existing asset is returned (deduplicated).

post/assets

Request body

filenamestring required

Original filename

sizeinteger required

File size in bytes

contentTypestring

MIME content type

checksumstring

Client-declared sha256 (enables dedup)

lifecycle'ephemeral' | 'persisted'

Storage lifecycle (defaults to ephemeral)

Response

Deduplicated — a ready asset with this checksum already exists

statusstring required

presigned | multipart | deduplicated

{"stackTrail":"paths:/assets:post:responses:200:content:application/json:schema:properties:upload","oasType":"schema","type":"unknown","description":"Presigned PUT URL or multipart part URLs"}