get https://api.talkdeskapp.com/guardian/users//roles
Scope
guardian-users:read
Body Response - Schema
200 (paginated list of agent role changes)
| Parameter | Type | Description | Required |
|---|---|---|---|
| _embedded | array[object] | "_embedded" subdivides into: 1 - "assigned_at" (string) - the role attribution timestamp. Example: 2020-02-01T10:00:00.000Z 2 - "assigned_by" (string) - the agent name that did the role attribution. Example: John Doe 3 - "role" (string) - the agent role. Example: Administrator 4 - "id" (string) - the user ID. Example: 669d7b6a54dd4e73b219e48a56109cc5 | no |
| _links | object | "_links" subdivides into: 1 - "first" (object) - the first page link. 1.1 - "href" (string) - the hypertext reference describing this link. Example: https://guardian.talkdesk.org/atlas/guardian/dashboards?page=1&per_page=10 2 - "last" (object) - the last page link. 2.1 - "href" (string) - the hypertext reference describing this link. Example: https://guardian.talkdesk.org/atlas/guardian/dashboards?page=1&per_page=10 3 - "next" (object) - the next page link. 3.1 - "href" (string) - the hypertext reference describing this link. Example: https://guardian.talkdesk.org/atlas/guardian/dashboards?page=1&per_page=10 4 - "prev" (object) - the previous page link. 4.1 - "href" (string) - the hypertext reference describing this link. Example: https://guardian.talkdesk.org/atlas/guardian/dashboards?page=1&per_page=10 5 - "self" (object) - the current page link. 5.1 - "href" (string) - the hypertext reference describing this link. Example: https://guardian.talkdesk.org/atlas/guardian/dashboards?page=1&per_page=10 6 - "show" (object) - show alarms link. 6.1 - "href" (string) - the hypertext reference describing this link. Example: https://guardian.talkdesk.org/atlas/guardian/dashboards?page=1&per_page=10 | no |
| count | integer | The number of results in the current page. Example: 10 | no |
| page | integer | The current page. Example: 10 | no |
| per_page | integer | The number of results per page. Example: 10 | no |
| total | integer | The total number of results. Example: 10 | no |
| total_page | integer | The total number of pages. Example: 5 | no |
400 (bad request), 401 (unauthorized), 403 (forbidden), 404 (not found), 406 (not acceptable)
| Parameter | Type | Description | Required |
|---|---|---|---|
| code | string | n/a | yes |
| message | string | n/a | yes |
| description | string | n/a | no |
| fields | array[object] | "fields" subdivides into: "name" (string) "description" (string) | yes (name and description) |
Troubleshooting
If you have any questions regarding the usage of this API, or if you’re having any technical issues, please open a ticket using this form.