Admin Events API

The Admin Events API exposes a chronological log of administrative actions taken within your organization. Events are recorded for actions such as agent registration, member invitations, webhook management, and workspace creation. Use this endpoint to power compliance dashboards, security investigations, and audit reports.

List Admin Events

GET

/v1/admin/events

Return recent administrative events for the current organization, ordered by creation time descending.

Auth: compliance_auditor

Query Parameters

Field	Type	Required	Description
limit	number	No	Maximum number of events to return. Integer between 1 and 100. Defaults to 20.

Example Request

bash

curl "https://api.elydora.com/v1/admin/events?limit=50" \
  -H "Authorization: Bearer <token>"

Response

json

{
  "events": [
    {
      "event_id": "0195a5f6-a7b8-7c9d-e0f1-a2b3c4d5e6f7",
      "org_id": "0195a0b1-c2d3-7e4f-a5b6-c7d8e9f0a1b2",
      "actor": "0195a0b1-c2d3-7e4f-a5b6-c7d8e9f0a1b2",
      "action": "webhook.register",
      "target_type": "webhook",
      "target_id": "0195a1b2-c3d4-7e5f-a6b7-c8d9e0f1a2b3",
      "details": {
        "endpoint_url": "https://hooks.acme.com/elydora",
        "events": ["operation.accepted", "epoch.created"]
      },
      "created_at": 1740700800000
    },
    {
      "event_id": "0195a4e5-f6a7-7b8c-d9e0-f1a2b3c4d5e6",
      "org_id": "0195a0b1-c2d3-7e4f-a5b6-c7d8e9f0a1b2",
      "actor": "0195a0b1-c2d3-7e4f-a5b6-c7d8e9f0a1b2",
      "action": "member.invite",
      "target_type": "member",
      "target_id": "carol@acme.com",
      "details": {
        "email": "carol@acme.com",
        "role": "compliance_auditor"
      },
      "created_at": 1740697200000
    },
    {
      "event_id": "0195a3d4-e5f6-7a7b-c8d9-e0f1a2b3c4d5",
      "org_id": "0195a0b1-c2d3-7e4f-a5b6-c7d8e9f0a1b2",
      "actor": "0195a0b1-c2d3-7e4f-a5b6-c7d8e9f0a1b2",
      "action": "org.create",
      "target_type": "organization",
      "target_id": "0195a0b1-c2d3-7e4f-a5b6-c7d8e9f0a1b2",
      "details": {
        "name": "Acme Corp",
        "type": "organization"
      },
      "created_at": 1740693600000
    }
  ]
}

Event Action Types

Field	Type	Required	Description
org.create	string	No	A new organization or personal workspace was created during onboarding.
member.invite	string	No	A user was invited to the organization.
webhook.register	string	No	A webhook endpoint was registered.
agent.freeze	string	No	An agent was frozen by a security administrator.
agent.unfreeze	string	No	A previously frozen agent was restored to active status.
agent.revoke_key	string	No	An agent signing key was revoked.