SPsparkvault
help-desk

List the queue

Changed on

One page of a queue view: all (the whole desk, or one team with team_id), team (one team's), mine (the signed-in operator's) or unassigned, in the statuses asked for (at most four; open for all and team, every live status for mine and unassigned), newest activity first (last_activity) or the longest waiting first (oldest_waiting). requester_id lists one requester's tickets, in the order they were opened (newest first, or oldest first with oldest_waiting), narrowed by the view and the filters. q finds one ticket by its number, or lists the tickets of the requester an email address names, as requester_id does. Each row carries its requester and who is on it now. Any member, from their own session.

get/products/help-desk/tickets

Request

Query parameters

view'all' | 'mine' | 'unassigned' | 'team'
statusstring[]

Repeat for several, at most four.

team_idstring

A team, or none for the tickets in no team.

assignee_idstring
prioritystring[]
tagstring
qstring

A ticket number (#1042 or 1042), or a requester's email address: the tickets of the requester it names, as requester_id lists them, and none for an address no requester holds.

requester_idstring

One requester's tickets, by the requester's id.

sort'last_activity' | 'oldest_waiting'
cursorstring

Continuation token from the previous page.

limitinteger

A page-size hint: a value above 100 reads as 100, and a missing, zero, negative or non-numeric one as 50.

Response

A page of the queue.

Changes

  • a9a10e328ba5Revision changes
    • info

      the response property / became required for the status

    • info

      the response property / became required for the status

    • info

      the response property / became required for the status

    • info

      the response property / became required for the status

    • info

      the response property became required for the status

    • info

      the response property became required for the status

    • info

      the response property became required for the status

    • info

      the response property became required for the status

    • info

      the response property / became required for the status

    • info

      the response property / became required for the status

    • info

      the response property / became required for the status

    • info

      the response property / became required for the status

    • info

      added the required property / to the response with the status

    • info

      added the required property / to the response with the status

    • info

      added the required property / to the response with the status

    • info

      added the required property / to the response with the status

  • 56d7c265a77aRevision changes
    • breaking

      the response property / became nullable for the status

    • breaking

      the response property / became nullable for the status

    • breaking

      the response property / became nullable for the status

    • breaking

      the response property / became nullable for the status