Create a new export

Creates an export from either explicit log ids in from or a dataset selector in from_expr. When from_expr is supplied, it is resolved at creation time and the resulting log ids are persisted in search_details.from for export processing.

POST /exports

cURL

with_timestamps

curl --request POST \
  --url https://api.eu.bronto.io/exports \
  --header 'Content-Type: application/json' \
  --header 'X-BRONTO-API-KEY: <api-key>' \
  --data '
{
  "search_details": {
    "from": "550e8400-e29b-41d4-a716-446655440000:297bb888-83b1-44e0-8ab6-47879f1275a2",
    "from_ts": 1709251200000,
    "to_ts": 1711390455601,
    "where": "ip=10.0.0.1"
  }
}
'

201

{
  "export_id": "<string>",
  "org_id": "<string>",
  "progress": 123,
  "status": "CREATED",
  "bytes": 123,
  "events": 123,
  "location": "<string>",
  "search_details": {
    "from": "550e8400-e29b-41d4-a716-446655440000:297bb888-83b1-44e0-8ab6-47879f1275a2",
    "from_ts": 1709251200000,
    "to_ts": 1711390455601,
    "from_expr": "log_id = '797655e0-bddd-4abe-97a4-e9e419a72baa' OR environment != 'production'",
    "time_range": "Last 3 weeks",
    "where": "ip=10.0.0.1"
  },
  "created_at": 123,
  "modified_at": 123,
  "failure_detail": "<string>"
}

Authorizations

ApiKeyAuthBearerAuth

X-BRONTO-API-KEY · string · header · required

Body

application/json

search_details · object · required

Option 1

Option 2

Option 3

Option 4

Show child attributes

Response

201

application/json

Export created successfully

export_id · string · required

The unique identifier for the export.

org_id · string · required

The ID of the organization associated with the export.

progress · integer · required

The progress percentage of the export.

status · enum<string> · required

The current status of the export.

Available options: CREATED, IN_PROGRESS, COMPLETE

bytes · integer · required

The size of the export in bytes.

events · integer · required

The number of events in the export.

location · string · required

The location where the export is stored.

search_details · object · required

Option 1

Option 2

Option 3

Option 4

Show child attributes

created_at · integer<int64>

The timestamp when the export was created.

modified_at · integer<int64>

The timestamp when the export was last modified.

failure_detail · string

Provides the reason for the failure if the export did not complete successfully.