Upload File

Upload a file once and get back a file_* reference id you can reuse across generations.

The same reference can be passed to realtime set_image as image_ref, avoiding a re-upload of the underlying bytes on every call.

post/v1/files

Request

The document declares no server URL.
Auth
none required
TypeScript
https://skmtc.dev/decart/apis/decart-api/docs/v1/files/post.ts
A function with typed inputs. Its response is checked against the schema.

x-api-keystring required

API key for authentication

User-Agentstring nullable

filestring binary required

File to upload

ttl_secondsstring nullable

TTL in seconds (60..2_592_000), or "persistent" for no expiry. Omit for the platform default (24h).

Successful Response

idstring required

filenamestring nullable required

mime_typestring required

size_bytesinteger required

created_atstring date-time required

expires_atstring date-time nullable required

No recorded changes to this operation across all 1 revision of this API.