---
title: "PATCH /v1/workspaces/{workspaceId}"
method: PATCH
path: "/v1/workspaces/{workspaceId}"
tags: ["Workspaces"]
---

# PATCH /v1/workspaces/{workspaceId}

`PATCH /v1/workspaces/{workspaceId}`

Updates a workspace: rename, archive, restore, or update settings (blockPublicTilePublish, securityReviewsEnabled, evalsEnabled, orgDefaultRole).

## Path parameters

- `workspaceId` string, uuid, required

## Headers

- `Authorization` string

## Request body

- union
  - object
    - `name` string
    - `blockPublicTilePublish` boolean
    - `securityReviewsEnabled` boolean
    - `evalsEnabled` boolean
    - `orgDefaultRole` union
      - 'publisher'
      - 'member'
      - 'consumer'
  - object
    - `name` string
    - `blockPublicTilePublish` boolean
    - `securityReviewsEnabled` boolean
    - `evalsEnabled` boolean
    - `orgDefaultRole` union
      - 'publisher'
      - 'member'
      - 'consumer'
    - `archived` false, required
  - object
    - `name` string
    - `blockPublicTilePublish` boolean
    - `securityReviewsEnabled` boolean
    - `evalsEnabled` boolean
    - `orgDefaultRole` union
      - 'publisher'
      - 'member'
      - 'consumer'
    - `archived` true, required
    - `archivedReason` string, required

## Response `200`

Default Response

- object
  - `links` object, required
    - `self` string, uri, required
  - `data` object, required
    - `id` string, uuid, required
    - `type` 'workspace', required
    - `attributes` object, required
      - `name` string, required
      - `archived` boolean, required
      - `archivedAt` string, date-time, nullable, required
      - `archivedBy` string, uuid, nullable, required
      - `archivedReason` string, nullable, required
      - `blockPublicTilePublish` boolean, required
      - `securityReviewsEnabled` boolean, required
      - `evalsEnabled` boolean, required
      - `orgDefaultRole` union, required
        - 'owner'
        - 'manager'
        - 'publisher'
        - 'member'
        - 'consumer'
      - `createdAt` string, date-time, required
      - `updatedAt` string, date-time, required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error

---

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