POST /accounts/{account_id}/workers/observability/telemetry/live-tail
Prepare websocket server for live tail.
Servers
- https://api.cloudflare.com/client/v4
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
account_id |
String | Yes |
Your Cloudflare account 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 |
|---|---|---|---|
filters[] |
Array | No |
Apply filters to the query. Supports nested groups via kind: 'group'. |
filters[].filters[] |
Array | Yes |
Child filter nodes. Each can be a leaf filter or another nested group. |
filters[].filterCombination |
String | Yes |
Logical operator for combining child filters: 'and' (all must match) or 'or' (any must match). Valid values:
|
filters[].key |
String | Yes |
Filter field name. Use verified keys from previous query results or the keys endpoint. Common keys include $metadata.service, $metadata.origin, $metadata.trigger, $metadata.message, and $metadata.error. |
filters[].operation |
String | Yes |
Comparison operator. String operators: includes, not_includes, starts_with, ends_with, regex. Existence: exists, is_null. Set membership: in, not_in (comma-separated values). Numeric: eq, neq, gt, gte, lt, lte. Valid values:
|
filters[].type |
String | Yes |
Data type of the filter field. Must match the actual type of the key being filtered. Valid values:
|
filters[].value |
Object | No |
Comparison value. Must match actual values in your data — verify with the values endpoint. Ensure the value type (string/number/boolean) matches the field type. String comparisons are case-sensitive. Regex uses RE2 syntax (no lookaheads/lookbehinds). |
filters[].kind |
String | Yes |
Discriminator for leaf filter nodes. Always 'filter' when present; may be omitted. Valid values:
|
filterCombination |
String | No |
Set a flag to describe how to combine the filters on the query. Valid values:
Default value: "and" |
scriptId |
String | No |
How to start integrating
- Add HTTP Task to your workflow definition.
- 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.
- Click Test request to test run your request to the API and see the API's response.