---
title: "Update the workspace"
method: PATCH
path: "/v1/workspaces"
---

# Update the workspace

`PATCH /v1/workspaces`

Update fields on the workspace.

## Request body

- object — Workspace fields to update.
  - `agent_context` string — Agent-specific context for the workspace.

## Response `200`

Successful response

- object — Base response envelope for all successful API responses.
  - `success` true, required
  - `request_id` string, required
  - `result` Workspace, required — The workspace for this service account.
    - `key` string, required — The unique identifier for the workspace
    - `name` string, required — The display name for the workspace
    - `created_at` string, date-time, required — An ISO 8601 date-time string.
    - `creator` string, required — The unique identifier for the user
    - `domain_whitelist` string[], required — Email domains permitted to join this workspace.
    - `tags` object[], required — Tags defined in this workspace.
      - `key` string, required — The unique identifier for the tag.
      - `name` string, required — The name of the tag.
      - `color` string, required — The tag color.
      - `description` string, required — A description of the tag.
    - `allow_ai` boolean, required — Whether AI features are enabled for this workspace.
    - `allow_csv_downloads` boolean, required — Whether CSV downloads are enabled for this workspace.
    - `allow_embeds` boolean, required — Whether canvas embeds are enabled for this workspace.
    - `allow_guests` boolean, required — Whether guest users are allowed in this workspace.
    - `allow_public` boolean, required — Whether public canvas sharing is enabled for this workspace.
    - `agent_context` string — Agent-specific context for the workspace.

## Other responses

- `4XX` — Client error. Possible status codes include: 400 (invalid request), 401 (missing or invalid API key), 403 (insufficient permissions), 404 (resource not found), 429 (rate limit exceeded).
- `5XX` — Internal server error.

---

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