---
title: "Replace the branding of the caller's shared session pages [write]"
method: PUT
path: "/branding"
tags: ["branding"]
---

# Replace the branding of the caller's shared session pages \[write\]

`PUT /branding`

## Request

- Base URL: `https://api.agentsky.dev/v1`
- URL: `https://api.agentsky.dev/v1/branding`
- Auth: HTTP bearer

Only the person's own sign-in or a personal key that is not fixed to one workspace may call this; a workspace key, an app acting for the person, a task pass, a key limited to one job and a key fixed to one workspace are refused with 403 `restricted_token`. Replaces every field: a field left out, null or empty is cleared. Send JSON, or `multipart/form-data` with the same fields plus a `logo` part (PNG, JPEG or WebP, up to 512 KB) to upload a new logo. To keep the current logo, send its `logo_url` back.

## Request body

- object
  - `brand_name` string, nullable: Shown in place of AgentSky on the shared pages.
  - `logo_url` string, nullable: The logo already in use, to keep it. A new logo is uploaded as the `logo` part of a multipart request, never by address.
  - `brand_color` string, nullable: Header color.
  - `accent_color` string, nullable: Buttons and links; text on it is chosen for contrast.

## Response `200`

OK

- object
  - `branding` Branding, required: How the person's shared session pages look. A null field shows the default.
    - `brand_name` string, nullable, required: Shown in place of AgentSky on the shared pages.
    - `logo_url` string, nullable, required: An uploaded logo, as a path on the developer console's origin.
    - `brand_color` string, nullable, required: Header color.
    - `accent_color` string, nullable, required: Buttons and links; text on it is chosen for contrast.

## Other responses

- `default`: Error — { error: { code, message } }

## Changes

- **2026-11-02** `e5e8f0229a99`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/agentsky/apis/agentsky-developer-api/changes/branding/put.md)

---

[API](https://skmtc.dev/agentsky/apis/agentsky-developer-api.md) - [All operations](https://skmtc.dev/agentsky/apis/agentsky-developer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/agentsky/apis/agentsky-developer-api/revisions/0d435187cd55?raw)