---
title: "Update workspace"
method: PATCH
path: "/workspaces/{workspace_id}"
tags: ["workspaces"]
---

# Update workspace

`PATCH /workspaces/{workspace_id}`

Updates mutable workspace attributes for a partner-managed workspace. Partners can change the human-readable display_name and/or adjust the number of purchased seats (seats_purchased, 1-999). When the purchased seats are reduced below current utilization, the platform may automatically suspend users and their associated WhatsApp accounts to comply with the new limit. The response returns the updated workspace representation, including seat counters and, when applicable, details of suspended members so partners can reconcile the downgrade on their side. Standard partner ownership and billing eligibility checks apply before processing the update.

## Path parameters

- `workspace_id` string, required

## Headers

- `X-TL-Partner-Id` string, required

## Request body

- PartnerAPIWorkspaceRequest — Partial update payload for a workspace. Allows partners to change the workspace display_name and/or the number of purchased seats. Fields are optional and only those provided are updated. Business rules around seat downgrades, including potential user suspensions, are enforced server-side.
  - `display_name` string — New workspace display name
  - `seats_purchased` integer — New number of workspace seats

## Response `200`

Workspace updated

- PartnerAPIWorkspaceResponse — Representation of a partner-managed workspace returned after creation or update. It includes the stable workspace_id, display_name, linked plan_id, seat allocation and utilization, audit timestamps, the default group identifier, the automatically generated Owner user, and any suspended members that resulted from a seat downgrade.
  - `workspace_id` string, required — Unique identifier for the workspace
  - `display_name` string, required — Workspace display name
  - `plan_id` integer, required — Workspace plan type
  - `seats_total` integer, required — Total number of seats in the workspace
  - `seats_available` integer, required — Number of available seats in the workspace
  - `updated_at` string, date-time — Timestamp of the last update
  - `owner_user_id` integer — User ID of the workspace owner
  - `group_id` integer — Group ID associated with the workspace
  - `created_at` string, date-time — Timestamp of workspace creation
  - `suspended_members` SuspendedMember[] — array of suspended user IDs
    - `user_id` integer, required — ID of the suspended user
    - `whatsapp_account_id` integer — ID of the WhatsApp account associated with the suspended user
    - `phone_numbers` string[] — List of phone numbers associated with the suspended user

## Other responses

- `404` — Workspace not found

## Changes

- **2026-07-01** `3b25460ca964` — 1 info
  - the `display_name` request property's maxLength was increased from `30` to `100`
- **2026-02-25** `620de7c48b91` — 1 info
  - the `seats_purchased` request property's max was increased from `99.00` to `999.00`

[Change history](https://skmtc.dev/initechsoftware/apis/partner-api/changes/workspaces/:workspace_id/patch.md)

---

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