List audit log entries
Lists the changes made to the project's configuration, newest first, optionally only those of one entityType, entityId or parentEntityId.
Needs permission to read the project's audit log (project:audit:read).
Guide: Audit log
A project secret key: vh_sk_... for production, vh_sk_test_... for test. Keep it on your servers.
In: header
Path parameters
The project's id, proj_.... A secret key works only in the project it belongs to.
Query parameters
Where the page starts: the pageInfo.endCursor of the previous page. Omit it for the first page.
How many items to return, from 1 to 100. Defaults to 50.
1 <= value <= 100Only entries about this kind of entity, such as product, paywall, feature_flag or api_key.
Only entries about the entity with this id.
Only entries about entities that belong to this one, such as every build of a paywall.
Examples
curl -X GET "https://api.voidhash.com/api/v1/projects/proj_tz4a98xxat96iws9zmbrgj3a/audit-log?entityType=feature_flag&entityId=ff_v8b3n5q0w2e7h7d2k9m4x1c6" \ -H "Authorization: Bearer vh_sk_..."{ "data": [ { "id": "audit_r5t1y7u3i9o2p6a0s4d8f2g6", "projectId": "proj_tz4a98xxat96iws9zmbrgj3a", "entityType": "feature_flag", "entityId": "ff_v8b3n5q0w2e7h7d2k9m4x1c6", "parentEntityId": null, "action": "updated", "actorType": "user", "actorUserId": "user_k3m8q1z6v9c2x5b7n4w0e8r1", "changes": { "before": { "isEnabled": true, "rolloutPercentage": 25 }, "after": { "rolloutPercentage": 50 } }, "metadata": null, "createdAt": "2026-03-09T08:30:00.000Z" } ], "pageInfo": { "endCursor": null, "hasNextPage": false }}{ "error": { "type": "invalid_request", "code": "invalid_query", "message": "The request query is invalid: Expected a finite number\n at [\"limit\"]" }}{ "error": { "type": "unauthenticated", "code": "invalid_api_key", "message": "This secret key is not valid." }}{ "error": { "type": "permission_denied", "code": "permission_denied", "message": "Insufficient permissions." }}{ "error": { "type": "not_found", "code": "project_not_found", "message": "There is no project proj_tz4a98xxat96iws9zmbrgj3a, or this credential cannot use it.", "param": "projectId" }}{ "error": { "type": "internal", "code": "internal_error", "message": "Something went wrong on our side. Try again, and contact support with the Request-Id header if it keeps failing." }}Response body
application/json
application/json
application/json
application/json
application/json
application/json
Errors
This operation adds no error codes of its own. It can fail with the errors every operation shares, such as unauthenticated; see Errors.
Something wrong or missing on this page? Tell us by email or on Discord.