Central API — office security and governance events
GET/tenants/{tenant_id}/office/audit
Returns the office security and governance audit event timeline for a specific tenant. Events include template publishes, permission changes, failed render attempts, and format conversion requests. Use for compliance reporting or SOC 2 evidence gathering.
Request
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
tenant_id | string | Yes | The tenant identifier. |
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
from | string (date) | No | Start date for the audit event range (inclusive, ISO 8601 date). |
to | string (date) | No | End date for the audit event range (inclusive, ISO 8601 date). |
event_type | string | No | Filter by event type (e.g. "template_published", "render_failed"). |
Responses
200 Office audit event timeline
Content type application/json, array of object · OfficeAuditEventV1.
| Field | Type | Required | Description |
|---|---|---|---|
id | integer | No | |
event_type | string | No | Machine-readable event type identifier (e.g. "template_published", "render_failed"). |
tenant_id | string | No | The tenant this event belongs to. |
subject_id | integer, nullable | No | ID of the primary subject record (e.g. template ID, job ID). |
actor_id | integer, nullable | No | ID of the user or system actor who triggered the event. |
metadata | object | No | Additional contextual data relevant to the event type. |
occurred_at | string (date-time) | No |
Example
[
{
"id": 441,
"event_type": "template_published",
"tenant_id": "acme",
"subject_id": 3,
"actor_id": 5,
"metadata": {
"version": 4,
"template_name": "Standard Invoice Template"
},
"occurred_at": "2026-03-15T14:00:00Z"
}
]
404 Tenant not found
Example request
curl -X GET "https://{tenant}.faciotech.net/api/v1/tenants/{tenant_id}/office/audit" \
-H "Accept: application/json"