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

# Stop Task

> Stop a running task and park it in awaiting_input

Interrupts a running task. The agent is paused and the task transitions to
`awaiting_input` with the workspace still attached, so the user can resume
by sending a follow-up message. The workspace VM is **not** torn down.

Stop is only allowed when the task is in the `running` state. Queued,
provisioning, awaiting\_input, and failed tasks return `409 Conflict`.

## Authentication

Requires a valid Bearer token.

## Path Parameters

<ParamField path="taskID" type="string" required>
  Task ID (UUID).
</ParamField>

## Response

Returns `200 OK` on success.

## Errors

| Status | Description                                               |
| ------ | --------------------------------------------------------- |
| `401`  | Unauthorized — missing or invalid token                   |
| `404`  | Not Found — task does not exist or you do not have access |
| `409`  | Conflict — task is not in the running state               |
| `502`  | Bad Gateway — workspace-service forwarding failed         |