OpenSkin API endpoint

Create an audit export

POST /v2/audit/exports

Queues a verified export of audit events in the requested time range. The range must be in the past, use an inclusive start and exclusive end, and span no more than 32 days.

Authentication

Send a Platform API key with permission to use this endpoint in the X-API-Key header.

Parameters

Name	Location	Required	Description
`Idempotency-Key`	header	Yes	See the OpenAPI schema for accepted values.

Request body

The example includes every required JSON field. Open OpenAPI JSON to see optional fields, accepted values, and limits.

Response meaning

200: Idempotent replay returned the original job
201: Audit export job created
400: Invalid range or request document
401: V2Unauthorized
403: V2Forbidden
409: Idempotency key was reused with a different range
503: V2UsageUnavailable

Request example

curl 'https://api-v2.openskin.dev/v2/audit/exports'\
  -X POST\
  -H 'X-API-Key: osk_live_...' \
  -H 'Idempotency-Key: example-Idempotency-Key' \
  -H 'Content-Type: application/json' \
  --data '{"from":"2026-09-01T00:00:00Z","to":"2026-09-03T00:00:00Z"}'

Limits and retries

Check the listed status codes before retrying. If a request uses a unique request key, reuse that key only when repeating the same request. If a list returns next_cursor, send it unchanged in the next request.

Last updated 2026-09-04.