---
title: "Start Agent Task"
method: POST
path: "/api/agent-tasks/start"
tags: ["agent-tasks"]
---

# Start Agent Task

`POST /api/agent-tasks/start`

## Request

- Base URL: `https://platform.verbiflow.com/api/bridge`
- URL: `https://platform.verbiflow.com/api/bridge/api/agent-tasks/start`
- Auth: one of:
  - HTTP bearer and API key in header `x-flage-org-id`
  - HTTP bearer and API key in header `x-flage-org-slug`

## Request body

- AgentTaskStartRequest
  - `capabilities` string[]
  - `input` union, required: Recursive JSON value: object, array, string, integer, number, boolean, or null.
    - object
    - AgentJsonValueInput[]
    - string
    - integer
    - number
    - boolean
  - `output` union, required
    - AgentTaskProseOutput
      - `format` 'text' | 'markdown' | 'html', required
    - AgentTaskJsonOutput
      - `format` 'json', required
      - `schema` object, required
  - `resources` union[]
    - union
      - AgentTaskArtifactResource
        - `artifact_id` string, required
        - `description` string, nullable
        - `kind` 'artifact', required
        - `workspace_path` string, required
      - AgentTaskUrlResource
        - `description` string, nullable
        - `kind` 'url', required
        - `url` string, uri, required
  - `schema` 'verbiflow.agent_task_request.v1', required
  - `task` string, required
  - `tier` 'medium' | 'max'

## Response `202`

Successful Response

- AgentTaskStartResponse
  - `created` boolean, required
  - `request_digest` string, required
  - `result_url` string, required
  - `run_id` string, required
  - `status` 'pending' | 'running' | 'waiting_input' | 'suspended' | 'completed' | 'failed' | 'cancelled', required
  - `thread_id` string, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/verbiflow/apis/verbiflow-sdk-http-contract.md) - [All operations](https://skmtc.dev/verbiflow/apis/verbiflow-sdk-http-contract/llms.txt) - [OpenAPI document](https://skmtc.dev/verbiflow/apis/verbiflow-sdk-http-contract/revisions/c80e903ef8f3?raw)