Create Saved View
create_saved_viewSave a named ticket filter, column, grouping and sort bundle so you can reopen it later or share it with a team. Saves the QUESTION, not an answer: the view is re-run against live tickets every time it is opened, so it never goes stale. The new view is private until you share it. Same endpoint the web app's save button uses. Requires authentication and the tickets:write scope.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | What to call the view. | |
| columns | Yes | Which ticket columns the view shows, in order. At most 20. | |
| filters | No | Saved question. Omitted reader selects ordinary tickets. Attention accepts reason; reviewed_attention accepts state and follow_up. Triage refuses other non-default ticket filters, grouping and sorting. Save intent only, never result pages. | |
| sort_by | No | Optional ticket field to sort rows by. | |
| group_by | No | Optional ticket field to group rows by. | |
| sort_dir | No | Sort direction. Defaults to asc. | asc |
| scorecard | No | Optional private ordinary live ticket counts; omit to retain, null to clear while retaining a nonzero revision. At most 10000 matching tickets, no actions or role grants. Shared and triage definitions cannot enroll. | |
| expected_revision | No | Current definition_revision, required to configure a scorecard or change any previously enrolled view. On conflict or uncertain reply, read current state and deliberately reconcile; this is not an exact-retry receipt. |