Create a saved queue view

Store a set of ticket-queue filters under a name.

filters may only carry keys GET /v1/tickets understands. A filter that endpoint would reject is refused here rather than stored, because a stored unknown filter silently matches every ticket the moment it is applied. Set shared: true to make the view visible to the whole workspace.

Tenancy: the request is scoped to one workspace, and the credential presented is what selects it. A caller with no membership in that workspace is refused with 404, which is indistinguishable from a workspace that does not exist.

Authorisation: editor, admin or owner. A viewer receives 403 insufficient_role.

Access: Authorization: Bearer carrying either a realm access token or an API key. A key must hold the helpdesk-ops:write scope, and the workspace role of the person who owns it must meet the floor above.

Response Body

curl -X POST "https://example.com/v1/saved-views" \  -H "Content-Type: application/json" \  -d '{    "name": "My urgent tickets"  }'

{}