> ## Documentation Index
> Fetch the complete documentation index at: https://docs.runaether.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# 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

<ParamField body="project_id" type="string" required>
  Project ID (UUID) to run the task in.
</ParamField>

<ParamField body="prompt" type="string" required>
  The task prompt describing what the agent should do.
</ParamField>

<RequestExample>
  ```json theme={null}
  {
    "project_id": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
    "prompt": "Add a login page with email and password fields"
  }
  ```
</RequestExample>

## Response

<ResponseField name="id" type="string" required>
  Unique task identifier (UUID).
</ResponseField>

<ResponseField name="status" type="string" required>
  Initial task status.
</ResponseField>

<ResponseExample>
  ```json 201 theme={null}
  {
    "id": "c3d4e5f6-7890-12ab-cdef-345678901bcd",
    "status": "created"
  }
  ```
</ResponseExample>

## 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 |