Skip to main content

List Saved Views

GET 
/api/support/agent/saved-views

Lists the saved queue views the caller can see: their own views plus every view a colleague shared, ordered by position then name. A saved view is a named set of agent-queue filters; to run one, send its filters as the query parameters of List Agent Queue Tickets. No filters or pagination.

Required scope: support:read

Grant this scope to your token under Settings → Developer → Personal Access Tokens.

Response fields

  • id (integer), user_id (integer) — the owner's user id
  • owner ({id, name}, nullable)
  • name (string), filters (object — the saved queue filters, see below)
  • is_shared (boolean) — visible to every agent
  • is_mine (boolean) — owned by the caller
  • position (integer) — ordering hint among the owner's views
  • created_at, updated_at (ISO-8601)

The filters object — the agent-queue filter keys (see List Agent Queue Tickets); only these keys are accepted, anything else is rejected with 422:

  • queue (string, nullable) — one of: triage, unassigned, mine, open, waiting, awaiting_release, breaching, snoozed, resolved, all
  • tenant_id (string, nullable, max 64)
  • search (string, nullable, max 200)
  • sort (string, nullable) — one of: updated_at, created_at, priority, first_response_due_at, resolution_due_at
  • direction (string, nullable) — asc or desc
  • assignee_user_id (integer, nullable, min 1)
  • group_key (string, nullable, max 32)
  • priority (string, nullable, max 60) — one value or a comma-separated list of: low, medium, high, urgent
  • type (string, nullable, max 80) — one value or a comma-separated list of: bug, question, feature_request, billing
  • status (string, nullable, max 160) — one value or a comma-separated list of: open, in_progress, waiting_on_customer, awaiting_release, resolved, closed
  • layout (string, nullable) — how the queue is shown when the view is opened: list or table. Saved with the view, so a shared view opens the same way for everyone
  • columns[] (array of strings, nullable, max 40 entries, each max 64 characters of lowercase letters, digits and underscores) — the columns the table layout shows, in order

Keys sent as null, an empty string or an empty array are dropped before saving; string values are trimmed.

Authentication: Bearer token with the support:read scope, or an authenticated session, from a caller with an active support role (any role, including viewer). No tenant context — this endpoint is central.

Request​

Responses​

OK

Response Headers
    Content-Type