Skip to main content

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.

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

​
Authentication

Requires a valid Bearer token.

​
Path Parameters

​
taskID
string
required
Task ID (UUID).

​
Response

​
id
string
required
Unique task identifier (UUID).
​
name
string
Task name.
​
status
string
required
Runtime status: queued, provisioning, running, awaiting_input, failed, or aborted.
​
workspace_id
string
Workspace ID when a workspace has been assigned.
​
started_at
string
ISO 8601 timestamp for when execution started.
​
completed_at
string
ISO 8601 timestamp for terminal tasks.
​
pending_question_payload
object
Pending interactive input payload for awaiting-input tasks, including toolId, toolName, and input.
​
result
string
Task result summary.
​
error
string
Error message if the task failed.
​
summary
string
Brief summary of what the task accomplished.
​
created_at
string
required
ISO 8601 timestamp.
​
events
array
List of task events (tool calls, file changes, etc.).
​
messages
array
List of conversation messages between the user and agent.
{
  "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": []
}

​
Errors

StatusDescription
401Unauthorized — missing or invalid token
404Not Found — task does not exist or you do not have access