Update a recurring export schedule

Replaces the configuration of one of your tenant's export schedules. The next run time is recomputed when the cadence or time-of-day fields change. Updating a schedule is recorded as an audit event. Requires the audit-log:manage permission. Also requires an entity-level resource- group:bypass grant — a manage grant assigned scoped to a resource group is refused, since this surface is not clamped to resource groups.

Path Parameters

id
Type: stringFormat: uuid
required

Export schedule UUID

Body

required

application/json

cadence
Type: "daily" or "weekly" or "monthly"enum
required
hourUtc
Type: integer
min:
0
max:
23
required

Integer numbers.
dayOfMonth
Type: integer
min:
1
max:
28

Integer numbers.
dayOfWeek
Type: integer
min:
0
max:
6

Integer numbers.
enabled
Type: boolean

Whether the schedule is active.
filters
Type: object

Explorer-style filters narrowing which events the export covers. Accepted only for pdf_summary — a jsonl_bundle is verified against the signed daily manifests, so it must contain every row in the window and a filtered request is rejected with 422. Supported keys: category, action, actions, outcome, actorUserId, targetType, targetId, jobId, privilegedOnly, dataExposureOnly. search, occurredAfter and occurredBefore are rejected: the export window sets the time range, and free-text search is limited to the interactive explorer.
format
Type: "jsonl_bundle" or "pdf_summary"enum
recipients
Type: array of stringFormat: email

Responses

application/json
400

Validation error
401

Authentication required
403

Insufficient permissions (requires audit-log:manage and entity-level resource-group:bypass)
404

Export schedule not found or not accessible

put/audit-logs/export-schedules/{id}

curl https://api.gpcn.com/v1/audit-logs/export-schedules/123e4567-e89b-12d3-a456-426614174000 \
  --request PUT \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: YOUR_SECRET_TOKEN' \
  --data '{
  "cadence": "daily",
  "hourUtc": 0,
  "dayOfWeek": 0,
  "dayOfMonth": 1,
  "format": "jsonl_bundle",
  "filters": {},
  "recipients": [
    ""
  ],
  "enabled": true
}'

Show Schema

{
  "success": true,
  "data": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "cadence": "daily",
    "hourUtc": 1,
    "dayOfWeek": 1,
    "dayOfMonth": 1,
    "format": "jsonl_bundle",
    "filters": {},
    "recipients": [
      "hello@example.com"
    ],
    "enabled": 1,
    "lastRunAt": "2026-10-21T16:19:07.205Z",
    "nextRunAt": "2026-10-21T16:19:07.205Z",
    "createdAt": "2026-10-21T16:19:07.205Z",
    "updatedAt": "2026-10-21T16:19:07.205Z"
  }
}

Updated schedule

Get a single recurring export schedule

Delete a recurring export schedule