Start Tail

POST

https://api.cloudflare.com/client/v4/accounts/{account_identifier}/workers/scripts/{script_name}/tails

Last modified:2022-12-16 13:48:35

Starts a tail that receives logs and exception from a Worker.

Request

Path Params

script_name

string

required

account_identifier

string

required

Body Params application/json

object {0}

Example

{}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.cloudflare.com/client/v4/accounts//workers/scripts//tails' \
--header 'Content-Type: application/json' \
--data-raw '{}'

Responses

🟢200Start Tail response

application/json

Body

errors

array [object {2}]

messages

required

Example:

[]

code

integer

required

>= 1000

message

string

required

messages

array [object {2}]

messages

required

Example:

[]

code

integer

required

>= 1000

message

string

required

result

required

Any of

object

allOf {2}

expires_at

read-onlyoptional

url

read-onlyoptional

success

enum<boolean>

required

Whether the API call was successful

Allowed value:

true

Example:

true

Example

{
    "errors": [],
    "messages": [],
    "result": {
        "expires_at": null,
        "id": null,
        "url": null
    },
    "success": true
}

🟢200Start Tail response failure

Modified at 2022-12-16 13:48:35

List Tails

Delete Tail