List Audit Entries

Returns a paginated, newest-first list of audit entries for a project. Every state-changing action taken through the dashboard or API — settings updates, API key lifecycle events, custom domain changes, manual build triggers, audience profile changes, and webhook endpoint changes — is recorded automatically.

GET/v1/projects/{projectId}/audit-log

Path Parameters

The project to read audit entries for. The caller must be a member of the organization that owns the project.

Query Parameters

Page number for pagination.

Number of entries per page. Maximum: 100.

Filter by actor email (case-insensitive substring match), e.g. jane@.

Filter by resource type. One of: settings, build, domain, api_key, webhook, audience.

Response

Array of audit entry objects.

Unique audit entry identifier.

What happened, e.g. settings.updated, api_key.created, domain.removed, build.triggered.

Who performed the action: id, name, and email. Fields are empty strings when the actor account was deleted.

What was acted on: type, id, and an optional human-readable name (e.g. the domain or API key name).

Action-specific details, such as the fields changed in a settings update.

ISO 8601 timestamp of when the action happened.

true when more pages are available.

Example Request

curl "https://api.syntext.dev/v1/projects/prj_abc123/audit-log?resource=api_key&limit=25" \
  -H "Authorization: Bearer $SYNTEXT_TOKEN"

Example Response

{
  "data": [
    {
      "id": "log_9f2c1e",
      "action": "api_key.created",
      "actor": { "id": "usr_1", "name": "Jane Doe", "email": "jane@example.com" },
      "resource": { "type": "api_key", "id": "key_42", "name": "CI Key" },
      "metadata": { "name": "CI Key", "scope": "build" },
      "createdAt": "2026-07-12T09:30:00.000Z"
    }
  ],
  "hasMore": false
}

Recorded Actions

Action	Resource type	When
`settings.updated`	`settings`	Project settings changed
`project.deleted`	`settings`	Project deleted
`api_key.created` / `api_key.rotated` / `api_key.revoked`	`api_key`	API key lifecycle
`domain.added` / `domain.removed`	`domain`	Custom domain changes
`build.triggered`	`build`	Manual build trigger
`audience.created` / `audience.updated` / `audience.deleted`	`audience`	Audience profile changes
`webhook.created` / `webhook.deleted`	`webhook`	Webhook endpoint changes

Was this page helpful?