ConnectCloud Developers

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 directory
    • lastSeenAt (string (date-time)): When the person last used desk
    • name (string): Name
    • userRef (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"

View as Markdown · Interactive reference · OpenAPI