Exports

Create and download bulk exports of operation records for compliance, archival, or external audit purposes.

Create Export

POST

/v1/exports

Create an export job. Exports run asynchronously and return HTTP 201.

Auth: org_owner, security_admin, compliance_auditor

Request Body

Field	Type	Required	Description
start_time	number	Yes	Unix millisecond start of the export range
end_time	number	Yes	Unix millisecond end of the export range
agent_id	string	No	Filter by agent
operation_type	string	No	Filter by operation type
format	string	Yes	Export format: "json" or "pdf"

Example Request

bash

curl -X POST https://api.elydora.com/v1/exports \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "start_time": 1769904000000,
    "end_time": 1772409599000,
    "format": "json"
  }'

Response

json

{
  "export": {
    "export_id": "0195f2d0-1a2b-7c3d-8e4f-5a6b7c8d9e0f",
    "org_id": "org_acme",
    "status": "queued",
    "query_params": "{\"start_time\":1769904000000,\"end_time\":1772409599000,\"agent_id\":null,\"operation_type\":null,\"format\":\"json\"}",
    "r2_export_key": null,
    "created_at": 1772290800000,
    "completed_at": null
  }
}

List Exports

GET

/v1/exports

List all export jobs for the organization.

Auth: org_owner, security_admin, compliance_auditor

Response

json

{
  "exports": [
    {
      "export_id": "0195f2d0-1a2b-7c3d-8e4f-5a6b7c8d9e0f",
      "org_id": "org_acme",
      "status": "done",
      "query_params": "{\"start_time\":1769904000000,\"end_time\":1772409599000,\"agent_id\":null,\"operation_type\":null,\"format\":\"json\"}",
      "r2_export_key": "<object storage key>",
      "created_at": 1772290800000,
      "completed_at": 1772290950000
    }
  ]
}

Get Export Status

GET

/v1/exports/:export_id

Return the export record and a download URL once the status is done.

Auth: org_owner, security_admin, compliance_auditor

Path Parameters

Field	Type	Required	Description
export_id	string	Yes	The export job identifier

Response

json

{
  "export": {
    "export_id": "0195f2d0-1a2b-7c3d-8e4f-5a6b7c8d9e0f",
    "org_id": "org_acme",
    "status": "done",
    "query_params": "{\"start_time\":1769904000000,\"end_time\":1772409599000,\"agent_id\":null,\"operation_type\":null,\"format\":\"json\"}",
    "r2_export_key": "<object storage key>",
    "created_at": 1772290800000,
    "completed_at": 1772290950000
  },
  "download_url": "/v1/exports/0195f2d0-1a2b-7c3d-8e4f-5a6b7c8d9e0f/download"
}

Download Export

GET

/v1/exports/:export_id/download

Download the completed export data.

Auth: org_owner, security_admin, compliance_auditor

Streams the export file as an attachment named export-<export_id>.json or .pdf. Available when the status is done.

Example Request

bash

curl -O https://api.elydora.com/v1/exports/0195f2d0-1a2b-7c3d-8e4f-5a6b7c8d9e0f/download \
  -H "Authorization: Bearer <token>"