---
title: "Create task and immediately start execution"
method: POST
path: "/api/tasks/create-and-start"
tags: ["Tasks"]
---

# Create task and immediately start execution

`POST /api/tasks/create-and-start`

## Request body

- object
  - `task` CreateTask, required
    - `project_id` string, uuid, required
    - `title` string, required
    - `description` string, nullable
    - `image_ids` string[], nullable
  - `executor_profile_id` ExecutorProfileId, required
    - `executor` 'CLAUDE_CODE' | 'CURSOR' | 'GEMINI' | 'CODEX' | 'AMP' | 'OPENCODE' | 'QWEN_CODE' | 'CLAUDE_ROUTER', required
    - `variant` string, nullable
  - `base_branch` string, required

## Response `200`

Task created and execution started

- 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
    - `has_in_progress_attempt` boolean
    - `has_merged_attempt` boolean
    - `last_attempt_failed` boolean
    - `executor` string, nullable
  - `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)