> ## Documentation Index
> Fetch the complete documentation index at: https://docs.superlaunch.pro/llms.txt
> Use this file to discover all available pages before exploring further.

# Accounts, assets, and brands

> Resolve Superlaunch account and brand IDs before reading or changing objects.

Resolve Superlaunch account and brand IDs before reading or changing objects. Asset IDs identify provider objects; account IDs identify Superlaunch records.

The tables list arguments and common nested fields. Expand **Full input schema** for all fields and allowed values. Workspace and account permissions apply to every tool.

<span id="ad-accounts-list" />

## ad\_accounts\_list

List ad accounts the current user may read.

**Access:** `mcp:read`.

| Parameter | Type | Required / default | Details |
| - | - | - | - |
| `limit` | integer | `25` | |

<Accordion title="Full input schema">
  ```json theme={null}
  {
    "additionalProperties": false,
    "properties": {
      "limit": {
        "default": 25,
        "type": "integer"
      }
    },
    "type": "object"
  }
  ```
</Accordion>

<span id="ad-accounts-get" />

## ad\_accounts\_get

Read one authorized ad account.

**Access:** `mcp:read`.

| Parameter | Type | Required / default | Details |
| - | - | - | - |
| `ad_account_id` | uuid | Required | Superlaunch account UUID from `ad_accounts_list`. |

<Accordion title="Full input schema">
  ```json theme={null}
  {
    "additionalProperties": false,
    "properties": {
      "ad_account_id": {
        "format": "uuid",
        "type": "string"
      }
    },
    "required": [
      "ad_account_id"
    ],
    "type": "object"
  }
  ```
</Accordion>

<span id="brands-list" />

## brands\_list

List brands the current user may read.

**Access:** `mcp:read`.

| Parameter | Type | Required / default | Details |
| - | - | - | - |
| `limit` | integer | `25` | |

<Accordion title="Full input schema">
  ```json theme={null}
  {
    "additionalProperties": false,
    "properties": {
      "limit": {
        "default": 25,
        "type": "integer"
      }
    },
    "type": "object"
  }
  ```
</Accordion>

<span id="brands-create" />

## brands\_create

Create a brand profile and grant its creator write access. Optional fields include website, industry, description, markets, and languages. Assign ad accounts separately.

**Access:** `mcp:read` and `mcp:write`.

| Parameter | Type | Required / default | Details |
| - | - | - | - |
| `payload` | object | Required | Create a workspace brand; reuse request\_id only for identical retries. |

### payload fields

| Parameter | Type | Required / default | Details |
| - | - | - | - |
| `request_id` | uuid | Required | UUID for this operation; use a new UUID for changed inputs. |
| `name` | string | Required | minLength: `1`. maxLength: `200`. pattern: `\S`. |
| `website` | string or null | `null` | |
| `industry` | string or null | `null` | |
| `description` | string or null | `null` | |
| `markets` | array of string | Optional | maxItems: `50`. |
| `languages` | array of string | Optional | maxItems: `50`. |

**Retries:** reuse the same `request_id` with unchanged inputs for the same operation.

<Accordion title="Full input schema">
  ```json theme={null}
  {
    "$defs": {
      "BrandCreate": {
        "additionalProperties": false,
        "description": "Create a workspace brand; reuse request_id only for identical retries.",
        "properties": {
          "request_id": {
            "format": "uuid",
            "type": "string"
          },
          "name": {
            "$ref": "#/$defs/BrandName"
          },
          "website": {
            "anyOf": [
              {
                "maxLength": 500,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null
          },
          "industry": {
            "anyOf": [
              {
                "maxLength": 200,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null
          },
          "description": {
            "anyOf": [
              {
                "maxLength": 10000,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null
          },
          "markets": {
            "items": {
              "$ref": "#/$defs/BrandLabel"
            },
            "maxItems": 50,
            "type": "array"
          },
          "languages": {
            "items": {
              "$ref": "#/$defs/BrandLabel"
            },
            "maxItems": 50,
            "type": "array"
          }
        },
        "required": [
          "request_id",
          "name"
        ],
        "type": "object"
      },
      "BrandLabel": {
        "maxLength": 100,
        "minLength": 1,
        "pattern": "\\S",
        "type": "string"
      },
      "BrandName": {
        "maxLength": 200,
        "minLength": 1,
        "pattern": "\\S",
        "type": "string"
      }
    },
    "additionalProperties": false,
    "properties": {
      "payload": {
        "$ref": "#/$defs/BrandCreate"
      }
    },
    "required": [
      "payload"
    ],
    "type": "object"
  }
  ```
