Update workspace settings

Partial update. Only fields present in the request body are mutated. tier is billing-controlled and cannot be changed here. signing_secret is rotated through a separate flow.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.
namestringOptional>=1 character

Non-empty display name.

webhook_urlstringOptional

Must start with http:// or https://.

retention_daysintegerOptional1-3650

Response

Updated workspace
idstring
namestring
tierenum
retention_daysinteger1-3650
NDPR data retention window for this workspace.
created_atdatetime
updated_atdatetime
webhook_urlstring
signing_secret_rotated_atdatetime

Timestamp of the most recent signing-secret rotation. Absent (omitted from the response) when the workspace has never rotated its signing secret. The secret value itself is never returned by this endpoint — see POST /v1/workspace/signing-secret/rotate.

Errors

400
Update Workspace Request Bad Request Error