DocumentationREST APIAPI Reference

Audit logs

GETList audit logs

List flag change history with optional flag and event filters

GET/v1/projects/{projectId}/audit-logs
List audit logs
curl --request GET \
  --url 'http://localhost:4000/v1/projects/{projectId}/audit-logs?flagKey=%3Cstring%3E&event=%3Cstring%3E' \
  --header 'Authorization: Bearer <token>'
200
application/json
{}

List audit logs

Use this endpoint to retrieve a project’s flag change history when you need to inspect changes to flag definitions or targeting. Each entry identifies the actor and includes before and after snapshots, allowing callers to see what changed; create entries have no before snapshot, and delete entries have no after snapshot. Filter results by a flag key or by the event types flag.created, flag.updated, flag.deleted, and targeting.updated.

Results are returned newest first. The limit filter defaults to 50 entries and accepts positive integer values up to 200.

Authentication

Authorizationbearerrequired

Server API key (srv_). See Authentication.

Path Parameters

projectIdstringrequired

Project ID

Query Parameters

flagKeystring

Filter by flag key

eventstring

Filter by audit event type Allowed values: flag.created, flag.updated, flag.deleted, targeting.updated.