Create Task

Create and start a new task

Creates a new task with the given prompt. The task begins executing immediately in the associated workspace.

Authentication

Requires a valid Bearer token.

Request Body

project_id · string · required

Project ID (UUID) to run the task in.

prompt · string · required

The task prompt describing what the agent should do.

{
  "project_id": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
  "prompt": "Add a login page with email and password fields"
}

Response

id · string · required

Unique task identifier (UUID).

status · string · required

Initial task status.

201

{
  "id": "c3d4e5f6-7890-12ab-cdef-345678901bcd",
  "status": "created"
}

Errors

Status	Description
400	Bad Request — missing project_id or prompt
401	Unauthorized — missing or invalid token
404	Not Found — project does not exist or you do not have access