---
title: "Update Workspace"
method: PATCH
path: "/admin/workspaces/{id}"
---

# Update Workspace

`PATCH /admin/workspaces/{id}`

## Request

- Base URL: `https://app.runconverge.com/api`
- URL: `https://app.runconverge.com/api/admin/workspaces/{id}`
- Auth: none declared

## Path parameters

- `id` integer, required

## Headers

- `Authorization` string, nullable

## Cookies

- `session_id` string, nullable

## Request body

- UpdateWorkspaceSchema
  - `name` string, nullable
  - `workspace_settings` WorkspaceInternalSettings
    - `features` object
    - `attributed_spend_settings` AttributedSpendSettings
      - `event_name` 'Viewed Product' | 'Added To Cart' | 'Placed Order', required
  - `monthly_credit_limit` integer, nullable

## Response `200`

Successful Response

- GetWorkspaceResponse
  - `id` integer, required
  - `name` string, required
  - `organization_id` integer, nullable, required
  - `active` boolean, required
  - `ui_config` UIConfig, required
    - `start_of_week` 0 | 1
    - `timezone` string
    - `currency` string
    - `table_settings` object
    - `overview_custom_dimensions` Selection[]
      - `id` integer, required
      - `values` string[], required
  - `workspace_settings` WorkspaceInternalSettings, required
    - `features` object
    - `attributed_spend_settings` AttributedSpendSettings
      - `event_name` 'Viewed Product' | 'Added To Cart' | 'Placed Order', required
  - `monthly_credit_limit` integer, nullable, required
  - `monthly_cost_limit_usd` number, nullable, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-15** `f723e951cc0b`: 1 warning, 1 info
  - added the new `slack_agent` enum value to the `workspace_settings/anyOf[subschema #1: WorkspaceInternalSettings]/features/propertyNames/` response property for the response status `200`
  - added the new `slack_agent` enum value to the request property `workspace_settings/anyOf[subschema #1: WorkspaceInternalSettings]/features/propertyNames/`

[Operation history](https://skmtc.dev/runconverge/apis/runconverge-api/changes/admin/workspaces/:id/patch.md)

---

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