POST /accounts/{account_id}/diagnostics/traceroute

Run traceroutes from Cloudflare colos.

Servers

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
options Object No
options.packets_per_ttl Integer No

Number of packets sent at each TTL.

Default value: 3

options.port Integer No

For UDP and TCP, specifies the destination port. For ICMP, specifies the initial ICMP sequence value. Default value 0 will choose the best value to use for each protocol.

Default value: 0

options.max_ttl Integer No

Max TTL.

Default value: 15

options.packet_type String No

Type of packet sent.

Valid values:

  • "gre"
  • "tcp"
  • "udp"
  • "icmp"
  • "gre+icmp"

Default value: "icmp"

options.wait_time Integer No

Set the time (in seconds) to wait for a response to a probe.

Default value: 1

targets[] Array Yes
colos[] Array No

If no source colo names specified, all colos will be used. China colos are unavailable for traceroutes.

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.