SynqDocs
Management APIOrgs

Download the org's audit log

Every entry between `since` and `until` (at most 366 days), oldest first: the org's own and every brand's, each with the brand it happened in (`brand`, its id and name, or null for the org's own), to keep a copy or for a security tool such as a SIEM. CSV, JSON or NDJSON, streamed. On every plan, as far back as the org's plan keeps entries (its `audit_retention_days` in `GET /v1/plans`: 7, 30 or 365 days, or for ever, then 366 days at a time). Needs `org.auditLog.export` across the org. Ten an hour for an org. Each export is recorded as `org.audit_log_exported`, with the window it covered.

GET/v1/orgs/{org}/audit-log/export

Every entry between since and until (at most 366 days), oldest first: the org's own and every brand's, each with the brand it happened in (brand, its id and name, or null for the org's own), to keep a copy or for a security tool such as a SIEM. CSV, JSON or NDJSON, streamed. On every plan, as far back as the org's plan keeps entries (its audit_retention_days in GET /v1/plans: 7, 30 or 365 days, or for ever, then 366 days at a time). Needs org.auditLog.export across the org. Ten an hour for an org. Each export is recorded as org.audit_log_exported, with the window it covered.

Authorization

bearer
AuthorizationBearer <token>

An org API key (sk_live_…, sk_test_…), or an access token from the Synq issuer (the synq brand, on the accounts host) for this API.

In: header

Path Parameters

org*string

The org's id

Match^org_[0-9a-hjkmnp-tv-z]{26}$

Query Parameters

since?string

From this time on, inclusive. Left out, or before the oldest entry the org's plan keeps: from that oldest entry (the plan's audit_retention_days back), or 366 days before until on a plan that keeps entries for ever.

Formatdate-time
until?string

Up to this time, exclusive: now when left out, or when later. At most 366 days after since.

Formatdate-time
brand?string

Only this brand's entries. Left out: the org's own and every brand's.

format?string

ndjson: one JSON object a line, an audit event with its brand. json: one JSON array of them. csv: a header row, then one row an entry, metadata as JSON in its cell.

Default"ndjson"

Value in

  • "ndjson"
  • "json"
  • "csv"

Response Body

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X GET "https://api.synq.build/v1/orgs/org_01h455vb4pex5vsknk084sn02q/audit-log/export" \  -H "Authorization: Bearer $SYNQ_API_KEY"
[  {    "id": "aud_01h455vb4pex5vsknk084sn02q",    "created_at": "2026-10-21T12:00:00.000Z",    "action": "org.updated",    "actor": {      "type": "member",      "id": "usr_01h455vb4pex5vsknk084sn02q"    },    "act_client_id": "string",    "approval_id": "string",    "brand_id": "brd_01h455vb4pex5vsknk084sn02q",    "resource": {      "type": "org",      "id": "org_01h455vb4pex5vsknk084sn02q"    },    "metadata": {},    "ip": "string",    "user_agent": "string",    "org_id": "org_01h455vb4pex5vsknk084sn02q",    "brand": {      "id": "brd_01h455vb4pex5vsknk084sn02q",      "name": "Acme"    }  }]