## Start

**post** `/agent/tasks`

Starts an agent task and returns a task_id immediately.

### Body Parameters

- `agent_type: optional string`

- `environment_id: optional string`

- `instruction: optional string`

- `kind: optional "desktop" or "browser"`

  - `"desktop"`

  - `"browser"`

- `max_steps: optional number`

- `model: optional string`

- `persistent: optional boolean`

- `screenshot_mode: optional "url" or "base64"`

  - `"url"`

  - `"base64"`

- `temperature: optional number`

- `viewport_height: optional number`

- `viewport_width: optional number`

### Returns

- `status: optional string`

- `task_id: optional string`

### Example

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