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

# Complete a workspace brand

> Adds missing data. Existing names, logos, colors, taglines and assets are preserved. Disagreements are returned in conflicts. Repeating the same additions is safe. Requires a current workspace editor or admin. Supply user, brand_book or web as the source. Prefer the official brand book. Web research requires userConfirmed set to true after confirmation. Logos and distinctive assets accept this workspace's PNG, JPEG, GIF or WebP uploads up to 8 MB. Returns the saved brand, readiness and checks available for applicable pre-tests.

Requires the `brands:write` scope.



## OpenAPI

````yaml /api-reference/openapi.json patch /brands/{id}
openapi: 3.1.0
info:
  title: Unite API
  version: 1.0.0
  description: >-
    Run Ad Score pre-tests from your own systems: upload a creative, create a
    pre-test, and read its result and PDF report. The Ad Score routes are under
    /adscore and need the adscore:read or adscore:write scope; uploads and
    webhook endpoints are shared by every product and stay at the root. Every
    request needs an API key sent as a Bearer token. Every response carries an
    X-Request-Id header.
servers:
  - url: https://myunite.ai/api/v1
security:
  - bearerAuth: []
tags:
  - name: Catalog
    description: What you can send when you create a pre-test.
  - name: Uploads
    description: Send creative files and brand assets.
  - name: Brands
    description: Create and complete brands for your workspace.
  - name: Pretests
    description: Create pre-tests and read their results.
  - name: Quota
    description: How many pre-tests you can still run.
  - name: Create
    description: Generate and edit images, videos and music, and read what was generated.
  - name: Webhooks
    description: Manage the endpoints that are notified when a pre-test changes.
