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

# Orb color presets overview

> Workspace-scoped saved avatar-orb color palettes, reusable across every agent in the org.

An **orb color preset** is a workspace-scoped, named color palette for the widget's animated avatar orb. Save the palette you like once and apply it to any agent in the org — for example, a single set of brand colors reused everywhere.

## Model

| Field                     | Notes                                                                                                                                                                   |
| ------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `id`                      | `orbpre_…`                                                                                                                                                              |
| `name`                    | Unique per workspace.                                                                                                                                                   |
| `colors`                  | 2–5 six-digit hex stops in `#rrggbb` form (e.g. `#FA954C`). Shorthand (`#fff`) and no-hash (`FA954C`) are rejected — the dashboard color editor only handles `#rrggbb`. |
| `createdAt` / `updatedAt` | ISO-8601.                                                                                                                                                               |

Presets are **not versioned**: a palette is a small immutable list, so "editing" is delete + recreate.

## Scope & auth

Every route is workspace-scoped (`workspace` scope group) and org-isolated — presets are shared by all agents in the org but never leak across orgs. Both cookie-session and API-key callers are supported; for cookie sessions the org is re-checked against the caller's active workspace on each request.

## Endpoints

| Method   | Path                         | Scope             |
| -------- | ---------------------------- | ----------------- |
| `GET`    | `/v1/orb-color-presets`      | `workspace:read`  |
| `POST`   | `/v1/orb-color-presets`      | `workspace:write` |
| `DELETE` | `/v1/orb-color-presets/{id}` | `workspace:write` |

## Limits

* Up to **100** presets per workspace (enforced atomically, so concurrent creates can't exceed it).
* A duplicate name returns **409 Conflict**.