Audit API
The audit log
GET /orgs/{org}/audit
Audit events you can see, newest first.
Parameters
| Name | In | Type | Description |
|---|---|---|---|
org required | path | string | The org slug. |
actor | query | string (uuid) | Only events by this actor. |
action | query | string | Only this action, or a prefix ending in * (secret.*). |
resource | query | string (uuid) | Only events about this resource. |
space | query | string (uuid) | Only events in this space. |
task | query | string (uuid) | Only events for this task. |
from | query | string (date-time) | Events at or after. |
to | query | string (date-time) | Events before. |
limit | query | integer (int32) | Page size (default 50, max 200). |
cursor | query | string | The next_cursor of the previous page. |
Responses
200- OK. Paged_AuditEntry
application/json
GET /orgs/{org}/audit/anchors
Published daily anchors (admins).
Parameters
| Name | In | Type | Description |
|---|---|---|---|
org required | path | string | The org slug. |
Responses
200- OK. Paged_Anchor
application/json
GET /orgs/{org}/audit/export
Streams the log as JSONL or CSV (admins). The export itself is audited.
Parameters
| Name | In | Type | Description |
|---|---|---|---|
org required | path | string | The org slug. |
format | query | ExportFormat | jsonl (default) or csv. |
from | query | string (date-time) | From (inclusive). |
to | query | string (date-time) | To (exclusive). |
Responses
200- JSONL or CSV.
application/x-ndjson
GET /orgs/{org}/audit/verify
Recomputes the hash chain and reports the first break (admins). A break alerts every admin.
Parameters
| Name | In | Type | Description |
|---|---|---|---|
org required | path | string | The org slug. |
from | query | string (date-time) | From (inclusive). |
to | query | string (date-time) | To (exclusive). |
Responses
200- OK. VerifyReport
application/json