</Accordion>

<span id="brands-update" />

## brands\_update

Update selected profile or brand-kit fields. Omitted fields keep their values; empty lists clear markets or languages. A kit change saves a new version. Supply `kit.positioning` when creating the first kit.

**Access:** `mcp:read` and `mcp:write`.

| Parameter | Type | Required / default | Details |
| - | - | - | - |
| `brand_id` | uuid | Required | Brand UUID from `brands_list`. |
| `payload` | object | Required | Partially update a brand; reuse request\_id only for identical retries. |

### payload fields

| Parameter | Type | Required / default | Details |
| - | - | - | - |
| `request_id` | uuid | Required | UUID for this operation; use a new UUID for changed inputs. |
| `name` | string or null | `null` | |
| `website` | string or null | `null` | |
| `industry` | string or null | `null` | |
| `description` | string or null | `null` | |
| `markets` | array of string or null | `null` | |
| `languages` | array of string or null | `null` | |
| `kit` | object or null | `null` | Brand messaging, voice, colors, and typography. |

**Retries:** reuse the same `request_id` with unchanged inputs for the same operation.

<Accordion title="Full input schema">
  ```json theme={null}
  {
    "$defs": {
      "BrandKitColor": {
        "additionalProperties": false,
        "description": "One semantic color in a brand palette.",
        "properties": {
          "role": {
            "enum": [
              "primary",
              "secondary",
              "accent",
              "background",
              "text"
            ],
            "type": "string"
          },
          "name": {
            "maxLength": 80,
            "minLength": 1,
            "type": "string"
          },
          "hex": {
            "pattern": "^#[0-9A-Fa-f]{6}$",
            "type": "string"
          }
        },
        "required": [
          "role",
          "name",
          "hex"
        ],
        "type": "object"
      },
      "BrandKitPositioning": {
        "maxLength": 300,
        "minLength": 1,
        "type": "string"
      },
      "BrandKitTagline": {
        "maxLength": 160,
        "type": "string"
      },
      "BrandKitTypographyUpdate": {
        "additionalProperties": false,
        "description": "Partial primary brand typeface update; null clears a font.",
        "properties": {
          "heading_font": {
            "anyOf": [
              {
                "maxLength": 120,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null
          },
          "body_font": {
            "anyOf": [
              {
                "maxLength": 120,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null
          }
        },
        "type": "object"
      },
      "BrandKitUpdate": {
        "additionalProperties": false,
        "description": "Partial versioned kit update; omitted fields retain their current values.",
        "properties": {
          "positioning": {
            "anyOf": [
              {
                "$ref": "#/$defs/BrandKitPositioning"
              },
              {
                "type": "null"
              }
            ],
            "default": null
          },
          "tagline": {
            "anyOf": [
              {
                "$ref": "#/$defs/BrandKitTagline"
              },
              {
                "type": "null"
              }
            ],
            "default": null
          },
          "colors": {
            "anyOf": [
              {
                "items": {
                  "$ref": "#/$defs/BrandKitColor"
                },
                "maxItems": 5,
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "default": null
          },
          "typography": {
            "anyOf": [
              {
                "$ref": "#/$defs/BrandKitTypographyUpdate"
              },
              {
                "type": "null"
              }
            ],
            "default": null
          },
          "voice": {
            "anyOf": [
              {
                "$ref": "#/$defs/BrandKitVoiceUpdate"
              },
              {
                "type": "null"
              }
            ],
            "default": null
          },
          "proof_points": {
            "anyOf": [
              {
                "items": {
                  "type": "string"
                },
                "maxItems": 3,
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "default": null
          }
        },
        "type": "object"
      },
      "BrandKitVoiceUpdate": {
        "additionalProperties": false,
        "description": "Partial brand voice update; empty traits clear and null clears guidance.",
        "properties": {
          "traits": {
            "anyOf": [
              {
                "items": {
                  "type": "string"
                },
                "maxItems": 5,
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "default": null
          },
          "guidance": {
            "anyOf": [
              {
                "maxLength": 500,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null
          }
        },
        "type": "object"
      },
      "BrandLabel": {
        "maxLength": 100,
        "minLength": 1,
        "pattern": "\\S",
        "type": "string"
      },
      "BrandName": {
        "maxLength": 200,
        "minLength": 1,
        "pattern": "\\S",
        "type": "string"
      },
      "BrandUpdate": {
        "additionalProperties": false,
        "description": "Partially update a brand; reuse request_id only for identical retries.",
        "properties": {
          "request_id": {
            "format": "uuid",
            "type": "string"
          },
          "name": {
            "anyOf": [
              {
                "$ref": "#/$defs/BrandName"
              },
              {
                "type": "null"
              }
            ],
            "default": null
          },
          "website": {
            "anyOf": [
              {
                "maxLength": 500,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null
          },
          "industry": {
            "anyOf": [
              {
                "maxLength": 200,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null
          },
          "description": {
            "anyOf": [
              {
                "maxLength": 10000,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null
          },
          "markets": {
            "anyOf": [
              {
                "items": {
                  "$ref": "#/$defs/BrandLabel"
                },
                "maxItems": 50,
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "default": null
          },
          "languages": {
            "anyOf": [
              {
                "items": {
                  "$ref": "#/$defs/BrandLabel"
                },
                "maxItems": 50,
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "default": null
          },
          "kit": {
            "anyOf": [
              {
                "$ref": "#/$defs/BrandKitUpdate"
              },
              {
                "type": "null"
              }
            ],
            "default": null
          }
        },
        "required": [
          "request_id"
        ],
        "type": "object"
      }
    },
    "additionalProperties": false,
    "properties": {
      "brand_id": {
        "format": "uuid",
        "type": "string"
      },
      "payload": {
        "$ref": "#/$defs/BrandUpdate"
      }
    },
    "required": [
      "brand_id",
      "payload"
    ],
    "type": "object"
  }
  ```
