# Get queue

`GET` `/api/v1/crm-connections/{crm_connection_id}/queues/{queue_id}`

Returns the full configuration for a Gradient Works queue, its queue
user members, the round-robin slot ordering, and any target books
served by the queue. All of these are fetched in one Salesforce call
via parent + subqueries.

## Path parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| crm_connection_id | string | yes | UUID of the CRM connection |
| queue_id | string | yes | Salesforce ID of the queue |

## Response

`200 OK` — `application/json`

| Field | Type | Description |
|-------|------|-------------|
| queue | object | Queue configuration |
| queue.id | string | Salesforce ID of the queue record |
| queue.name | string | Queue name |
| queue.type | string | Raw value of the Salesforce Type__c field. Typically null (standard queue) or 'Target Book' (target book queue); other values may appear if set directly in Salesforce. |
| queue.assignment_policy | string | Assignment policy: Adaptive, Round Robin, or Schedule First Available |
| queue.assignment_field | string | Field on the assigned record that stores the assigned user |
| queue.capacity_meter | object | Linked capacity meter (null if none) |
| queue.capacity_meter.id | string | Salesforce ID of the capacity meter |
| queue.capacity_meter.name | string | Capacity meter name |
| queue.last_assignment_time | string | ISO-8601 timestamp of the most recent assignment |
| queue.next_slot_index | number | Next round-robin slot index |
| queue.post_assignment_automation | string | API name of a Flow to execute after assignments complete for this queue |
| queue.async_assignment | boolean | Whether assignments for this queue are always performed asynchronously. Target book queues always use asynchronous assignment. |
| queue.standard_queue_id | string | Salesforce ID of the linked standard Group (Queue) |
| queue.user_weight_field | string | Field on User used to weight round-robin distribution |
| queue.user_maximum_capacity | number | Default maximum capacity per user for this queue's members |
| queue.user_maximum_capacity_field | string | DEPRECATED — name of the field on User formerly used to source per-user maximum capacity. No longer read by the managed package; retained for troubleshooting only. |
| queue.user_used_capacity_field | string | DEPRECATED — name of the field on User formerly used to source per-user used capacity. No longer read by the managed package; retained for troubleshooting only. |
| queue.created_at | string | ISO-8601 creation timestamp |
| queue.updated_at | string | ISO-8601 last-updated timestamp |
| queue_users | array[object] | Queue user members of this queue, sorted ascending by the linked Salesforce User's Name. Empty list when the queue has no members. |
| queue_users.id | string | Salesforce ID of the queue user record |
| queue_users.user | object | Linked Salesforce User (id + name). Null when the underlying Salesforce User has been deleted. |
| queue_users.user.id | string | Salesforce ID of the referenced record |
| queue_users.user.name | string | Display name (null if the relationship is empty) |
| queue_users.status | string | Raw Salesforce Status__c value: 'Available' or 'Unavailable' |
| queue_users.weight | integer | Round-robin weight (higher weight yields more queue slots) |
| queue_users.last_assignment_time | string | ISO-8601 timestamp of the most recent assignment |
| queue_users.maximum_capacity | number | Per-user maximum capacity for this queue |
| queue_users.used_capacity | number | Currently used capacity |
| queue_users.available_capacity | number | Remaining capacity (formula field; null when capacity fields are unset) |
| queue_users.target_book | object | Target book this queue user is tied to, if any. Null when unset or when the underlying target book was deleted. |
| queue_users.target_book.id | string | Salesforce ID of the target book |
| queue_users.target_book.name | string | Target book name (null if the target book was deleted) |
| queue_users.working_hours_start | string | Start of working hours window |
| queue_users.working_hours_end | string | End of working hours window |
| queue_users.unavailable_until_time | string | If set, the user is marked unavailable until this ISO-8601 timestamp |
| queue_users.skip_next_times | number | Number of upcoming round-robin turns this user will skip |
| queue_slots | array[object] | Round-robin slot ordering, sorted ascending by slot index. A queue user with weight > 1 occupies more than one slot. Join slots back to members via queue_user.id == queue_users[].id. |
| queue_slots.index | integer | 0-based round-robin slot index |
| queue_slots.queue_user | object | The queue user that occupies this slot. `id` is the queue user ID (join against queue_users[].id); `name` is the linked Salesforce User's Name. |
| queue_slots.queue_user.id | string | Salesforce ID of the referenced record |
| queue_slots.queue_user.name | string | Display name (null if the relationship is empty) |
| target_books | array[object] | Active target books served by this queue, sorted ascending by name. Always empty for standard queues (type != 'Target Book'). |
| target_books.id | string | Salesforce ID of the target book |
| target_books.name | string | Target book name (null if the target book was deleted) |

## Errors

| Status | Description |
|--------|-------------|
| 400 | Bad Request |
| 403 | Forbidden |
| 404 | Not Found |
| 422 | Unprocessable Entity |
| 502 | Bad Gateway |