When a user is assigned to staff a queue, he/she is then said to be assigned to staff that queue. Also see operators.
LibraryH3lp supports cookie-based authentication. To learn more, you can read the details on authentication.
Requests are served over HTTPS. To ensure data privacy, unencrypted HTTP is not supported.
An assignment instance resource represents a single operator assignment to a given queue and managed by the user account provided during authentication.
/2011-12-03/users/8451/assignments/{QueueId}
An Assignment resource is represented by the following properties:
| Property | Description |
|---|---|
| queueId | The integer identifier for the queue to which a user is assigned as an operator. |
| queue | String of up to 60 characters which serves as the queue's descriptive name and the node for a queue's JID (Jabber ID). |
| queueShow | String reflecting the current availability of the queue to which the operator is assigned for chat. Possible values are "chat", "available", "dnd", "away", "xa", "unavailable". The Presence API also provides this information. |
| userId | The integer identifier for the user. |
| user | String of up to 40 characters which serves as the user's username and the node for a user's JID. |
| userShow | String reflecting the current availability of the user. Possible values are "chat", "available", "dnd", "away", "xa", "unavailable". The Presence API also provides this information. |
| enabled | Boolean. If true, the operator's availability contributes to the collective availability of the queue and is able to receiving incoming chats on the queue. If null, the operator is suspended from queue participation. When created, an operator defaults to enabled = true. |
Not supported.
Not supported.
Allows you to modify the properties of an assignment.
You may include, as JSON PUT data, any of the following properties.
| Properties | Description |
|---|---|
| enabled | Boolean. If true, the operator's availability contributes to the collective availability of the queue and is able to receiving incoming chats on the queue. If null, the operator is suspended from queue participation. |
Always returns a representation of the assignment resource. If a parameter contains an illegal value, the illegal value is ignored and the original value retained and returned in the representation.
PUT //users/8451/assignments/34814
{
"enabled": null
}
[
{
"queueId": 34814
"queue": "example-queue",
"queueShow": "unavailable",
"userId": 8451,
"user": "example-user",
"userShow": "unavailable",
"enabled": null
}
]
Allows you to unassign an operator from a queue.
Returns a JSON response with the following properties:
| Property | Description |
|---|---|
| success | Boolean indicating if the request was successful. |
| message | Optional. If success is null, message is a string describing the reason for the failed request. |
DELETE /2011-12-03/users/8451/assignments/34814
{
"success": true
}
The Assignments list resource represents the set of Assignments for a given user managed by the user whose credentials were used to make the API request.
/2011-12-03/users/8451/assignments
Returns all the assignments for a give user who is managed by or was created by the user whose credentials were used to make the API request.
Returns a JSON response containing a list of Assignment resources.
GET /2011-12-03/users/8451/assignments
[
{
"queueId": 30826
"queue": "example-queue",
"queueShow": "unavailable",
"userId": 8451
"user": "test-user",
"userShow": "unavailable",
"enabled": true
}
]
Allows you to assign a user to a queue as an operator.
You must include, as JSON POST data, the following properties.
| Property | Description |
|---|---|
| queueId | The id for the queue to which you wish to assign the user as an operator. |
Returns a JSON response with the following properties:
| Property | Description |
|---|---|
| success | Boolean indicating if the request was successful. |
| message | Optional. If success is null, message is a string describing the reason for the failed request. |
POST /2011-12-03/users/8451/assignments
{
"queueId": 12345
}
{
"success": true
}
Not supported.
Not supported.