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

# Update workspace settings

`PATCH /workspaces/{id}/settings`

## Request

- Base URL: `https://app.openpo.st/api/v1`
- URL: `https://app.openpo.st/api/v1/workspaces/{id}/settings`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `openpost_session`

## Path parameters

- `id` string, required: Workspace ID

## Request body

- UpdateWorkspaceSettingsInputBody
  - `$schema` string, uri: A URL to the JSON Schema for this object.
  - `avatar_url` string
  - `color` string: Workspace accent color as a six-digit hex value
  - `media_cleanup_days` integer: Deprecated and ignored. Temporary media always becomes eligible after 14 unused days.
  - `name` string: Workspace name
  - `random_delay_minutes` integer
  - `slot_end_hour` integer
  - `slot_interval_minutes` integer
  - `slot_start_hour` integer
  - `timezone` string
  - `week_start` integer

## Response `200`

OK

- UpdateWorkspaceSettingsOutputBody
  - `$schema` string, uri: A URL to the JSON Schema for this object.
  - `avatar_url` string, required
  - `color` string, required
  - `media_cleanup_days` 14, required: Deprecated compatibility value. Always 14; temporary-media cleanup cannot be configured.
  - `name` string, required
  - `random_delay_minutes` integer, required
  - `slot_end_hour` integer, required
  - `slot_interval_minutes` integer, required
  - `slot_start_hour` integer, required
  - `timezone` string, required
  - `week_start` integer, required

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `404`: Not Found
- `422`: Unprocessable Entity
- `500`: Internal Server Error

---

[API](https://skmtc.dev/openpo/apis/openpost-api.md) · [All operations](https://skmtc.dev/openpo/apis/openpost-api/llms.txt) · [OpenAPI document](https://skmtc.dev/openpo/apis/openpost-api/revisions/67d3964458a7?raw)