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

# Get Task

> Get a task by ID with full details

Returns a single task by its ID, including events and messages.

## Authentication

Requires a valid Bearer token.

## Path Parameters

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

## Response

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

<ResponseField name="name" type="string">
  Task name.
</ResponseField>

<ResponseField name="status" type="string" required>
  Runtime status: `queued`, `provisioning`, `running`, `awaiting_input`, `failed`, or `aborted`.
</ResponseField>

<ResponseField name="workspace_id" type="string">
  Workspace ID when a workspace has been assigned.
</ResponseField>

<ResponseField name="started_at" type="string">
  ISO 8601 timestamp for when execution started.
</ResponseField>

<ResponseField name="completed_at" type="string">
  ISO 8601 timestamp for terminal tasks.
</ResponseField>

<ResponseField name="pending_question_payload" type="object">
  Pending interactive input payload for awaiting-input tasks, including `toolId`, `toolName`, and `input`.
</ResponseField>

<ResponseField name="result" type="string">
  Task result summary.
</ResponseField>

<ResponseField name="error" type="string">
  Error message if the task failed.
</ResponseField>

<ResponseField name="summary" type="string">
  Brief summary of what the task accomplished.
</ResponseField>

<ResponseField name="created_at" type="string" required>
  ISO 8601 timestamp.
</ResponseField>

<ResponseField name="events" type="array">
  List of task events (tool calls, file changes, etc.).
</ResponseField>

<ResponseField name="messages" type="array">
  List of conversation messages between the user and agent.
</ResponseField>

<ResponseExample>
  ```json 200 theme={null}
  {
    "id": "c3d4e5f6-7890-12ab-cdef-345678901bcd",
    "name": "Add login page",
    "status": "awaiting_input",
    "workspace_id": "f6e5d4c3-7890-12ab-cdef-345678901bcd",
    "started_at": "2025-01-15T10:25:00Z",
    "completed_at": null,
    "pending_question_payload": null,
    "result": "Created login page with email/password form",
    "error": null,
    "summary": "Added a login page component with form validation",
    "created_at": "2025-01-15T10:30:00Z",
    "events": [],
    "messages": []
  }
  ```
</ResponseExample>

## Errors

| Status | Description                                               |
| ------ | --------------------------------------------------------- |
| `401`  | Unauthorized — missing or invalid token                   |
| `404`  | Not Found — task does not exist or you do not have access |