AirInstall

Summary

Import a new Air asset, or add a version to an existing asset, by having Air fetch a file from a publicly accessible URL. You can optionally set its name, extension, description, recorded timestamp, destination board, tags, and custom field values.

Inputs

• Source URL (required) — Publicly accessible URL Air fetches the file from.
• File Name — Optional name to store with the asset.
• Extension — File extension without a dot, such as jpg, mp4, or pdf.
• Description — Optional file description.
• Recorded At — Optional ISO timestamp for when the asset was recorded or created.
• Parent Board ID — Optional board to import the asset into.
• Asset ID — Optional existing asset ID to add a new version to.
• Tag IDs (Comma-Separated) — Existing tag IDs to apply. Separate IDs with commas; they are sent as tag objects.
• Custom Fields — Add one or more fields by custom field ID. Use Value for plain text or date fields, or comma-separated Value IDs for select fields. If both are supplied, Value IDs take precedence; entries without either value send only the field ID.

Output shape

A single API response item describing the import.

The request is sent to Air's POST /imports endpoint. The operation starts an import; use Import → Get Status with the returned import ID to check its status. Empty optional values are omitted.

Links

• n8n community nodes installation guide