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

# Update a brand kit

> Update a brand kit. Supply its current updated_at.



## OpenAPI

````yaml /openapi.json put /brand-kits/{brand_kit_id}
openapi: 3.1.0
info:
  title: Motion
  version: 1.1.0
  description: >-
    Create Motion projects from prompts, read authored generations and outputs,
    and explicitly request renders or editor exports. Use reusable templates and
    brand kits. Credentials remain bound to current workspace access and
    permissions. Legacy single-video endpoints are deprecated.
servers:
  - url: https://api.motion.so/api/motion
security:
  - MotionApiKey: []
tags:
  - name: Projects
  - name: Project results
  - name: Project exports
  - name: Templates
  - name: Brand kits
  - name: Media library
  - name: Automations
  - name: Social posting
  - name: API information
  - name: Deprecated endpoints
    description: >-
      Older single-video routes remain callable for existing clients. Use the
      project API for new integrations; no removal date is scheduled.
  - name: Connectors
    description: Connect services and control the actions a project may use.
paths:
  /brand-kits/{brand_kit_id}:
    put:
      tags:
        - Brand kits
      summary: Update a brand kit
      description: Update a brand kit. Supply its current updated_at.
      operationId: UpdateABrandKit
      parameters:
        - name: brand_kit_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                definition:
                  type: object
                  properties:
                    version:
                      default: 1
                      type: number
                      const: 1
                    name:
                      type: string
                      minLength: 1
                      maxLength: 100
                    sections:
                      maxItems: 50
                      type: array
                      items:
                        type: object
                        properties:
                          id:
                            description: >-
                              Section ID to keep when updating. Generated when
                              omitted.
                            type: string
                            format: uuid
                          title:
                            type: string
                            maxLength: 160
                          text:
                            default: ''
                            type: string
                            maxLength: 100000
                          asset_ids:
                            default: []
                            description: >-
                              Ready Library asset IDs shown in this section, in
                              order. Each is read through your current Library
                              access.
                            maxItems: 500
                            type: array
                            items:
                              type: string
                              format: uuid
                        required:
                          - title
                        additionalProperties: false
                      description: >-
                        Up to 50 sections, 100,000 text characters and 500
                        distinct Library asset IDs across the entire kit.
                  required:
                    - name
                    - sections
                  additionalProperties: false
                updated_at:
                  type: string
                  format: date-time
              required:
                - definition
                - updated_at
              additionalProperties: false
            example:
              definition:
                version: 1
                name: Acme
                sections:
                  - id: 4f20dcdd-f63b-4898-97d6-2e05c0d37c78
                    title: Product launch
              updated_at: '2026-11-17T20:00:00Z'
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MotionUpdateBrandKitResponse'
              example:
                kit:
                  id: 4f20dcdd-f63b-4898-97d6-2e05c0d37c78
                  definition:
                    version: 1
                    name: Acme
                    sections:
                      - id: 3c90c3cc-0d44-4b50-8888-8dd25736052a
                        title: Voice
                        text: Clear, concise and confident.
                        assets: []
                  updated_at: '2026-11-17T20:00:00Z'
        '400':
          description: Invalid input or cursor
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Credential invalid or revoked
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: Missing scope, role, resource access or entitlement
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Resource not visible
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '409':
          description: Stale revision, active work or conflicting source identity
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '503':
          description: Required service unavailable; do not blindly retry mutations
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - MotionApiKey: []
        - MotionOAuth:
            - motion:brand-kits:write
