Docs/Audit log

Audit Log

Every significant event in PausePoint is recorded in an immutable audit log. Use it for compliance, debugging, and understanding agent behavior.

Event Types#

Event	Actor	Fires when
`developer.registered`	developer	A new account is created
`api_key.rotated`	developer	An API key is rotated
`pause.created`	developer	A pause request is created
`pause.responded`	human	A human submits a response
`pause.timed_out`	system	A pause expires without response
`pause.cancelled`	developer	A pause is cancelled via the API
`webhook.created`	developer	A webhook endpoint is registered
`webhook.deleted`	developer	A webhook endpoint is deleted

Query the Audit Log#

bash

curl "https://api.pausepoint.dev/v1/audit?limit=20" \
  -H "Authorization: Bearer $PP_KEY"

Query Parameters#

Parameter	Type	Description
`pause_id`	UUID	Filter to events for a specific pause
`event_type`	string	Filter to a specific event type
`from_date`	ISO timestamp	Include events at or after this time
`to_date`	ISO timestamp	Include events at or before this time
`limit`	int	Max results per page (1–100, default 20)
`offset`	int	Pagination offset (default 0)

Example: All events for a specific pause#

bash

curl "https://api.pausepoint.dev/v1/audit?pause_id=psr_uuid&limit=50" \
  -H "Authorization: Bearer $PP_KEY"

Example: All timeouts this week#

bash

curl "https://api.pausepoint.dev/v1/audit?event_type=pause.timed_out&from_date=2026-05-01T00:00:00Z" \
  -H "Authorization: Bearer $PP_KEY"

Response Format#

json

{
  "items": [
    {
      "id": "uuid",
      "developer_id": "uuid",
      "pause_request_id": "psr_uuid",
      "event_type": "pause.responded",
      "actor": "human",
      "detail": {
        "choice": "Approve",
        "has_text": false
      },
      "created_at": "2026-05-08T14:07:00Z"
    },
    {
      "id": "uuid",
      "developer_id": "uuid",
      "pause_request_id": "psr_uuid",
      "event_type": "pause.created",
      "actor": "developer",
      "detail": {
        "channel": "sms",
        "recipient": "+15550100"
      },
      "created_at": "2026-05-08T14:00:00Z"
    }
  ],
  "total": 2,
  "limit": 20,
  "offset": 0
}

Results are returned in descending order by created_at (most recent first).

Audit Log Immutability#

Audit log entries are append-only. They are never updated or deleted. They survive even if the pause request itself is cancelled or deleted.

The actor field distinguishes who caused the event: - developer — API key action - human — response page submission - system — timeout processing