#AuditExport

---

#GET /orgs/{orgId}/audit-export/config

Get the audit-export config

Org-scoped (admin/owner). Returns the masked S3 export config or 404 when not configured.

Auth: Bearer token required

Path parameters

Name	Type	Description
orgId	string

Responses

Status	Description	Schema
200	Audit-export config (roleArn masked)	AuditExportConfig
404	Not configured	Error

---

#POST /orgs/{orgId}/audit-export/config

Upsert the audit-export config

Org-scoped (admin/owner). Create or update the S3 audit-export configuration.

Auth: Bearer token required

Path parameters

Name	Type	Description
orgId	string

Request body (application/json)

Field	Type	Description
bucket	string	(required)
region	string	(required)
roleArn	string	(required)
enabled	boolean

Responses

Status	Description	Schema
201	Stored config	AuditExportConfig
404	Org not found	Error

---

#POST /orgs/{orgId}/audit-export/test-connection

Test the audit-export S3 connection

Org-scoped (admin/owner). Performs a write+delete dry-run against the configured/provided bucket.

Auth: Bearer token required

Path parameters

Name	Type	Description
orgId	string

Request body (application/json)

Field	Type	Description
bucket	string	(required)
region	string	(required)
roleArn	string	(required)
enabled	boolean

Responses

Status	Description	Schema
200	Connection test result	AuditExportTestResult
404	Org not found	Error

---

#GET /orgs/{orgId}/audit-export/runs

List audit-export runs

Org-scoped (admin/owner). Returns recent export batch runs, newest-first.

Auth: Bearer token required

Path parameters

Name	Type	Description
orgId	string

Responses

Status	Description	Schema
200	Export runs	AuditExportRunList
404	Org not found	Error

#Schemas

#AuditExportConfig

Field	Type	Description
id	string	(required)
orgId	string	(required)
bucket	string	(required)
region	string	(required)
roleArnMasked	string	(required)
enabled	boolean	(required)
lastTestedAt	string,null	(required)
lastTestOk	boolean,null	(required)
lastError	string,null	(required)
lastExportedAt	string,null	(required)
createdAt	string	(required)
updatedAt	string	(required)

#AuditExportRunList

Type: object[]

#AuditExportTestResult

Field	Type	Description
success	boolean	(required)
error	string

#Error

Field	Type	Description
error	string	(required)
code	string