--- title: Logs --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/python) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Logs #### LogsLog Explorer #### LogsLog ExplorerQuery ##### [Run a log query](https://developers.cloudflare.com/api/python/resources/logs/subresources/log_explorer/subresources/query/methods/sql) logs.log\_explorer.query.sql(QuerySqlParams\*\*kwargs) -> SyncSinglePage\[[QuerySqlResponse]()] POST/{accounts\_or\_zones}/{account\_or\_zone\_id}/logs/explorer/query/sql ##### ModelsExpand Collapse Dict\[str, object] [Link to this property](<#(resource)%20logs.log_explorer.query%20%3E%20(model)%20query_sql_response%20%3E%20(schema)>) #### LogsLog ExplorerDatasets ##### [List account or zone datasets](https://developers.cloudflare.com/api/python/resources/logs/subresources/log_explorer/subresources/datasets/methods/list) logs.log\_explorer.datasets.list(DatasetListParams\*\*kwargs) -> SyncSinglePage\[[DatasetSummary]()] GET/{accounts\_or\_zones}/{account\_or\_zone\_id}/logs/explorer/datasets ##### [Get an account or zone dataset](https://developers.cloudflare.com/api/python/resources/logs/subresources/log_explorer/subresources/datasets/methods/get) logs.log\_explorer.datasets.get(strdataset\_id, DatasetGetParams\*\*kwargs) -> [Dataset]() GET/{accounts\_or\_zones}/{account\_or\_zone\_id}/logs/explorer/datasets/{dataset\_id} ##### [Create an account or zone dataset](https://developers.cloudflare.com/api/python/resources/logs/subresources/log_explorer/subresources/datasets/methods/create) logs.log\_explorer.datasets.create(DatasetCreateParams\*\*kwargs) -> [Dataset]() POST/{accounts\_or\_zones}/{account\_or\_zone\_id}/logs/explorer/datasets ##### [Update an account or zone dataset](https://developers.cloudflare.com/api/python/resources/logs/subresources/log_explorer/subresources/datasets/methods/update) logs.log\_explorer.datasets.update(strdataset\_id, DatasetUpdateParams\*\*kwargs) -> [Dataset]() PUT/{accounts\_or\_zones}/{account\_or\_zone\_id}/logs/explorer/datasets/{dataset\_id} ##### [Delete an account or zone dataset](https://developers.cloudflare.com/api/python/resources/logs/subresources/log_explorer/subresources/datasets/methods/delete) logs.log\_explorer.datasets.delete(strdataset\_id, DatasetDeleteParams\*\*kwargs) -> [Dataset]() DELETE/{accounts\_or\_zones}/{account\_or\_zone\_id}/logs/explorer/datasets/{dataset\_id} ##### ModelsExpand Collapse
class CreateRequest: … dataset: str Dataset type name to create (e.g. http_requests). Link to this property
fields: Optional\[List\[Field]] Controls which fields the API ingests. Defaults to all available fields when absent. enabled: bool Whether the API includes this field in log ingest. Link to this property name: str Field name in lowercase. Link to this property
Link to this property filter: Optional\[str] Optional Logpush filter predicate to restrict which events are ingested. See Logpush filters for syntax and examples. Link to this property filter\_attack\_traffic: Optional\[bool] Whether to filter attack traffic from the Logpush job. Defaults to true for supported datasets when omitted. Supported datasets are http_requests, firewall_events, and network_analytics_logs. Link to this property
[Link to this property](<#(resource)%20logs.log_explorer.datasets%20%3E%20(model)%20create_request%20%3E%20(schema)>)
class Dataset: … A Log Explorer dataset summary. List endpoints return this type and omit field configuration; use the single-dataset endpoint to retrieve it. created\_at: datetime RFC3339 timestamp recording when the API created this dataset. formatdate-time Link to this property dataset: str Dataset type name (e.g. http_requests). Link to this property dataset\_id: str Unique dataset ID. Link to this property deletion\_protection: bool Whether deletion is blocked. Set to false before deleting the dataset. Link to this property enabled: bool Whether log ingest is currently active for this dataset. Link to this property
fields: List\[Field] The field configuration for this dataset. enabled: bool Whether the API includes this field in log ingest. Link to this property name: str Field name in lowercase. Link to this property
Link to this property object\_id: str Public ID of the account or zone that owns this dataset. Link to this property
object\_type: Literal\["account", "zone"] Whether this dataset belongs to an account or a zone. One of the following: "account" Link to this property "zone" Link to this property
Link to this property updated\_at: datetime RFC3339 timestamp recording when the API last updated this dataset. formatdate-time Link to this property filter: Optional\[str] The Logpush filter predicate applied to this dataset. Omitted when no filter is set. Link to this property filter\_attack\_traffic: Optional\[bool] Whether the Logpush job filters attack traffic. Omitted for datasets that do not support this option. Link to this property
[Link to this property](<#(resource)%20logs.log_explorer.datasets%20%3E%20(model)%20dataset%20%3E%20(schema)>)
class DatasetSummary: … A Log Explorer dataset summary. List endpoints return this type and omit field configuration; use the single-dataset endpoint to retrieve it. created\_at: datetime RFC3339 timestamp recording when the API created this dataset. formatdate-time Link to this property dataset: str Dataset type name (e.g. http_requests). Link to this property dataset\_id: str Unique dataset ID. Link to this property deletion\_protection: bool Whether deletion is blocked. Set to false before deleting the dataset. Link to this property enabled: bool Whether log ingest is currently active for this dataset. Link to this property object\_id: str Public ID of the account or zone that owns this dataset. Link to this property
object\_type: Literal\["account", "zone"] Whether this dataset belongs to an account or a zone. One of the following: "account" Link to this property "zone" Link to this property
Link to this property updated\_at: datetime RFC3339 timestamp recording when the API last updated this dataset. formatdate-time Link to this property
[Link to this property](<#(resource)%20logs.log_explorer.datasets%20%3E%20(model)%20dataset_summary%20%3E%20(schema)>)
class UpdateRequest: … enabled: bool Whether to enable or disable log ingest for this dataset. Link to this property deletion\_protection: Optional\[bool] Set to false to allow deletion of this dataset. Link to this property
fields: Optional\[List\[Field]] Controls which fields the API ingests after the update. Defaults to all available fields when absent. enabled: bool Whether the API includes this field in log ingest. Link to this property name: str Field name in lowercase. Link to this property
Link to this property filter: Optional\[str] Optional Logpush filter predicate to restrict which events are ingested. If omitted, the existing filter is left unchanged. Set to an empty string ("") to clear the filter. Otherwise, replaces the dataset’s filter entirely. See Logpush filters for syntax and examples. Link to this property filter\_attack\_traffic: Optional\[bool] Whether to filter attack traffic from the Logpush job. If omitted, the existing setting is left unchanged. Supported datasets are http_requests, firewall_events, and network_analytics_logs. Link to this property
[Link to this property](<#(resource)%20logs.log_explorer.datasets%20%3E%20(model)%20update_request%20%3E%20(schema)>) #### LogsLog ExplorerDatasetsAvailable ##### [List available account or zone datasets](https://developers.cloudflare.com/api/python/resources/logs/subresources/log_explorer/subresources/datasets/subresources/available/methods/list) logs.log\_explorer.datasets.available.list(AvailableListParams\*\*kwargs) -> SyncSinglePage\[[AvailableDataset]()] GET/{accounts\_or\_zones}/{account\_or\_zone\_id}/logs/explorer/datasets/available ##### ModelsExpand Collapse
class AvailableDataset: … A dataset type that the account or zone can create. dataset: str Dataset type name (e.g. http_requests). Link to this property
object\_type: Literal\["account", "zone"] Whether this dataset type is account-scoped or zone-scoped. One of the following: "account" Link to this property "zone" Link to this property
Link to this property
schema: Schema JSON Schema that describes the fields this dataset exposes. properties: Optional\[Dict\[str, object]] Link to this property required: Optional\[List\[str]] Link to this property type: Optional\[Literal\["object"]] Link to this property
Link to this property timestamp\_field: str The primary timestamp field name for this dataset. Link to this property
[Link to this property](<#(resource)%20logs.log_explorer.datasets.available%20%3E%20(model)%20available_dataset%20%3E%20(schema)>)
class AvailableList: …
errors: List\[ResponseInfo] code: int minimum1000 Link to this property message: str Link to this property documentation\_url: Optional\[str] Link to this property
source: Optional\[Source] pointer: Optional\[str] Link to this property
Link to this property
Link to this property messages: List\[str] Link to this property success: bool Link to this property
result: Optional\[List\[AvailableDataset]] dataset: str Dataset type name (e.g. http_requests). Link to this property
object\_type: Literal\["account", "zone"] Whether this dataset type is account-scoped or zone-scoped. One of the following: "account" Link to this property "zone" Link to this property
Link to this property
schema: Schema JSON Schema that describes the fields this dataset exposes. properties: Optional\[Dict\[str, object]] Link to this property required: Optional\[List\[str]] Link to this property type: Optional\[Literal\["object"]] Link to this property
Link to this property timestamp\_field: str The primary timestamp field name for this dataset. Link to this property
Link to this property
[Link to this property](<#(resource)%20logs.log_explorer.datasets.available%20%3E%20(model)%20available_list%20%3E%20(schema)>) #### LogsControl #### LogsControlRetention ##### [Get log retention flag](https://developers.cloudflare.com/api/python/resources/logs/subresources/control/subresources/retention/methods/get) logs.control.retention.get(RetentionGetParams\*\*kwargs) -> [RetentionGetResponse]() GET/zones/{zone\_id}/logs/control/retention/flag ##### [Update log retention flag](https://developers.cloudflare.com/api/python/resources/logs/subresources/control/subresources/retention/methods/create) logs.control.retention.create(RetentionCreateParams\*\*kwargs) -> [RetentionCreateResponse]() POST/zones/{zone\_id}/logs/control/retention/flag ##### ModelsExpand Collapse
class RetentionGetResponse: … flag: Optional\[bool] The log retention flag for Logpull API. Link to this property
[Link to this property](<#(resource)%20logs.control.retention%20%3E%20(model)%20retention_get_response%20%3E%20(schema)>)
class RetentionCreateResponse: … flag: Optional\[bool] The log retention flag for Logpull API. Link to this property
[Link to this property](<#(resource)%20logs.control.retention%20%3E%20(model)%20retention_create_response%20%3E%20(schema)>) #### LogsControlCmb #### LogsControlCmbConfig ##### [Get CMB config](https://developers.cloudflare.com/api/python/resources/logs/subresources/control/subresources/cmb/subresources/config/methods/get) logs.control.cmb.config.get(ConfigGetParams\*\*kwargs) -> [CmbConfig]() GET/accounts/{account\_id}/logs/control/cmb/config ##### [Update CMB config](https://developers.cloudflare.com/api/python/resources/logs/subresources/control/subresources/cmb/subresources/config/methods/create) logs.control.cmb.config.create(ConfigCreateParams\*\*kwargs) -> [CmbConfig]() POST/accounts/{account\_id}/logs/control/cmb/config ##### [Delete CMB config](https://developers.cloudflare.com/api/python/resources/logs/subresources/control/subresources/cmb/subresources/config/methods/delete) logs.control.cmb.config.delete(ConfigDeleteParams\*\*kwargs) -> object DELETE/accounts/{account\_id}/logs/control/cmb/config ##### ModelsExpand Collapse
class CmbConfig: … allow\_out\_of\_region\_access: Optional\[bool] Allow out of region access Link to this property regions: Optional\[str] Name of the region. maxLength256 Link to this property
[Link to this property](<#(resource)%20logs.control.cmb.config%20%3E%20(model)%20cmb_config%20%3E%20(schema)>) #### LogsRayID ##### [Get logs RayIDs](https://developers.cloudflare.com/api/python/resources/logs/subresources/rayid/methods/get) logs.rayid.get(strrayid, RayIDGetParams\*\*kwargs) -> [RayIDGetResponse]() GET/zones/{zone\_id}/logs/rayids/{ray\_id} ##### ModelsExpand Collapse
Union\[str, object] One of the following: str Link to this property object Link to this property
[Link to this property](<#(resource)%20logs.rayid%20%3E%20(model)%20rayid_get_response%20%3E%20(schema)>) #### LogsReceived ##### [Get logs received](https://developers.cloudflare.com/api/python/resources/logs/subresources/received/methods/get) logs.received.get(ReceivedGetParams\*\*kwargs) -> [ReceivedGetResponse]() GET/zones/{zone\_id}/logs/received ##### ModelsExpand Collapse
Union\[str, object] One of the following: str Link to this property object Link to this property
[Link to this property](<#(resource)%20logs.received%20%3E%20(model)%20received_get_response%20%3E%20(schema)>) #### LogsReceivedFields ##### [List fields](https://developers.cloudflare.com/api/python/resources/logs/subresources/received/subresources/fields/methods/get) logs.received.fields.get(FieldGetParams\*\*kwargs) -> [FieldGetResponse]() GET/zones/{zone\_id}/logs/received/fields ##### ModelsExpand Collapse
class FieldGetResponse: … key: Optional\[str] Link to this property
[Link to this property](<#(resource)%20logs.received.fields%20%3E%20(model)%20field_get_response%20%3E%20(schema)>)