Skip to main content

Execute saved workspace view command

Create, update, delete, or set the default saved workspace view.

POST/api/workspace-views/command
HTTP referenceScope workspace_views:writeUpdated September 27, 2026

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

  • actionrequired

    string

    create, update, delete, or set_default.

  • view_id · optional

    string

    Required for update, delete, and set_default.

  • workspace · optional

    string

  • name · optional

    string

  • visibility · optional

    string

  • is_default · optional

    boolean

  • config · optional

    object

    Required for create.

Errors

StatusMeaning
400Invalid command fields or required fields for action are missing.
401Missing or invalid authentication.
403Missing workspace_views:write scope.

Docs