AirOps

Tools 88

• Manage Brand Kit Content Sample

  Create or update a content sample for a Brand Kit. Omit `id` to create a new content sample; provide `id` to update an existing one. On create, provide either `url` (content will be extracted asynchronously) or `content` (plain text, stored immediately). On update, only `content`, `url`, `audience_ids`, and `region_ids` can be changed. This tool edits the Brand Kit draft version only; it does not change the active (live) version. IMPORTANT: Always show the user exactly which fields will be created or changed and ask for confirmation before calling this tool.

• Manage Brand Kit Content Type

  Create or update a content type for a Brand Kit. Omit `id` to create a new content type; provide `id` to update an existing one. On create, you may provide a `sample_url` to seed the content type with a content sample: - If only `sample_url` is provided (no content fields), the system will scrape the URL and use AI to generate all content type fields automatically. - If `sample_url` is provided along with content fields, the URL will be scraped for reference but the provided field values will be kept as-is. - If no `sample_url` is provided, the content type is created with the given fields only. On update, only provided fields are changed and `sample_url` is ignored. This tool edits the Brand Kit draft version only; it does not change the active (live) version. IMPORTANT: Always show the user exactly which fields will be created or changed and ask for confirmation before calling this tool.

• Manage Brand Kit Custom Variable

  Before creating a custom variable, you MUST analyze the user's intent and suggest the appropriate Brand Kit dimension instead. Map the request to these alternatives first: - Region + Writing Rule: For location/language-specific instructions (e.g., "US writing tone", "UK spelling") - Audience + Writing Rule: For audience-specific guidelines (e.g., "developer tone", "enterprise style") - Content Type: For format-specific rules (e.g., "blog post structure", "email CTA") - Writing Rule (global): For general writing guidelines - Writing Tone / Writing Persona: For overall voice and style Create or update a custom variable for a Brand Kit. Omit `id` to create a new custom variable; provide `id` to update an existing one. On create, `name` and `value` are required. On update, only provided fields are changed. This tool edits the Brand Kit draft version only; it does not change the active (live) version. IMPORTANT: Always show the user exactly which fields will be created or changed and ask for confirmation before calling this tool.

• Suggest Brand Kit Edits

  Suggest edits to a Brand Kit's fields without applying them. Returns a comparison of current vs suggested values for user review. The user will see a UI to accept or reject each suggestion before changes are applied. Only include fields you want to suggest changes for. Call this tool once per entity (e.g. once per audience, once per content type). Supported entity types and their fields: - brand_kit: brand_name, brand_url, brand_about, writing_persona, writing_tone - audience: name, description - content_type: name, template_outline, cta_text, cta_url, header_case, header_case_custom_value - product_line: name, details, positioning, ideal_customer_profile, url - region: name, description, icon_name (flag code in format flag-{iso2}, e.g. flag-us, flag-gb, flag-br) - writing_rule: text, region_id (create only), content_type_id (create only), audience_id (create only) - competitor: name, domain, details, product_line_ids - content_sample: url (create only), content_type_id (create only), content (update only), audience_ids, region_ids - custom_variable: name, value - logo_variant: name, background_color, usage_instructions (to upload a logo image use manage_brand_kit_logo_variant directly with file_url) - logo_size: name, width, height, usage_instructions - font: name, usage_instructions, google_font_link, file_url (publicly accessible URL to a font file) - type_size: name, weight, size, line_height, usage_instructions - palette: name

• Manage Brand Kit Font

  Create or update a font for a Brand Kit. Omit `id` to create a new font; provide `id` to update an existing one. On update, only provided fields are changed. To attach a font file, either: - Use `signed_id` with the token from create_brand_kit_direct_upload after direct upload (preferred). - Use `file_url` with a publicly accessible URL to a font file (TTF, OTF, WOFF, WOFF2, or EOT). Alternatively, provide `google_font_link` with a Google Fonts URL. This tool edits the Brand Kit draft version only; it does not change the active (live) version. IMPORTANT: Always show the user exactly which fields will be created or changed and ask for confirmation before calling this tool.

• Manage Brand Kit Logo Size

  Create or update a logo size for a Brand Kit. Omit `id` to create a new logo size; provide `id` to update an existing one. On update, only provided fields are changed. At least one of `width` or `height` must be provided on create. This tool edits the Brand Kit draft version only; it does not change the active (live) version. IMPORTANT: Always show the user exactly which fields will be created or changed and ask for confirmation before calling this tool.

• Manage Brand Kit Logo Variant

  Create or update a logo variant for a Brand Kit. Omit `id` to create a new logo variant; provide `id` to update an existing one. On update, only provided fields are changed. To attach a logo image, either: - Use `signed_id` with the token from create_brand_kit_direct_upload after direct upload (preferred). - Use `file_url` with a publicly accessible URL to a PNG or SVG image. Always provide `usage_instructions` when creating a logo variant — describe when and how to use this logo (e.g. "Primary logo for light backgrounds", "Monochrome version for print materials"). This tool edits the Brand Kit draft version only; it does not change the active (live) version. IMPORTANT: Always show the user exactly which fields will be created or changed and ask for confirmation before calling this tool.

• Manage Brand Kit Palette Color

  Create or update a color within a Brand Kit palette. Omit `id` to create a new color; provide `id` to update an existing one. On create, `palette_id` is required. On update, only provided fields are changed. This tool edits the Brand Kit draft version only; it does not change the active (live) version. IMPORTANT: Always show the user exactly which fields will be created or changed and ask for confirmation before calling this tool.

• Manage Brand Kit Palette

  Create or update a color palette for a Brand Kit. Omit `id` to create a new palette; provide `id` to update an existing one. On update, only provided fields are changed. This tool edits the Brand Kit draft version only; it does not change the active (live) version. IMPORTANT: Always show the user exactly which fields will be created or changed and ask for confirmation before calling this tool.

• Manage Brand Kit Product Line

  Create or update a product line for a Brand Kit. Omit `id` to create a new product line; provide `id` to update an existing one. On update, only provided fields are changed. This tool edits the Brand Kit draft version only; it does not change the active (live) version. IMPORTANT: Always show the user exactly which fields will be created or changed and ask for confirmation before calling this tool.

• Manage Brand Kit Type Size

  Create or update a type size for a Brand Kit. Omit `id` to create a new type size; provide `id` to update an existing one. On update, only provided fields are changed. This tool edits the Brand Kit draft version only; it does not change the active (live) version. IMPORTANT: Always show the user exactly which fields will be created or changed and ask for confirmation before calling this tool.

• Update Brand Kit

  Update a Brand Kit's base fields. Only provided fields are changed. Use get_brand_kit first to see current values. Updatable fields include brand identity (name, URL, about) and writing style (persona, tone). This tool edits the Brand Kit draft version only; it does not change the active (live) version. IMPORTANT: Always show the user exactly which fields will be changed and ask for confirmation before calling this tool.