Upload File

Destination drive folder (fld_... or a bare folder UUID). The file adopts the folder's visibility, exactly like an in-app upload into that folder. An unknown or inaccessible folder is a 404 folder_not_found; a folder you can see but not edit, or a read-only namespace (Skills, Brand Kits), is a 403 folder_write_denied; brand-kit-managed folders are a 403 brand_kit_folder_protected. Omit to land unfiled (library root).

voice_source marks a transient recording: the seed of POST /v1/voices/similar or the source_audio of a speech-to-speech take. It always gets its own file (never a duplicate of one you already have, and never handed to another upload of the same bytes), stays out of My Media, and Moda deletes it 24 hours later (expires_at) unless a canvas, brand kit or other surface references it by then. Delete it yourself with DELETE /v1/drive/items/{id} once used. Omit for an ordinary, permanent upload.

Unique file identifier (prefixed file_...).

Stable proxy URL for the uploaded file. Use this in attachment URLs.

Filename of the uploaded file.

MIME type of the file.

File size in bytes.

True if an identical file already existed (deduplicated).

Prefixed fld_ wire ID (Crockford base32 body) — the canonical, recommended form. For back-compat, a bare UUID string is also accepted in both path parameters and JSON request bodies (older integrations that stored raw UUIDs keep working), as is the prefix over a UUID body (fld_00000000-0000-4000-8000-000000000000). All three are permanent, supported inputs; only the canonical form is ever emitted.

ISO 8601 UTC time after which Moda deletes this transient upload (purpose voice_source), or null for a file that never expires.