Air

Import an asset into Air from a source URL. Returns an import task ID, asset ID, version ID, and a canonical `url` for the asset in the Air webapp. Use get_import_status to poll for completion. Always use the returned `url` field — never construct Air URLs manually.

create_import

List assets in the workspace, optionally filtered by board, tags, or search query. Set semantic=true with a search query to rank results by natural-language meaning instead of keyword matching. IMPORTANT: Never construct Air webapp URLs from asset IDs. To get a link to an asset, use the get_asset tool which returns a canonical `url` field.

list_assets

List boards in the workspace, optionally filtered by name or parent board. IMPORTANT: Never construct Air webapp URLs from board IDs. To get a link to a board, use the get_board tool which returns a canonical `url` field.

list_boards

List all boards that contain a specific asset

get_asset_boards

List custom fields defined in the workspace

list_custom_fields

List all assets within a board and all of its nested sub-boards. IMPORTANT: Never construct Air webapp URLs from asset IDs. To get a link to an asset, use the get_asset tool which returns a canonical `url` field.

list_nested_assets

List tags in the workspace, optionally filtered by name

list_tags

List the workspaces the authenticated caller can access. Use this to discover a workspaceId to pass to other tools when no default workspace is configured (e.g. multi-tenant HTTP mode). Requires OAuth bearer auth; not available on the single-workspace API-key path.

list_workspaces

Remove a tag from an asset version. If versionId is not provided, uses the cover version.

remove_tag_from_asset

Rename an asset by updating its display title only. To update description as well, use update_asset instead. Optionally provide a versionId to target a specific version.

rename_asset

Set a custom field value on an asset. For plain-text and date fields use `value`. For single-select and multi-select fields use `values` (array of option ID objects) — or pass the option ID via `value` and the field type will be auto-detected and converted.

update_asset_custom_field

Update mutable fields on an asset's cover version: display title and/or description. Note: only the display title is updated — the underlying fileName is not changed. Optionally provide a versionId to target a specific version.

update_asset

Update mutable fields on a board: title, description, and/or parent board.

update_board

Upload a local file to Air. Provide an absolute file path and the SDK handles the rest (detecting file type, choosing upload strategy). Returns an asset ID, version ID, and a canonical `url` for the asset in the Air webapp. Always use the returned `url` field — never construct Air URLs manually.

upload_asset