</Accordion>

<span id="brands-get" />

## brands\_get

Read one authorized brand with its active structured brand kit.

**Access:** `mcp:read`.

| Parameter | Type | Required / default | Details |
| - | - | - | - |
| `brand_id` | uuid | Required | Brand UUID from `brands_list`. |

<Accordion title="Full input schema">
  ```json theme={null}
  {
    "additionalProperties": false,
    "properties": {
      "brand_id": {
        "format": "uuid",
        "type": "string"
      }
    },
    "required": [
      "brand_id"
    ],
    "type": "object"
  }
  ```
</Accordion>

<span id="assets-list" />

## assets\_list

List a page of campaigns, ad sets, ads, or creatives for an account.

**Access:** `mcp:read`.

| Parameter | Type | Required / default | Details |
| - | - | - | - |
| `ad_account_id` | uuid | Required | Superlaunch account UUID from `ad_accounts_list`. |
| `level` | campaign, adset, ad, creative | Required | Asset level: campaign, ad set, ad, or creative. |
| `limit` | integer | `25` | minimum: `1`. maximum: `200`. |
| `cursor` | string or null | `null` | |

<Accordion title="Full input schema">
  ```json theme={null}
  {
    "$defs": {
      "AssetCursor": {
        "anyOf": [
          {
            "pattern": "^[0-9]+$",
            "type": "string"
          },
          {
            "type": "null"
          }
        ]
      },
      "AssetLevel": {
        "enum": [
          "campaign",
          "adset",
          "ad",
          "creative"
        ],
        "type": "string"
      },
      "AssetLimit": {
        "maximum": 200,
        "minimum": 1,
        "type": "integer"
      }
    },
    "additionalProperties": false,
    "properties": {
      "ad_account_id": {
        "format": "uuid",
        "type": "string"
      },
      "level": {
        "$ref": "#/$defs/AssetLevel"
      },
      "limit": {
        "$ref": "#/$defs/AssetLimit",
        "default": 25
      },
      "cursor": {
        "$ref": "#/$defs/AssetCursor",
        "default": null,
        "type": [
          "string",
          "null"
        ]
      }
    },
    "required": [
      "ad_account_id",
      "level"
    ],
    "type": "object"
  }
  ```
</Accordion>

<span id="assets-get" />

## assets\_get

Read one campaign, ad set, ad, or creative from the imported account data.

**Access:** `mcp:read`.

| Parameter | Type | Required / default | Details |
| - | - | - | - |
| `asset_id` | string | Required | Provider object ID returned by `assets_list`. |
| `ad_account_id` | uuid | Required | Superlaunch account UUID from `ad_accounts_list`. |

<Accordion title="Full input schema">
  ```json theme={null}
  {
    "additionalProperties": false,
    "properties": {
      "asset_id": {
        "type": "string"
      },
      "ad_account_id": {
        "format": "uuid",
        "type": "string"
      }
    },
    "required": [
      "asset_id",
      "ad_account_id"
    ],
    "type": "object"
  }
  ```
</Accordion>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.