get https://api.talkdeskapp.com/scim/v2/Users
Queries multiple user identities in an authenticated account. Filtering is available.
Scope
scim
Body Response - Schema
200 OK (the request has succeeded)
Collection of users
| Parameter | Type | Description | Required |
|---|---|---|---|
| schemas | array[string] | URN schema for ListReponse. Allowed values: urn:ietf:params:scim:api:messages:2.0:ListResponse / urn:ietf:params:scim:schemas:extension:talkdesk:2.0:User | yes |
| Resources | array[object] | "resources" subdivides into: 1 - "schemas" (array[string]) - URN schemas for user resource. Allowed value: urn:ietf:params:scim:schemas:core:2.0:User 2 - "id" (string) - the ID for the object. Immutable. Required. 3 - "active" (boolean) - the user's administrative status. Required. 4 - "externalId" (string) - the external ID for the user. 5 - "meta" (object) - user metadata. 5.1 - "created" (string ) - date and time the resource was created. 5.2 - "lastModified" (string) - date and time the resource was last modified. 5.3 - "resourceType" (string) - the resource type. 5.4 - "location" (string) - the location (URI) of the resource. 5.5 - "version" (string) - the version of the resource. 6 - "name" (object) - the components of the user's real name. Required. 6.1 - "familyName" (string) - the components of the user's real name. The family name of the User, or Last Name in most Western languages (for example, Jensen given the full name Ms. Barbara J Jensen, III.). Required. 6.2 - "givenName" (string) - the given name of the User, or First Name in most Western languages. Required. 7 - "userName" (string) - the user's email. Required. | yes |
| totalResults | integer | the number of users in the collection | yes |
| startIndex | integer | the 1-based index of the first result in the current set of list results | yes |
| itemsPerPage | integer | the number of resources returned in a list response page | yes |
401 (missing or invalid authorization), 403 (forbidden operation)
SCIM-related error
| Parameter | Type | Description | Required |
|---|---|---|---|
| schemas | array[string] | URN schema for errors. Allowed value: urn:ietf:params:scim:api:messages:2.0:Error | yes |
| status | string | HTTP status code | yes |
| detail | string | message detailing the error | yes |
| scimType | string | type of SCIM error | no |
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.