---
title: "Create a new task attempt"
method: POST
path: "/api/task-attempts"
tags: ["Task Attempts"]
---

# Create a new task attempt

`POST /api/task-attempts`

## Request body

- object
  - `task_id` string, uuid, required
  - `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 attempt created and started

- object
  - `success` boolean, required
  - `data` object, nullable
    - `id` string, uuid, required
    - `task_id` string, uuid, required
    - `executor` 'CLAUDE_CODE' | 'CURSOR' | 'GEMINI' | 'CODEX' | 'AMP' | 'OPENCODE' | 'QWEN_CODE' | 'CLAUDE_ROUTER', required
    - `base_branch` string, required
    - `branch` string, required
    - `status` 'pending' | 'running' | 'completed' | 'failed' | 'stopped', required
    - `container_ref` string, 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)