---
title: Rules Trace
---

[Skip to content](#_top)

[API Reference](https://developers.cloudflare.com/api/typescript)

Copy Markdown

Open in **Claude**Open in **ChatGPT**Open in **Cursor**

---

**Copy Markdown****View as Markdown**

# Rules Trace

#### Rules TraceTraces

##### [Request Trace](https://developers.cloudflare.com/api/typescript/resources/request_tracers/subresources/traces/methods/create)

client.requestTracers.traces.create(TraceCreateParams {account\_id, method, url, 6 more } params, RequestOptionsoptions?): [TraceCreateResponse](<https://developers.cloudflare.com/api/typescript/resources/request_tracers#(resource)%20request_tracers.traces%20%3E%20(model)%20trace_create_response%20%3E%20(schema)>) {status\_code, trace }

POST/accounts/{account\_id}/request-tracer/trace

##### ModelsExpand Collapse

<details>

<summary>

Trace = Array&lt;<a href="https://developers.cloudflare.com/api/typescript/resources/request_tracers#(resource)%20request_tracers.traces%20%3E%20(model)%20trace_item%20%3E%20(schema)">TraceItem</a> {action, action\_parameters, description, 7 more } &gt;

</summary>

<details>

<summary>

TraceItem {action, action\_parameters, description, 7 more }

List of steps acting on request/response

</summary>

action?: string

If step type is rule, then action performed by this rule

<a href="#(resource)%20request_tracers.traces%20%3E%20(model)%20trace_item%20%3E%20(schema)%20%3E%20(property)%20action">Link to this property</a>

action\_parameters?: unknown

If step type is rule, then action parameters of this rule as JSON

<a href="#(resource)%20request_tracers.traces%20%3E%20(model)%20trace_item%20%3E%20(schema)%20%3E%20(property)%20action_parameters">Link to this property</a>

description?: string

If step type is rule or ruleset, the description of this entity

<a href="#(resource)%20request_tracers.traces%20%3E%20(model)%20trace_item%20%3E%20(schema)%20%3E%20(property)%20description">Link to this property</a>

expression?: string

If step type is rule, then expression used to match for this rule

<a href="#(resource)%20request_tracers.traces%20%3E%20(model)%20trace_item%20%3E%20(schema)%20%3E%20(property)%20expression">Link to this property</a>

kind?: string

If step type is ruleset, then kind of this ruleset

<a href="#(resource)%20request_tracers.traces%20%3E%20(model)%20trace_item%20%3E%20(schema)%20%3E%20(property)%20kind">Link to this property</a>

matched?: boolean

Whether tracing step affected tracing request/response

<a href="#(resource)%20request_tracers.traces%20%3E%20(model)%20trace_item%20%3E%20(schema)%20%3E%20(property)%20matched">Link to this property</a>

name?: string

If step type is ruleset, then name of this ruleset

<a href="#(resource)%20request_tracers.traces%20%3E%20(model)%20trace_item%20%3E%20(schema)%20%3E%20(property)%20name">Link to this property</a>

step\_name?: string

Tracing step identifying name

<a href="#(resource)%20request_tracers.traces%20%3E%20(model)%20trace_item%20%3E%20(schema)%20%3E%20(property)%20step_name">Link to this property</a>

trace?: <a href="https://developers.cloudflare.com/api/typescript/resources/request_tracers#(resource)%20request_tracers.traces%20%3E%20(model)%20trace%20%3E%20(schema)">Trace</a> {}

<a href="#(resource)%20request_tracers.traces%20%3E%20(model)%20trace_item%20%3E%20(schema)%20%3E%20(property)%20trace">Link to this property</a>

type?: string

Tracing step type

<a href="#(resource)%20request_tracers.traces%20%3E%20(model)%20trace_item%20%3E%20(schema)%20%3E%20(property)%20type">Link to this property</a>

</details>

<a href="#(resource)%20request_tracers.traces%20%3E%20(model)%20trace_item%20%3E%20(schema)">Link to this property</a>

</details>

[Link to this property](<#(resource)%20request_tracers.traces%20%3E%20(model)%20trace%20%3E%20(schema)>)

<details>

<summary>

TraceItem {action, action\_parameters, description, 7 more }

List of steps acting on request/response

</summary>

action?: string

If step type is rule, then action performed by this rule

<a href="#(resource)%20request_tracers.traces%20%3E%20(model)%20trace_item%20%3E%20(schema)%20%3E%20(property)%20action">Link to this property</a>

action\_parameters?: unknown

If step type is rule, then action parameters of this rule as JSON

<a href="#(resource)%20request_tracers.traces%20%3E%20(model)%20trace_item%20%3E%20(schema)%20%3E%20(property)%20action_parameters">Link to this property</a>

description?: string

If step type is rule or ruleset, the description of this entity

<a href="#(resource)%20request_tracers.traces%20%3E%20(model)%20trace_item%20%3E%20(schema)%20%3E%20(property)%20description">Link to this property</a>

expression?: string

If step type is rule, then expression used to match for this rule

<a href="#(resource)%20request_tracers.traces%20%3E%20(model)%20trace_item%20%3E%20(schema)%20%3E%20(property)%20expression">Link to this property</a>

kind?: string

If step type is ruleset, then kind of this ruleset

<a href="#(resource)%20request_tracers.traces%20%3E%20(model)%20trace_item%20%3E%20(schema)%20%3E%20(property)%20kind">Link to this property</a>

matched?: boolean

Whether tracing step affected tracing request/response

<a href="#(resource)%20request_tracers.traces%20%3E%20(model)%20trace_item%20%3E%20(schema)%20%3E%20(property)%20matched">Link to this property</a>

name?: string

If step type is ruleset, then name of this ruleset

<a href="#(resource)%20request_tracers.traces%20%3E%20(model)%20trace_item%20%3E%20(schema)%20%3E%20(property)%20name">Link to this property</a>

step\_name?: string

Tracing step identifying name

<a href="#(resource)%20request_tracers.traces%20%3E%20(model)%20trace_item%20%3E%20(schema)%20%3E%20(property)%20step_name">Link to this property</a>

trace?: <a href="https://developers.cloudflare.com/api/typescript/resources/request_tracers#(resource)%20request_tracers.traces%20%3E%20(model)%20trace%20%3E%20(schema)">Trace</a> {}

<a href="#(resource)%20request_tracers.traces%20%3E%20(model)%20trace_item%20%3E%20(schema)%20%3E%20(property)%20trace">Link to this property</a>

type?: string

Tracing step type

<a href="#(resource)%20request_tracers.traces%20%3E%20(model)%20trace_item%20%3E%20(schema)%20%3E%20(property)%20type">Link to this property</a>

</details>

[Link to this property](<#(resource)%20request_tracers.traces%20%3E%20(model)%20trace_item%20%3E%20(schema)>)

<details>

<summary>

TraceCreateResponse {status\_code, trace }

Trace result with an origin status code

</summary>

status\_code?: number

HTTP Status code of zone response

<a href="#(resource)%20request_tracers.traces%20%3E%20(model)%20trace_create_response%20%3E%20(schema)%20%3E%20(property)%20status_code">Link to this property</a>

trace?: <a href="https://developers.cloudflare.com/api/typescript/resources/request_tracers#(resource)%20request_tracers.traces%20%3E%20(model)%20trace%20%3E%20(schema)">Trace</a> {}

<a href="#(resource)%20request_tracers.traces%20%3E%20(model)%20trace_create_response%20%3E%20(schema)%20%3E%20(property)%20trace">Link to this property</a>

</details>

[Link to this property](<#(resource)%20request_tracers.traces%20%3E%20(model)%20trace_create_response%20%3E%20(schema)>)