Qodex.ai

List users under a label

GET {{baseUrl}}/api/v1/labels/:label_id/users

This API lists a particular number of users under a label, based on the limit defined.

OAuth Scope

  • Desk.search.READ
  • Desk.contacts.READ
  • Desk.settings.READ

Request Params

KeyDatatypeRequiredDescription
fromstringIndex number, starting from which the users must be fetched. The default value is 1.
limitstringNumber of users to list. The default value is 50 and the maximum value allowed is 100
sortBystringKey that sorts the list of users by a specific attribute: -(assignedTime)
searchBystringSearch keyword to use for finding a particular user. The keyword must contain at least two characters.

HEADERS

KeyDatatypeRequiredDescription
Authorizationstring

RESPONSES

status: OK

{"data":[{"photoUrl":null,"emailAddress":"carol@zylker.com","name":"svega RM","userType":"ENDUSER","assignee":{"photoUrl":"https://desk.zoho.com/portal/api/user/6000000015895/photo?orgId=143315","name":"Chris","id":"6000000015895"},"id":"6000000032907","assignedTime":"2019-08-09T07:47:44.000Z","status":"ACTIVE"}]}