paths:
  /brands/{id}:
    patch:
      tags:
        - Brands
      summary: Complete a workspace brand
      description: >-
        Adds missing data. Existing names, logos, colors, taglines and assets
        are preserved. Disagreements are returned in conflicts. Repeating the
        same additions is safe. Requires a current workspace editor or admin.
        Supply user, brand_book or web as the source. Prefer the official brand
        book. Web research requires userConfirmed set to true after
        confirmation. Logos and distinctive assets accept this workspace's PNG,
        JPEG, GIF or WebP uploads up to 8 MB. Returns the saved brand, readiness
        and checks available for applicable pre-tests.


        Requires the `brands:write` scope.
      operationId: updateBrand
      parameters:
        - name: id
          in: path
          required: true
          description: The workspace brand id.
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateBrandRequest'
      responses:
        '200':
          description: The saved brand and its readiness.
          headers:
            X-Request-Id:
              $ref: '#/components/headers/X-Request-Id'
            RateLimit-Limit:
              $ref: '#/components/headers/RateLimit-Limit'
            RateLimit-Remaining:
              $ref: '#/components/headers/RateLimit-Remaining'
            RateLimit-Reset:
              $ref: '#/components/headers/RateLimit-Reset'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BrandResult'
        '400':
          description: 'Error. Possible codes: invalid_request.'
          headers:
            X-Request-Id:
              $ref: '#/components/headers/X-Request-Id'
            RateLimit-Limit:
              $ref: '#/components/headers/RateLimit-Limit'
            RateLimit-Remaining:
              $ref: '#/components/headers/RateLimit-Remaining'
            RateLimit-Reset:
              $ref: '#/components/headers/RateLimit-Reset'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: >-
            Error. Possible codes: invalid_api_key, api_key_revoked,
            api_key_expired.
          headers:
            X-Request-Id:
              $ref: '#/components/headers/X-Request-Id'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: >-
            Error. Possible codes: feature_not_enabled, key_owner_not_member,
            insufficient_scope, insufficient_role.
          headers:
            X-Request-Id:
              $ref: '#/components/headers/X-Request-Id'
            RateLimit-Limit:
              $ref: '#/components/headers/RateLimit-Limit'
            RateLimit-Remaining:
              $ref: '#/components/headers/RateLimit-Remaining'
            RateLimit-Reset:
              $ref: '#/components/headers/RateLimit-Reset'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: 'Error. Possible codes: brand_not_found, upload_not_found.'
          headers:
            X-Request-Id:
              $ref: '#/components/headers/X-Request-Id'
            RateLimit-Limit:
              $ref: '#/components/headers/RateLimit-Limit'
            RateLimit-Remaining:
              $ref: '#/components/headers/RateLimit-Remaining'
            RateLimit-Reset:
              $ref: '#/components/headers/RateLimit-Reset'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '422':
          description: >-
            Error. Possible codes: invalid_request, confirmation_required,
            upload_invalid, file_too_large.
          headers:
            X-Request-Id:
              $ref: '#/components/headers/X-Request-Id'
            RateLimit-Limit:
              $ref: '#/components/headers/RateLimit-Limit'
            RateLimit-Remaining:
              $ref: '#/components/headers/RateLimit-Remaining'
            RateLimit-Reset:
              $ref: '#/components/headers/RateLimit-Reset'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: 'Error. Possible codes: rate_limited.'
          headers:
            X-Request-Id:
              $ref: '#/components/headers/X-Request-Id'
            RateLimit-Limit:
              $ref: '#/components/headers/RateLimit-Limit'
            RateLimit-Remaining:
              $ref: '#/components/headers/RateLimit-Remaining'
            RateLimit-Reset:
              $ref: '#/components/headers/RateLimit-Reset'
            Retry-After:
              $ref: '#/components/headers/Retry-After'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: 'Error. Possible codes: internal_error.'
          headers:
            X-Request-Id:
              $ref: '#/components/headers/X-Request-Id'
            RateLimit-Limit:
              $ref: '#/components/headers/RateLimit-Limit'
            RateLimit-Remaining:
              $ref: '#/components/headers/RateLimit-Remaining'
            RateLimit-Reset:
              $ref: '#/components/headers/RateLimit-Reset'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    UpdateBrandRequest:
      type: object
      properties:
        source:
          type: string
          enum:
            - user
            - brand_book
            - web
        userConfirmed:
          type: boolean
        name:
          type: string
          minLength: 2
          maxLength: 180
        colors:
          minItems: 1
          maxItems: 64
          type: array
          items:
            type: string
            pattern: ^#(?:[a-f0-9]{3}|[a-f0-9]{6})$
        taglines:
          minItems: 1
          maxItems: 32
          type: array
          items:
            type: string
            minLength: 2
            maxLength: 180
        logoUploadId:
          type: string
          pattern: ^upl_[a-f0-9]{32}\.(png|jpg|webp|gif|mp4|mov)$
        distinctiveAssets:
          minItems: 1
          maxItems: 8
          type: array
          items:
            type: object
            properties:
              uploadId:
                type: string
                pattern: ^upl_[a-f0-9]{32}\.(png|jpg|webp|gif|mp4|mov)$
              description:
                type: string
                minLength: 1
                maxLength: 1000
            required:
              - uploadId
              - description
            additionalProperties: false
      required:
        - source
      additionalProperties: false
    BrandResult:
      type: object
      properties:
        brand:
          type: object
          properties:
            id:
              type: string
            name:
              type: string
            url:
              type: string
            colors:
              type: array
              items:
                type: string
            taglines:
              type: array
              items:
                type: string
            logo:
              anyOf:
                - type: object
                  properties:
                    id:
                      type: string
                    fileUrl:
                      type:
                        - string
                        - 'null'
                    description:
                      type:
                        - string
                        - 'null'
                  required:
                    - id
                    - fileUrl
                    - description
                - type: 'null'
            distinctiveAssets:
              type: array
              items:
                type: object
                properties:
                  id:
                    type: string
                  fileUrl:
                    type:
                      - string
                      - 'null'
                  description:
                    type:
                      - string
                      - 'null'
                required:
                  - id
                  - fileUrl
                  - description
          required:
            - id
            - name
            - url
            - colors
            - taglines
            - logo
            - distinctiveAssets
        readiness:
          type: object
          properties:
            colors:
              type: boolean
            logo:
              type: boolean
            taglines:
              type: boolean
            distinctiveAssets:
              type: boolean
          required:
            - colors
            - logo
            - taglines
            - distinctiveAssets
        enabledChecks:
          type: array
          items:
            type: string
        newlyEnabledChecks:
          type: array
          items:
            type: string
        conflicts:
          type: array
          items:
            type: object
            properties:
              field:
                type: string
                enum:
                  - name
                  - logoUploadId
                  - distinctiveAssets
                  - colors
              existingValue:
                type: string
              requestedValue:
                type: string
            required:
              - field
              - existingValue
              - requestedValue
      required:
        - brand
        - readiness
        - enabledChecks
        - newlyEnabledChecks
        - conflicts
    Error:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              enum:
                - invalid_api_key
                - api_key_revoked
                - api_key_expired
                - insufficient_scope
                - insufficient_role
                - confirmation_required
                - content_rejected
                - insufficient_credits
                - spend_limit_reached
                - feature_not_enabled
                - key_owner_not_member
                - rate_limited
                - concurrency_limit
                - invalid_request
                - idempotency_key_required
                - idempotency_conflict
                - idempotency_key_retired
                - upload_not_found
                - upload_invalid
                - file_too_large
                - video_too_long
                - source_url_rejected
                - source_url_unreachable
                - invalid_ooh_format
                - voice_origin_mismatch
                - invalid_placement
                - brand_not_found
                - quota_exhausted
                - not_found
                - report_not_ready
                - pretest_in_progress
                - webhook_url_rejected
                - webhook_endpoint_limit
                - internal_error
              description: >-
                Stable machine-readable code. Branch on this, not on the
                message. voice_origin_mismatch is legacy: no longer returned.
            message:
              type: string
              description: Human-readable explanation in English. Its wording can change.
            requestId:
              type: string
              description: >-
                Same value as the X-Request-Id response header. Quote it when
                you email support@myunite.ai.
            docUrl:
              type: string
              description: Page that explains this code.
            param:
              description: >-
                The field, query parameter or header the error refers to, when
                there is one.
              type: string
          required:
            - code
            - message
            - requestId
            - docUrl
      required:
        - error
  headers:
    X-Request-Id:
      description: >-
        Identifier of this request. Quote it when you email support@myunite.ai.
        It is also in error.requestId.
      schema:
        type: string
    RateLimit-Limit:
      description: >-
        Requests allowed per minute for this key and bucket: 600 for reads, 60
        for writes. Sent on responses once the key is accepted. On 401 errors
        and on 403 errors raised while the key is checked they may be absent.
      schema:
        type: integer
    RateLimit-Remaining:
      description: Requests left in the current window.
      schema:
        type: integer
    RateLimit-Reset:
      description: Seconds until the oldest counted request leaves the window.
      schema:
        type: integer
    Retry-After:
      description: Seconds to wait before you try again.
      schema:
        type: integer
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        API key, sent as `Authorization: Bearer unite_live_...`. Create keys in
        the workspace settings.

````

## Related topics

- [Create a workspace brand](https://docs.myunite.ai/api-reference/brands/create-a-workspace-brand.md)
- [Get the catalog of channels, formats and brands](https://docs.myunite.ai/api-reference/catalog/get-the-catalog-of-channels-formats-and-brands.md)
- [MCP para agentes de IA](https://docs.myunite.ai/mcp-server.md)
- [Erros](https://docs.myunite.ai/errors.md)
- [Marcas](https://docs.myunite.ai/brands.md)


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