Skip to main content
GET
Retrieve task
Returns complete details for a single task, including the node graph definition and plan summary that are omitted from the list endpoint. Use this to inspect the task configuration or validate inputs before queuing a run.

Request

Path parameters

  • taskId — UUID of the task to retrieve.

Example

Responses

  • 200 OK — Returns { "task": Task } with all fields from the list endpoint, plus:
    • definition (object) — The full node graph definition for the task.
    • planSummary (string | null) — AI-generated summary of the execution plan.
  • 400 Bad Request — Invalid task ID format.
  • 401 Unauthorized — Missing or malformed API key.
  • 404 Not Found — Task not found or not accessible to the authenticated organization.

Authorizations

Authorization
string
header
required

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

Path Parameters

taskId
string<uuid>
required

UUID of the task to retrieve.

Response

Task details returned.

task
object
required