List audit events

GET/v1/directory/events

Lists what changed in your organization's directory and who changed it, newest first.

Permission: identity:GetSettings

Returns

200 OK

{
  "events": [
    {
      "actor_kind": "person",
      "actor_id": "1e2d3c4b-5a69-4788-9a0b-1c2d3e4f5a6b",
      "action": "person.invited",
      "target": "8f0c2c1e-6b1a-4f3e-9a51-0c3d2f7e9b10",
      "reason": "",
      "at": "2026-11-19T09:00:00Z"
    }
  ]
}

Query parameter limit: how many to return, 1 to 500; 100 if you don't say.

Example

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

With yottactl

yottactl org events list