Signals Docs
Signals API

Audit trail

A record of the changes made in your organization: who made each one and when. List it, or read one event in detail.


List the tenant-safe audit trail

GET
https://api.signals.pressone.africa
/audit

List the tenant-safe audit trail › query Parameters

actor
​string · enum
Enum values:
any
user
api_key
operator
system
kind
​string · enum

What changed: a kind group, or one automation target type (automation, automation_suppression, automation_batch).

Enum values:
any
trunks
numbers
credentials
seats
alerts
automation
automation_suppression
trunk_id
​string

One trk_ trunk id, or any for every trunk.

range
​string · enum
Enum values:
24h
7d
30d
all
cursor
​string
limit
​integer · int32 · min: 0

List the tenant-safe audit trail › Headers

Signals-Version
​string · enum · required

The supported API snapshot to use for this request.

Enum values:
2026-10-27

List the tenant-safe audit trail › Responses

One page of audit events.

as_of
​string · date-time · required
​AuditEvent[] · required
next_cursor
​string | null · required
previous_cursor
​string | null · required
retention_days
​integer · int64 · required
total
​integer · int64 · min: 0 · required
total_all
​integer · int64 · min: 0 · required

Explain one tenant-safe audit event

GET
https://api.signals.pressone.africa
/audit/{event_id}

Explain one tenant-safe audit event › path Parameters

event_id
​string · required

Audit event id

Explain one tenant-safe audit event › Headers

Signals-Version
​string · enum · required

The supported API snapshot to use for this request.

Enum values:
2026-10-27

Explain one tenant-safe audit event › Responses

The audit event with its changes and timeline.

​AuditFieldChange[] · required
​AuditEvent · required
notes
​string[] · required
supersedes_at
​string | null · date-time · required
​AuditTimelineEntry[] · required