API Reference

Agent

Tasks

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Start task (streaming)

POST/agent/tasks/stream

Starts an agent task and streams events via SSE (Content-Type: text/event-stream).

Body ParametersJSONExpand Collapse

agent_type: optional string

environment_id: optional string

instruction: optional string

kind: optional "desktop" or "browser"

One of the following:

"desktop"

"browser"

max_steps: optional number

model: optional string

persistent: optional boolean

screenshot_mode: optional "url" or "base64"

One of the following:

"url"

"base64"

temperature: optional number

viewport_height: optional number

viewport_width: optional number

ReturnsExpand Collapse

TaskStartStreamResponse = string

Start task (streaming)

HTTP

HTTP

TypeScript

Python

curl https://api.tzafon.ai/agent/tasks/stream \
    -H 'Content-Type: application/json' \
    -H "Authorization: Bearer $TZAFON_API_KEY" \
    -d '{}'

Returns Examples