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