Queues
Queue Listing
Queues are completely hidden from non-support users. You can add/remove discussions using the queue/unqueue actions on the discussion resource.
> curl -H "Accept: application/vnd.tender-v1+json" "https://USER:PASS@api.tenderapp.com/help/queues"
{
"offset": 0,
"total": 3,
"per_page": 30,
"named_queues": [
{QUEUE}, {QUEUE}, etc
]
}
Single Queue
> curl -H "Accept: application/vnd.tender-v1+json" "https://USER:PASS@api.tenderapp.com/help/queues/12345"
{
"name": "UI issues",
"permalink": "ui-issues",
"show_order": "last_updated",
"show_states": [
"new",
"open",
"assigned"
],
"notification_ids": [
"15077"
],
"created_at": "2009-02-10T07:00:25Z",
"updated_at": "2009-03-13T23:28:33Z",
"html_href": "https://help.tenderapp.com/dashboard/queues/12345",
"href": "https://api.tenderapp.com/help/queues/12345",
"discussions_href": "https://api.tenderapp.com/help/queues/12345/discussions{-opt|?|page,user_email}{-join|&|page,user_email}"
}
Attributes
- name - the name of the queue.
- permalink - the name used in queue URLs. This is auto-generated from the name if not already provided.
- show_order - The default order of discussions
in queues. The valid values are
queue,last_updated, andage. - ** show_states** - The discussion states to show in the queue
discussions query. See the discussions resource for more about
discussion states. This value must stay an array. The valid values
are
new,open,assigned, andresolved. - notification_ids - Array of user IDs that are notified when discussions are added to the queue.
- html_href - Web URL for the queue.
- href - API URL for the queue.
- discussions_href (readonly) - URI template for selecting all discussions in this queue. See the discussion resource for info on parsing the URI templates for discussions.
