ChangeVault
API Reference

Activity log

Query the organization activity log to see who did what and when.

The activity log records every significant action taken in your organization — changes logged, members invited, roles updated, integrations configured and more.

The activity log is only accessible via browser session (dashboard). It is not available to API keys.

List activity

GET /api/activity

Query parameters

ParameterTypeDescription
limitintegerNumber of entries to return (default: 50, max: 100)
offsetintegerPagination offset
resourcestringFilter by resource type (see below)
actor_idstringFilter by actor. Pass __api_key__ to show only API key actions

Resource types

ValueDescription
changeChanges logged, updated or deleted
serviceServices created or updated
hostHosts created or updated
memberMembers invited, removed or role changed
api_keyAPI keys created or revoked
subscriptionService subscriptions started or stopped
integrationSlack, Teams, Grafana or webhook connections

Example

curl "https://app.changevault.dev/api/activity?limit=20&resource=change" \
  -H "Cookie: ..."

Response

{
  "items": [
    {
      "id": "uuid",
      "actor_id": "user_abc123",
      "actor_name": "Alice Smith",
      "action": "created",
      "resource_type": "change",
      "resource_id": "uuid",
      "resource_label": "Deployed api-service v3.1.0",
      "metadata": {},
      "created_at": "2025-04-07T10:00:00Z"
    }
  ]
}

List actors

Returns the list of distinct actors (users and API keys) that have entries in the activity log. Used to populate the actor filter dropdown.

GET /api/activity/actors

Response

{
  "actors": [
    { "actor_id": "user_abc123", "actor_name": "Alice Smith" },
    { "actor_id": null, "actor_name": "API key" }
  ]
}

Pass actor_id=__api_key__ to the /api/activity endpoint to filter for API key actions (where actor_id is null).

On this page