Delete a user

DELETE/v1/directory/people/{person_id}

Removes someone from your organization: their sessions end, and their roles, apps and group memberships go. This can't be undone.

Permission: identity:DeleteUser. Changes need a sign-in that used a second factor.

Path parameters

Parameter Type Description
person_id string The person's ID.

Returns

204 No Content, with no body.

Errors

Besides the errors every call can return:

Status When
404 No such resource in your organization.
409 You can't delete yourself, or it would leave your organization with no administrator.

Example

curl -X DELETE https://<company>.yotta.bot/v1/directory/people/8f0c2c1e-6b1a-4f3e-9a51-0c3d2f7e9b10 \
  -H "Authorization: Bearer $YOTTABOT_TOKEN"

With yottactl

yottactl org users delete 8f0c2c1e-6b1a-4f3e-9a51-0c3d2f7e9b10