POST /zones/{zone_id}/logs/explorer/datasets

Create a new Log Explorer dataset for the zone.

List available zone datasets to see the dataset types and fields you can use.

The fields property is optional. If not specified, all available fields will be enabled.

For dataset field definitions, see: https://developers.cloudflare.com/logs/logpush/logpush-job/datasets/

Servers

Path parameters

Name Type Required Description
zone_id String Yes

Cloudflare zone ID.

Request headers

Name Type Required Description
Content-Type String Yes The media type of the request body.

Default value: "application/json"

Request body fields

Name Type Required Description
filter String No

Optional Logpush filter predicate to restrict which events are ingested. If provided, replaces the dataset's default filter entirely. See Logpush filters for syntax and examples.

dataset String Yes

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

fields[] Array No

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

fields[].name String Yes

Field name in lowercase.

fields[].enabled Boolean Yes

Whether the API includes this field in log ingest.

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.