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

# Steer Task

> Forward a queued follow-up to a running Codex task without restarting it

Forwards a queued follow-up message into a running Codex task's active turn.
Only Codex tasks support native steer. The target task must currently be
`running` and must have at least one queued follow-up message; otherwise the
endpoint returns `409 Conflict`.

Steer is a separate route from [stop](./stop). Steer keeps the agent running
and mid-stream; stop pauses the agent into `awaiting_input`.

## Authentication

Requires a valid Bearer token.

## Path Parameters

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

## Response

Returns `200 OK` with `{ "action": "steered" }` 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 a running Codex task, or has no queued follow-up |
| `502`  | Bad Gateway — workspace-service rejected the steer request              |