---
title: "Create a new task"
method: POST
path: "/api/tasks"
tags: ["Tasks"]
---

# Create a new task

`POST /api/tasks`

## Request body

- CreateTask
  - `project_id` string, uuid, required
  - `title` string, required
  - `description` string, nullable
  - `image_ids` string[], nullable

## Response `200`

Task created

- object
  - `success` boolean, required
  - `data` object, nullable
    - `id` string, uuid, required
    - `project_id` string, uuid, required
    - `title` string, required
    - `description` string, nullable
    - `status` 'todo' | 'inprogress' | 'inreview' | 'done' | 'cancelled', required
    - `parent_task_attempt` string, uuid, nullable
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
  - `error_data` object, nullable
  - `message` string, nullable

---

[API](https://skmtc.net/automagik-dev/apis/automagik-forge-api.md) · [All operations](https://skmtc.net/automagik-dev/apis/automagik-forge-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/automagik-dev/automagik-forge-api/versions/d28c5bcecb50/schema)