Skip to content
LogoLogo

Create or revision-check a personal Task query

Create or revision-check a personal Task query

POST/api/v1/workspaces/{workspace_id}/task-saved-views

Membership-private native work capability. Current Workspace and resource permissions are checked on every request. Responses use Cache-Control: no-store. Requires a browser session and CSRF. Reuse Idempotency-Key only for the same request. Before retrying an uncertain write, resolve its operation receipt.

Path Parameters

workspace_idRequired
string <uuid>
Example0198ac5e-f9b7-7000-8000-000000000001

Header Parameters

X-CSRF-TokenRequired
string·min 43·max 43

Session-bound CSRF token. It must exactly match the __Host-assign_csrf cookie sent with the request.

Idempotency-KeyRequired
string·min 16·max 200

Opaque client-generated key for safely retrying this operation.

Request Body

application/json
id
string <uuid>
expected_revision
integer <int64>
nameRequired
string·min 1·max 100
queryRequired
object

Checked canonical query; Core normalizes filters and intersects authorized Project scope. State and resolution follow the Workspace Task list contract. Optional filter_terms/order apply within the ten-page/1000-row checked scan ceiling; they do not introduce unbounded search. Saved views retain these fields and reopening creates a fresh result set with current coverage.

definition
object

Membership-private Project Task presentation. Maximum serialized size is 16 KiB. Query Project scope must match project_id. Missing parameters use the current Project Task presentation defaults; unsupported keys or values are rejected. An update omitting definition preserves the existing definition, and an existing definition cannot move to another Project.

Responses