Skip to main content
GET
Get task

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id
string
required

Task id (task_<uuid>)

Response

The task

A task as returned on the /v1 surface.

created_at
string
required
device_id
string
required

dev_<uuid> of the owning device.

id
string
required

task_<uuid>.

object
string
required

Discriminator for polymorphic SDK decoders. Always "task".

prompt
string
required
status
string
required
finished_at
string | null
result
any

Why the task ended, as recorded when it was finalized: {"error": …, "detail": …} on a failure, the agent's answer on a success. null while still running.

This is on the wire because the alternative was observed and is indefensible: a task that reports status: "failed" and nothing else. The reason already existed in the record — finalize_terminal writes it — and withholding it from the caller left them with a failure they could not act on, or even describe. Details here are fixed, non-leaking strings; the underlying transport error is logged and never persisted.