> ## Documentation Index > Fetch the complete documentation index at: https://docs.base44.com/llms.txt > Use this file to discover all available pages before exploring further. > ## Agent Instructions > Internal links on these pages omit the .md extension. Append .md to a docs page URL, or send an Accept: text/markdown header, to get that page as markdown. # Update workspace brand > This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production. Replaces a brand's kit and design system. Send the whole brand: `design_system` replaces the stored one, and leaving it out clears it. `kit.title` becomes the brand's title, and it can't exactly match another brand's title in the workspace. `kit` and `design_system` are stored as you send them, up to 1 MB together. Updating doesn't change the brand's `status`. Don't update a brand while it's `generating`, because the finished generation replaces your changes. This is limited to 60 requests per minute, shared with the other endpoints that change brands, except generating one. A signed-in session has its own limit, and every personal access token for the workspace shares one. Some workspaces have a different limit. Call this as an owner or admin of the workspace, with a personal access token for that workspace sent as a Bearer token, or from a signed-in session. A read-only token is refused, and workspace API keys aren't accepted. The response includes fields beyond the ones documented here. Don't rely on undocumented response fields, as they can change at any time. ## OpenAPI ````yaml /developers/references/app-management/app-management-openapi.json put /api/workspace/{workspace_id}/brands/{brand_id} openapi: 3.1.0 info: title: Base44 App Management API version: 1.0.0 servers: - url: https://app.base44.com security: - PersonalAccessTokenAuth: [] paths: /api/workspace/{workspace_id}/brands/{brand_id}: put: summary: Update workspace brand description: >- This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production. Replaces a brand's kit and design system. Send the whole brand: `design_system` replaces the stored one, and leaving it out clears it. `kit.title` becomes the brand's title, and it can't exactly match another brand's title in the workspace. `kit` and `design_system` are stored as you send them, up to 1 MB together. Updating doesn't change the brand's `status`. Don't update a brand while it's `generating`, because the finished generation replaces your changes. This is limited to 60 requests per minute, shared with the other endpoints that change brands, except generating one. A signed-in session has its own limit, and every personal access token for the workspace shares one. Some workspaces have a different limit. Call this as an owner or admin of the workspace, with a personal access token for that workspace sent as a Bearer token, or from a signed-in session. A read-only token is refused, and workspace API keys aren't accepted. The response includes fields beyond the ones documented here. Don't rely on undocumented response fields, as they can change at any time. operationId: update_brand_api_workspace__workspace_id__brands__brand_id__put parameters: - name: workspace_id in: path required: true schema: type: string description: >- ID of the workspace. With a personal access token, use the token's workspace. Get it from `organization_id` in [Get app](/api-reference/get-app). title: Workspace Id description: >- ID of the workspace. With a personal access token, use the token's workspace. Get it from `organization_id` in [Get app](/api-reference/get-app). example: 67e0b12c4d8a3f005b21c9e4 - name: brand_id in: path required: true schema: type: string description: >- ID of the brand to update. Get it from `id` in [List workspace brands](/api-reference/list-workspace-brands). title: Brand Id description: >- ID of the brand to update. Get it from `id` in [List workspace brands](/api-reference/list-workspace-brands). example: 68e0c4a1b9d2f7003a5e1b42 requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/BrandUpsertRequest' responses: '200': description: The brand was saved. content: application/json: schema: $ref: '#/components/schemas/ChangeResult' example: status: success message: Brand 'Nordwind' saved '400': description: >- `kit` has no `title` or no `description`, or `kit` and `design_system` together are larger than 1 MB. '401': description: Missing or invalid credentials. '403': description: >- You aren't an owner or admin of the workspace, your token is for a different workspace or is read-only, or your credential can't be used on this endpoint. '404': description: Brand not found in this workspace. '409': description: >- Another brand in the workspace already has this title, or your workspace requires an unlocked SSO session. '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' '429': description: Rate limit exceeded. components: schemas: BrandUpsertRequest: properties: kit: additionalProperties: true type: object title: Kit description: >- The brand's identity. It needs a non-empty `title`, which becomes the brand's title, and a `description`. Brands Base44 generates also carry `tagLine`, `values`, `toneOfVoice`, `designGuidelines`, `componentStyle`, and a `logo` with its `url`. Nothing else in it is checked. example: description: >- A family furniture workshop that builds solid oak tables and chairs to order. logo: altText: Nordwind logo url: https://media.base44.com/images/public/nordwind-logo.png tagLine: Furniture built to last title: Nordwind toneOfVoice: - Warm - Plain-spoken values: - Craft - Honesty - Durability design_system: additionalProperties: true type: object title: Design System description: >- The brand's design system: its `tokens`, such as `colors` and `fonts`, and its component sections. It's stored as you send it. When you include `tokens`, send it as an object. Defaults to an empty object. example: tokens: colors: - label: Primary token: primary value: '#0B7A3B' - label: Background token: background value: '#FAF7F2' fonts: - family: Fraunces role: heading - family: Inter role: body type: object required: - kit title: BrandUpsertRequest ChangeResult: properties: status: type: string const: success title: Status description: Always `success`. example: success message: type: string title: Message description: Short confirmation. Its wording can change, so don't parse it. example: Members added to group. type: object required: - status - message title: ChangeResult description: Confirms the change. HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError securitySchemes: PersonalAccessTokenAuth: type: http scheme: bearer description: 'Personal access token, sent as `Authorization: Bearer `.' ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.