Air

Get detailed information about a specific asset including its cover version, custom fields, and metadata. The response includes a `url` field with the canonical Air webapp link — always use this instead of constructing URLs manually. If listing the asset's boards is forbidden, `url` is the All-assets link.

get_asset

Get a temporary download URL for a specific asset version. If versionId is not provided, uses the cover version.

get_asset_download_url

Get an inline image preview of an asset. Returns the image as base64-encoded image content that MCP clients can render directly.

get_asset_image

Get one version of an asset, including its file details, tags, smart tags, preview URLs, and metadata. The response includes a `url` field with the canonical Air webapp link for that version — always use this instead of constructing URLs manually. If listing the asset's boards is forbidden, `url` is the All-assets link for that version.

get_asset_version

Get detailed information about a specific board. The response includes a `url` field with the canonical Air webapp link.

get_board

Get detailed information about a specific custom field, including its type and possible values

get_custom_field

Check the status of an import task. Status will be one of: pending, inProgress, succeeded, failed. If failed, an error object with type and message is included.

get_import_status

Get a library by id, including its title, description, accessibility, and visibility. The response includes a `url` field with the canonical Air webapp link.

get_library

Import an asset into Air from a source URL. Air fetches the URL itself, so it must point directly at the file and be reachable from the internet; a share page such as a Google Drive or Dropbox link returns a web page, not the file. 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. This connection cannot read files on the user's computer, so create_import is the only way to add new assets here. Local files are uploaded in the Air web app.

create_import

List CDN links for an asset. Each link includes its public url, whether it follows the asset's current default version, and whether it is active. The response is `{ data }` for the newest 100 links. Use create_cdn_link to add one and update_cdn_link to turn one on or off.

list_cdn_links

List public share links for an asset. `url` is the public share link to give to people. It is not an Air webapp link and not a CDN link. A link is usable when `active` is true and `expiresAt` is null or in the future; an expired link can still be `active: true`. Disabled links are included (`active: false`). The password is never returned. `hasPassword` says whether one is set, and `requireAccount` says whether the recipient must sign in. Tell the recipient when a password or an Air account is required. An asset can have several links: one that follows the current version (`followsDefaultVersion: true`) and one per pinned version (`followsDefaultVersion: false` with `versionId`). A pinned link follows the file, not the version number. The response is `{ data, pagination, total }`. The API defaults limit to 12 and caps it at 200. Use create_asset_share_link to add one and update_asset_share_link to change it.

list_asset_share_links

List every version of an asset. The response is `{ data, total }` for the full version stack. IMPORTANT: Never construct Air webapp URLs from version IDs. To get a link to a specific version, use the get_asset_version tool which returns a canonical `url` field.

list_asset_versions

List assets in the workspace, optionally filtered by board, tags, custom fields, or search query. customField filters select options, plain text (text, textPrefix, textNot), and dates (dateGte, dateLte). 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 the public share link for a board. A board has zero or one link, so `data` is empty or holds that single link. `url` is the public share link to give to people. It is not an Air webapp link and not a CDN link. A link is usable when `active` is true and `expiresAt` is null or in the future; an expired link can still be `active: true`. Disabled links are included (`active: false`). The password is never returned. `hasPassword` says whether one is set, and `requireAccount` says whether the recipient must sign in. Tell the recipient when a password or an Air account is required. A parent board can pass a password down, so `hasPassword` can be true on a link created without one. The response is `{ data, pagination, total }`. Use create_board_share_link to add one and update_board_share_link to change it.

list_board_share_links

List boards in the workspace, optionally filtered by name, parent board, or library. `libraryId` and `inGeneralLibrary` cannot be used together. 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 libraries in the workspace. `search` is a text search over library title and description.

list_libraries

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 an asset from a board. The asset stays in the workspace.

remove_asset_from_board

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. Provide exactly one of `value` or `values`; pass `null` to clear. 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. If the select option does not exist yet, call add_custom_field_option first and use the returned option id.

update_asset_custom_field

Set a custom field value on a board. Provide exactly one of `value` or `values`; pass `null` to clear. 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. If the select option does not exist yet, call add_custom_field_option first and use the returned option id. Passing a single option id on a multi-select replaces the whole selection.

set_board_custom_field

Activate or deactivate a CDN link. Set active to false to stop the public URL from serving the file, or true to turn it back on. The link id comes from list_cdn_links or create_cdn_link.

update_cdn_link

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 an asset share link. The link id comes from list_asset_share_links or create_asset_share_link. Set active to false to stop a link people already have, or true to turn it back on. Ask the person before setting active to true on a link that is off. allowDownload controls single-file download only; download-all is not exposed. showAllVersions controls whether visitors can see every version. Provide at least one setting. Omitted fields stay unchanged. A pinned link follows the file, not the version number. Returns the link after the change. `url` is the public share link to give to people. It is not an Air webapp link and not a CDN link. A link is usable when `active` is true and `expiresAt` is null or in the future; an expired link can still be `active: true`. Disabled links are included (`active: false`). The password is never returned. `hasPassword` says whether one is set, and `requireAccount` says whether the recipient must sign in. Tell the recipient when a password or an Air account is required.

update_asset_share_link

Update a board's title, description, and/or parent. This tool cannot set `libraryId` directly. Changing `parentBoardId` can move the board into or out of a library.

update_board

Update a board share link. The link id comes from list_board_share_links or create_board_share_link. Set active to false to stop a link people already have, or true to turn it back on. Ask the person before setting active to true on a link that is off. allowDownload controls single-file download only; download-all is not exposed. Provide at least one setting. Omitted fields stay unchanged. A parent board can pass a password down, so `hasPassword` can stay true when this request sends no password. Returns the link after the change. `url` is the public share link to give to people. It is not an Air webapp link and not a CDN link. A link is usable when `active` is true and `expiresAt` is null or in the future; an expired link can still be `active: true`. Disabled links are included (`active: false`). The password is never returned. `hasPassword` says whether one is set, and `requireAccount` says whether the recipient must sign in. Tell the recipient when a password or an Air account is required.

update_board_share_link

Rename a custom field or change its description. Does not change the field type or its options. Use update_custom_field_option to rename an option.

update_custom_field

Rename an existing option on a single-select or multi-select custom field. Pass the option id from get_custom_field or add_custom_field_option and the new name. Assets and boards that already use this option keep the same option id and show the new name.

update_custom_field_option

Update a library's title, description, accessibility, or visibility. `accessibility` is who can join. `visibility` is who can see the library. Title must stay unique in the workspace. Does not delete the library.

update_library