---
title: "Start a new task"
method: POST
path: "/api/v1/task/zero"
---

# Start a new task

`POST /api/v1/task/zero`

Execute the requested task.

## Query parameters

- `t` integer, nullable
- `task_type` 'discovery' | 'automation' | 'task' — Task types.

## Headers

- `workspace-id` string, required

## Cookies

- `apikey` string

## Request body

- ITask — Task configuration model.
  - `t` integer
  - `title` string, required
  - `body` string, required
  - `apps` object, required
  - `autonomy_level` string, required
  - `complexity` string, required
  - `attachments` object[]

## Response `200`

Successful Response

- ChatResponse — Messages response model.
  - `r` unknown[], required
    - unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/smooth/apis/circlemind-zero.md) · [All operations](https://skmtc.dev/smooth/apis/circlemind-zero/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/smooth/circlemind-zero/revisions/472956a12adf/schema)