components:
  schemas:
    MotionUpdateBrandKitResponse:
      type: object
      properties:
        kit:
          type: object
          properties:
            id:
              type: string
              format: uuid
              pattern: >-
                ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
              description: >-
                Identifier of this resource. Use it when reading or updating the
                same resource.
            definition:
              type: object
              properties:
                version:
                  type: number
                  const: 1
                  description: Brand guideline schema version. Currently 1.
                name:
                  type: string
                  description: Human-readable name for this item.
                sections:
                  type: array
                  items:
                    type: object
                    properties:
                      id:
                        type: string
                        format: uuid
                        pattern: >-
                          ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
                        description: Section ID. Keep it when updating this section.
                      title:
                        type: string
                        description: Section heading.
                      text:
                        type: string
                        description: Guidelines for this section.
                      assets:
                        type: array
                        items:
                          type: object
                          properties:
                            assetId:
                              type: string
                              format: uuid
                              pattern: >-
                                ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
                              description: Referenced Library asset ID.
                          required:
                            - assetId
                          additionalProperties: {}
                        description: >-
                          Library assets in this section. When updating, send
                          their IDs as asset_ids.
                    required:
                      - id
                      - title
                      - text
                      - assets
                    additionalProperties: {}
                  description: >-
                    Brand guideline sections with text and accessible library
                    asset references.
              required:
                - version
                - name
                - sections
              additionalProperties: {}
              description: >-
                Brand guidelines with version 1, a name and sections containing
                text and existing library asset IDs.
            updated_at:
              anyOf:
                - type: string
                  format: date-time
                  pattern: >-
                    ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$
                - type: 'null'
              description: Timestamp of the latest resource change in ISO 8601 format.
          required:
            - id
            - definition
          additionalProperties: {}
          description: Brand kit guidelines and permitted assets.
      required:
        - kit
      additionalProperties: false
    ErrorResponse:
      type: object
      description: >-
        Error bodies are JSON. Check the HTTP status first. Permission and
        validation errors use error; service errors may use detail. Optional
        fields explain how to correct the request.
      anyOf:
        - required:
            - error
        - required:
            - detail
      properties:
        error:
          type: string
          description: Error code or readable explanation.
        detail:
          type: string
          description: Readable explanation from the service.
        message:
          type: string
          description: Readable explanation accompanying an error code.
        error_description:
          type: string
          description: Authentication or permission explanation.
        required_scope:
          type: string
          description: Permission required by this operation.
        details:
          type: array
          description: Invalid request fields. Each issue includes a path and message.
          items:
            type: object
            properties:
              code:
                type: string
              path:
                type: array
                items:
                  oneOf:
                    - type: string
                    - type: integer
              message:
                type: string
        issues:
          type: array
          description: Service validation issues.
          items:
            type: object
  securitySchemes:
    MotionApiKey:
      type: http
      scheme: bearer
      description: >-
        A Motion API key. Access is limited to its stored organization,
        workspace, scopes and the creator’s current permissions.
    MotionOAuth:
      type: oauth2
      description: >-
        OAuth REST tokens use the full MCP audience, https://mcp.motion.so/mcp.
        Reauthorize existing connections to add scopes. Current workspace roles
        and resource permissions still apply.
      flows:
        authorizationCode:
          authorizationUrl: https://mcp.motion.so/oauth/authorize
          tokenUrl: https://mcp.motion.so/oauth/token
          scopes:
            motion:automations:read: Read automation definitions, capabilities, runs, and analytics.
            motion:automations:write: Create, edit, delete, invoke, and retry automations.
            motion:connectors:read: >-
              Read available services, your private organization connections and
              allowed actions without secrets.
            motion:connectors:write: >-
              Connect and disconnect your private accounts inside the credential
              organization workspace.
            motion:templates:read: Read and preview accessible templates.
            motion:templates:write: Create, edit, share, and archive prompt templates.
            motion:sessions:read: Read permitted chats, job status and saved exports.
            motion:sessions:write: >-
              Create and steer Motion projects using organization workspace
              credits.
            motion:assets:read: Find and read permitted media library assets.
            motion:brand-kits:read: Read permitted brand kits.
            motion:brand-kits:write: Create and edit brand kits within current app permissions.
            motion:social:read: Read authorized social accounts and posts.
            motion:social:write: >-
              Draft, submit, approve and cancel posts within current app
              permissions.

````

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