Skip to content
Cloudflare API
Start here
API Reference
Workers
Scripts

Tail

List Tails
workers.scripts.tail.get(strscript_name, TailGetParams**kwargs) -> TailGetResponse
GET/accounts/{account_id}/workers/scripts/{script_name}/tails
Start Tail
workers.scripts.tail.create(strscript_name, TailCreateParams**kwargs) -> TailCreateResponse
POST/accounts/{account_id}/workers/scripts/{script_name}/tails
Delete Tail
workers.scripts.tail.delete(strid, TailDeleteParams**kwargs) -> TailDeleteResponse
DELETE/accounts/{account_id}/workers/scripts/{script_name}/tails/{id}
ModelsExpand Collapse
class ConsumerScript: …

A reference to a script that will consume logs from the attached Worker.

service: str

Name of Worker that is to be the consumer.

environment: Optional[str]

Optional environment if the Worker utilizes one.

namespace: Optional[str]

Optional dispatch namespace the script belongs to.

class TailGetResponse: …
id: str

Identifier.

maxLength32
expires_at: str
url: str
class TailCreateResponse: …
id: str

Identifier.

maxLength32
expires_at: str
url: str
class TailDeleteResponse: …
errors: List[Error]
code: int
minimum1000
message: str
documentation_url: Optional[str]
source: Optional[ErrorSource]
pointer: Optional[str]
messages: List[Message]
code: int
minimum1000
message: str
documentation_url: Optional[str]
source: Optional[MessageSource]
pointer: Optional[str]
success: Literal[true]

Whether the API call was successful.