---
title: "Update Workspace"
method: PATCH
path: "/api/v1/internal/workspaces/{workspace_id}"
tags: ["internal", "workspaces"]
---

# Update Workspace

`PATCH /api/v1/internal/workspaces/{workspace_id}`

Update workspace fields.

## Path parameters

- `workspace_id` string, uuid, required

## Request body

- AdminWorkspaceUpdateRequest — Request schema for updating workspace fields. All fields optional; uses exclude_unset semantics. Rejects unknown fields with 422 — legacy callers sending the removed `allowed_geographies` key should fail loud rather than silently no-op.
  - `name` string, nullable
  - `is_internal` boolean, nullable
  - `icp_category_id` string, uuid, nullable — Id of a staff-administered ICP category. Omit to leave unchanged; pass an explicit null to clear (unassigned).

## Response `200`

Successful Response

- AdminWorkspaceDetailResponse — Full workspace detail response for admin view.
  - `id` string, uuid, required
  - `name` string, required
  - `budget_authority` 'credits' | 'discovery_allowance', required
  - `avatar_color` string, nullable, required
  - `available_enrichment_credits` integer, required
  - `used_enrichment_credits` integer, required
  - `remaining_credits` integer, required
  - `is_suspended` boolean, required
  - `is_internal` boolean, required
  - `icp_category_id` string, uuid, nullable, required
  - `member_count` integer, required
  - `project_count` integer, required
  - `members` AdminWorkspaceMemberItem[], required
    - `id` string, uuid, required
    - `email` string, required
    - `display_name` string, nullable, required
    - `workspace_role` string, nullable, required
    - `is_internal` boolean, required
    - `is_suspended` boolean, required
    - `created_at` string, date-time, nullable, required
    - `used_enrichment_credits` integer, required
    - `last_active_at` string, date-time, nullable, required
  - `created_at` string, date-time, nullable, required
  - `updated_at` string, date-time, nullable, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/maia-analytics/apis/maia-api.md) · [All operations](https://skmtc.dev/maia-analytics/apis/maia-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/maia-analytics/maia-api/revisions/0c94a4b5a00e/schema)