This page documents the canonical HTTP contract for this endpoint.
The typed command rejects unknown fields. Create requires workspace, name, and config; update requires view_id and at least one mutable field; delete and set_default require view_id.
Body parameters
actionrequiredstring
create, update, delete, or set_default.
view_id· optionalstring
Required for update, delete, and set_default.
workspace· optionalstring
name· optionalstring
visibility· optionalstring
is_default· optionalboolean
config· optionalobject
Required for create.
| Name | Type | Description |
|---|---|---|
| actionrequired | string | create, update, delete, or set_default. |
| view_id | string | Required for update, delete, and set_default. |
| workspace | string | - |
| name | string | - |
| visibility | string | - |
| is_default | boolean | - |
| config | object | Required for create. |
Errors
| Status | Meaning |
|---|---|
| 400 | Invalid command fields or required fields for action are missing. |
| 401 | Missing or invalid authentication. |
| 403 | Missing workspace_views:write scope. |
