List users

GET/v1/directory/people

Lists everyone in your organization: invited, active and suspended.

Permission: identity:ListUsers

Returns

200 OK

{
  "people": [
    {
      "id": "8f0c2c1e-6b1a-4f3e-9a51-0c3d2f7e9b10",
      "email": "pat@example.com",
      "username": "patlee",
      "name": "Pat Lee",
      "given_name": "Pat",
      "family_name": "Lee",
      "status": "active",
      "email_verified": true,
      "last_sign_in_at": "2026-11-19T10:12:00Z",
      "mfa_devices": 1,
      "profile_managed": false,
      "created_at": "2026-11-19T09:00:00Z",
      "updated_at": "2026-11-19T09:00:00Z"
    }
  ]
}

Example

curl https://<company>.yotta.bot/v1/directory/people \
  -H "Authorization: Bearer $YOTTABOT_TOKEN"

With yottactl

yottactl org users list