/Docs
Search docs or ask a question⌘K
DocsAgent
Changelog
API Reference List Audit Entries

List Audit Entries

Retrieve the audit trail of actions taken in a project

GET/v1/projects/{projectId}/audit-logTry it
Session token

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.

Plan availability

The audit log is a paid feature, and how far back you can read depends on the workspace's plan. The window is applied on the server, so entries outside it are never returned, whatever you ask for.

PlanHistory returnedactor filterExport
FreeNone — 402 plan_required (feature: audit_log, requiredTier: starter)——
StarterLast 7 days402 (feature: audit_actor_filter)402 (feature: audit_export)
ProLast 365 daysYesYes
EnterpriseUnlimitedYesYes

See Plan errors for the 402 body.

Path Parameters

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

Query Parameters

NameDescription
page:integerquery
Page number for pagination.
Default1
limit:integerquery
Number of entries per page. Maximum: 100.
Default50
actor:stringquery
Filter by actor email (case-insensitive substring match), e.g. jane@. Pro or higher — on Starter, sending actor returns 402 plan_required.
resource:stringquery
Filter by resource type, e.g. settings, build, domain, api_key, webhook, audience, page, approval_gate, glossary, project, content, asset, change, org_theme.

Response

NameDescription
data:array
Array of audit entry objects.
Show 7 child attributesarray
hasMore:boolean
true when more pages are available.
total:integer
The number of entries that match the same actor and resource filters inside your plan's window — across all pages, not just this one. Use it to render page counts.

Recorded Actions

ActionResource typeWhen
settings.updatedsettingsProject settings changed
project.deletedsettingsProject deleted
api_key.created / api_key.rotated / api_key.revokedapi_keyAPI key lifecycle
domain.added / domain.removeddomainCustom domain changes
build.triggeredbuildManual build trigger
build.cancelledbuildA build was cancelled
deployment.promotebuildA preview deploy was promoted
deployment.rollbackbuildA rollback was queued — the target is the new build
page.deletepageA page was deleted in the editor
approval_gate.update / approval_gate.deleteapproval_gateApproval gate edited or deleted
glossary.importglossaryGlossary terms imported from CSV
ownership_alerts.updateprojectStale-page alert settings changed
audience.created / audience.updated / audience.deletedaudienceAudience profile changes
webhook.created / webhook.deletedwebhookWebhook endpoint changes
webhook.secret_rotatedwebhookAn endpoint's signing secret was rotated. The secret is never logged
content.restore / content.importcontentHosted content restored or imported
brand_asset.uploadedprojectA logo or favicon was uploaded
appearance.published / appearance.previewed / appearance.v2_previewedprojectAppearance changes published or previewed, or a doc engine v2 preview built
home.convertpageA generated home page was converted to home components
org_theme.appliedorg_themeAn organization theme was applied to the project
source.github.connected / source.github.disconnected / source.github.pull_request_opened / source.github.link_cancelledprojectThe project's GitHub repository was connected or disconnected
mcp.<tool> — e.g. mcp.create_page, mcp.update_page, mcp.delete_page, mcp.upload_imagepage, change, build or assetA change made through the MCP connector
Was this page helpful? Yes No
Request
bashJavaScriptPythonGoRubyPHPJavaC#bash
curl "https://api.syntext.dev/v1/projects/3f2a9c1e-8b4d-4e7a-9c21-5d6e7f8a9b0c/audit-log?resource=api_key&limit=25" \
-H "Authorization: Bearer $SYNTEXT_TOKEN"
Responseapplication/json
json
{
"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", "ip": "203.0.113.24" },
"ipAddress": "203.0.113.24",
"createdAt": "2026-07-12T09:30:00.000Z"
}
],
"hasMore": false,
"total": 1
}
Product
Resources
Company
© 2026 SyntextBuilt with Syntext