Users known to the desk (for pickers) (desk:read)
GET /api/desk/v1/people
Module: Desk · operationId: listPeople · Tag: Configuration · Auth: access token (Authorization: Bearer <accessToken>)
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
q |
query | string |
Responses
- 200 People (
application/json)
Fields of the 200 answer:
items(array of Person, required)active(boolean): Whether the person is active in the people directorylastSeenAt(string (date-time)): When the person last used deskname(string): NameuserRef(string): Login (e-mail)
Example 200 answer:
{
"items": [
{
"active": true,
"lastSeenAt": "2026-11-18T08:40:00Z",
"name": "Elias Gruber",
"userRef": "elias.gruber@muster-it.example"
},
{
"active": true,
"lastSeenAt": "2026-11-18T07:55:00Z",
"name": "Lukas Wimmer",
"userRef": "lukas.wimmer@muster-it.example"
},
{
"active": true,
"lastSeenAt": "2026-11-18T08:58:00Z",
"name": "Sophie Huber",
"userRef": "sophie.huber@muster-it.example"
}
]
}
Example request
curl -X GET 'https://api.mbcom.cloud/api/desk/v1/people' \
-H "Authorization: Bearer $ACCESS_TOKEN"