Air icon

Air

Access, update, and manage assets, boards, custom fields, and tags in your Air workspace

Actions24

Upload → Initiate Upload

AI-generated

Summary

Initiates a multipart upload in Air by sending file metadata to POST /uploads. Use the returned upload details to request signed URLs for file parts, upload them, and complete the upload.

Inputs

  • Extension (required) — File extension without a dot, such as jpg, png, or pdf.
  • MIME Type (required) — File MIME type, such as image/jpeg or application/pdf.
  • File Size (Bytes) (required) — Total file size in bytes; the UI specifies a minimum of 1.
  • File Name — Optional name to store with the asset; an empty value is omitted from the request.
  • Recorded At — ISO timestamp for when the asset was recorded. Defaults to the current time; an empty value is omitted.
  • Parent Board ID — Optional board ID to place the asset in; an empty value is omitted.
  • Asset ID — Optional existing asset ID to add a new version to; an empty value is omitted.

Output shape

A single response item from the Air API containing the initiated upload details.

The source defines the request but no custom response transformation, so exact response fields depend on Air's API. This operation initiates the multipart upload; it does not upload file data or complete the upload.

Links

Discussion