Skip to content

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

NameTypeRequiredDescription
tenant_idstringYes

The tenant identifier.

Query parameters

NameTypeRequiredDescription
fromstring (date)No

Start date for the audit event range (inclusive, ISO 8601 date).

tostring (date)No

End date for the audit event range (inclusive, ISO 8601 date).

event_typestringNo

Filter by event type (e.g. "template_published", "render_failed").

Responses

200 Office audit event timeline

Content type application/json, array of object · OfficeAuditEventV1.

FieldTypeRequiredDescription
idintegerNo
event_typestringNo

Machine-readable event type identifier (e.g. "template_published", "render_failed").

tenant_idstringNo

The tenant this event belongs to.

subject_idinteger, nullableNo

ID of the primary subject record (e.g. template ID, job ID).

actor_idinteger, nullableNo

ID of the user or system actor who triggered the event.

metadataobjectNo

Additional contextual data relevant to the event type.

occurred_atstring (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"
Loading