POST /accounts/{account_id}/request-tracer/trace
Traces a simulated HTTP request through Cloudflare's edge to analyze how rules, settings, and configurations would process the request. Useful for debugging firewall rules, page rules, and other request transformations without sending actual traffic. Supports custom headers, cookies, body content, and geolocation context.
Servers
- https://api.cloudflare.com/client/v4
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
account_id |
String | Yes |
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 |
|---|---|---|---|
skip_response |
Boolean | No |
Skip sending the request to the Origin server after all rules evaluation |
context |
Object | No |
Additional request parameters |
context.geoloc |
Object | No |
Geodata for tracing request |
context.geoloc.is_eu_country |
Boolean | No | |
context.geoloc.timezone |
String | No | |
context.geoloc.longitude |
Number | No | |
context.geoloc.iso_code |
String | No | |
context.geoloc.latitude |
Number | No | |
context.geoloc.region_code |
String | No | |
context.geoloc.postal_code |
String | No | |
context.geoloc.subdivision_2_iso_code |
String | No | |
context.geoloc.continent |
String | No | |
context.geoloc.city |
String | No | |
context.threat_score |
Integer | No |
Threat score used for evaluating tracing request processing |
context.skip_challenge |
Boolean | No |
Whether to skip any challenges for tracing request (e.g.: captcha) |
context.bot_score |
Integer | No |
Bot score used for evaluating tracing request processing |
method |
String | Yes |
HTTP Method of tracing request |
cookies |
Object | No |
Cookies added to tracing request |
url |
String | Yes |
URL to which perform tracing request |
protocol |
String | No |
HTTP Protocol of tracing request |
body |
Object | No | |
body.plain_text |
String | No |
Request body as plain text |
body.base64 |
String | No |
Base64 encoded request body |
body.json |
Object | No |
Arbitrary json as request body |
headers |
Object | No |
Headers added to tracing request |
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.