Create Export

POST /api/v1/exports

Create a new CSV export with optional filters. Exports are processed in the background.

Request Body

string

ISO 8601 timestamp. Export events from this time onward.

string

ISO 8601 timestamp. Export events up to this time.

string

Filter exported events by actor identifier.

string

Filter by action.

string

Filter by resource type.

string

Filter by tenant identifier.

string

Filter by session identifier.

string

Case-insensitive search across event fields.

Response

Returns 202 Accepted:

{
  "data": {
    "id": "exp_9c2f4a7b-1d3e-4f5a-8b6c-7d8e9f0a1b2c",
    "status": "pending"
  }
}

Examples

curl -X POST https://getimmutable.dev/api/v1/exports \
  -H "Authorization: Bearer imk_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "actor_id": "user_2hG9kLm",
    "from": "2026-03-01T00:00:00Z",
    "to": "2026-03-31T23:59:59Z"
  }'

const exp = await client.createExport({
  actor_id: "user_2hG9kLm",
  from: "2026-03-01T00:00:00Z",
  to: "2026-03-31T23:59:59Z",
});

$export = AuditLog::createExport([
    'actor_id' => 'user_2hG9kLm',
    'from' => '2026-03-01T00:00:00Z',
    'to' => '2026-03-31T23:59:59Z',
]);

Limits

Maximum 5 concurrent exports per workspace.
Each export counts toward your monthly export quota.

Events outside your retention window are not included in exports.

Overview

Events

Verification

Exports

Anchors

Other

POST /api/v1/exports

Request Body

Response

Examples

Limits

​POST /api/v1/exports

​Request Body

​Response

​Examples

​Limits

POST /api/v1/exports

Request Body

Response

Examples

Limits