---
title: "Update Workspace"
method: PATCH
path: "/api/v1/workspace"
tags: ["workspace"]
---

# Update Workspace

`PATCH /api/v1/workspace`

Update workspace settings. Requires workspace admin for the name field.

All fields are optional. Only provided fields are updated.

## Request body

- WorkspaceUpdateRequest — Request model for updating workspace settings. All fields are optional -- only provided fields are updated.
  - `name` string, nullable — New name for the workspace
  - `avatar_color` string, nullable — Avatar color name for the workspace. Set to null to remove.

## Response `200`

Successful Response

- WorkspaceResponse — Response model for workspace details.
  - `id` string, uuid, required
  - `name` string, required
  - `avatar_color` string, nullable
  - `created_at` string, date-time, nullable
  - `credit_balance` CreditBalance, required — Credit balance breakdown for a workspace. Uses pool accounting: total is the credits ever granted (never decremented), used is cumulative consumption, remaining = total - used.
    - `total` integer, required
    - `used` integer, required
    - `remaining` integer, required
  - `member_count` integer, required
  - `dial_agent_settings` DialAgentSettings — Per-workspace overrides for placeholders in the Retell agent flow. Each field maps to a `{{placeholder}}` in the Retell flow config. Unset fields are omitted at dispatch so the flow node's baked-in default applies.
    - `voicemail_message` string, nullable
    - `intro_line` string, nullable
    - `transfer_pitch` string, nullable
  - `auto_dial_enabled` boolean
  - `feature_toggles` object

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/maia-analytics/apis/maia-api.md) · [All operations](https://skmtc.net/maia-analytics/apis/maia-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/maia-analytics/maia-api/versions/ba2b8d962161/schema)