API Reference

Logs

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Log Explorer

Log ExplorerQuery

Run a log query

client.logs.logExplorer.query.sql(QuerySqlParams { body, account_id, zone_id } params, RequestOptionsoptions?): SinglePage<QuerySqlResponse>

POST/{accounts_or_zones}/{account_or_zone_id}/logs/explorer/query/sql

ModelsExpand Collapse

QuerySqlResponse = Record<string, unknown>

Log ExplorerDatasets

List account or zone datasets

client.logs.logExplorer.datasets.list(DatasetListParams { account_id, zone_id, include_zones } params?, RequestOptionsoptions?): SinglePage<DatasetSummary { created_at, dataset, dataset_id, 4 more } >

GET/{accounts_or_zones}/{account_or_zone_id}/logs/explorer/datasets

Get an account or zone dataset

client.logs.logExplorer.datasets.get(stringdatasetId, DatasetGetParams { account_id, zone_id } params?, RequestOptionsoptions?): Dataset { created_at, dataset, dataset_id, 5 more }

GET/{accounts_or_zones}/{account_or_zone_id}/logs/explorer/datasets/{dataset_id}

Create an account or zone dataset

client.logs.logExplorer.datasets.create(DatasetCreateParams { dataset, account_id, zone_id, fields } params, RequestOptionsoptions?): Dataset { created_at, dataset, dataset_id, 5 more }

POST/{accounts_or_zones}/{account_or_zone_id}/logs/explorer/datasets

Update an account or zone dataset

client.logs.logExplorer.datasets.update(stringdatasetId, DatasetUpdateParams { enabled, account_id, zone_id, fields } params, RequestOptionsoptions?): Dataset { created_at, dataset, dataset_id, 5 more }

PUT/{accounts_or_zones}/{account_or_zone_id}/logs/explorer/datasets/{dataset_id}

ModelsExpand Collapse

CreateRequest { dataset, fields }

dataset: string

Dataset type name to create (e.g. http_requests).

fields?: Array<Field>

Controls which fields the API ingests. Defaults to all available fields when absent.

enabled: boolean

Whether the API includes this field in log ingest.

name: string

Field name in lowercase.

Dataset { created_at, dataset, dataset_id, 5 more }

A Log Explorer dataset summary. List endpoints return this type and omit field configuration; use the single-dataset endpoint to retrieve it.

created_at: string

RFC3339 timestamp recording when the API created this dataset.

formatdate-time

dataset: string

Dataset type name (e.g. http_requests).

dataset_id: string

Unique dataset ID.

enabled: boolean

Whether log ingest is currently active for this dataset.

object_id: string

Public ID of the account or zone that owns this dataset.

object_type: "account" | "zone"

Whether this dataset belongs to an account or a zone.

One of the following:

"account"

"zone"

updated_at: string

RFC3339 timestamp recording when the API last updated this dataset.

formatdate-time

fields?: Array<Field>

The field configuration for this dataset.

enabled: boolean

Whether the API includes this field in log ingest.

name: string

Field name in lowercase.

DatasetSummary { created_at, dataset, dataset_id, 4 more }

A Log Explorer dataset summary. List endpoints return this type and omit field configuration; use the single-dataset endpoint to retrieve it.

created_at: string

RFC3339 timestamp recording when the API created this dataset.

formatdate-time

dataset: string

Dataset type name (e.g. http_requests).

dataset_id: string

Unique dataset ID.

enabled: boolean

Whether log ingest is currently active for this dataset.

object_id: string

Public ID of the account or zone that owns this dataset.

object_type: "account" | "zone"

Whether this dataset belongs to an account or a zone.

One of the following:

"account"

"zone"

updated_at: string

RFC3339 timestamp recording when the API last updated this dataset.

formatdate-time

UpdateRequest { enabled, fields }

enabled: boolean

Whether to enable or disable log ingest for this dataset.

fields?: Array<Field>

Controls which fields the API ingests after the update. Defaults to all available fields when absent.

enabled: boolean

Whether the API includes this field in log ingest.

name: string

Field name in lowercase.

Log ExplorerDatasetsAvailable

List available account or zone datasets

client.logs.logExplorer.datasets.available.list(AvailableListParams { account_id, zone_id } params?, RequestOptionsoptions?): SinglePage<AvailableDataset { dataset, object_type, schema, timestamp_field } >

GET/{accounts_or_zones}/{account_or_zone_id}/logs/explorer/datasets/available

ModelsExpand Collapse

AvailableDataset { dataset, object_type, schema, timestamp_field }

A dataset type that the account or zone can create.

dataset: string

Dataset type name (e.g. http_requests).

object_type: "account" | "zone"

Whether this dataset type is account-scoped or zone-scoped.

One of the following:

"account"

"zone"

schema: Schema { properties, required, type }

JSON Schema that describes the fields this dataset exposes.

properties?: Record<string, unknown>

required?: Array<string>

type?: "object"

timestamp_field: string

The primary timestamp field name for this dataset.

AvailableList { errors, messages, success, result }

errors: Array<ResponseInfo { code, message, documentation_url, source } >

code: number

minimum1000

message: string

documentation_url?: string

source?: Source { pointer }

pointer?: string

messages: Array<string>

success: boolean

result?: Array<AvailableDataset { dataset, object_type, schema, timestamp_field } > | null

dataset: string

Dataset type name (e.g. http_requests).

object_type: "account" | "zone"

Whether this dataset type is account-scoped or zone-scoped.

One of the following:

"account"

"zone"

schema: Schema { properties, required, type }

JSON Schema that describes the fields this dataset exposes.

properties?: Record<string, unknown>

required?: Array<string>

type?: "object"

timestamp_field: string

The primary timestamp field name for this dataset.