Skip to main content
GET
/
r
/
tasks
/
{taskId}
Get task status
curl --request GET \
  --url https://core.cyberun.cloud/api/v1/r/tasks/{taskId} \
  --header 'Authorization: Bearer <token>'
{
  "id": "019abc12-9012-7890-abcd-ef1234567896",
  "workflow_id": "019abc12-8901-7890-abcd-ef1234567895",
  "created_at": "2025-02-10T14:00:00Z",
  "task_error": "",
  "retry_count": 0,
  "started_at": "2025-02-10T14:00:05Z",
  "completed_at": "2025-02-10T14:01:30Z",
  "agent_id": "agent-gpu-01",
  "agent_labels": [
    "gpu",
    "a100"
  ],
  "gateway_id": "gw-a1b2c3d4",
  "gpu_type": "NVIDIA GeForce RTX 4090",
  "dispatch_target": "agent",
  "target_pool": "team",
  "tool_type": "comfyui"
}

Documentation Index

Fetch the complete documentation index at: https://docs.cyberun.cloud/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

User session JWT (Bearer ). Must be paired with the X-Team-ID request header on team-scoped endpoints so the server knows which team's resources to operate on.

Headers

​
X-Team-ID
string<uuid>

UUID of the team to scope the request to. Used by dual-auth endpoints (runtime + scoped management):

  • JWT callers MUST send it — a user may belong to multiple teams and the runtime cannot otherwise know which one to operate on. Missing header → 400.
  • Credential callers (sk-, dk-) can omit it because the team is derived from the credential row itself. Any value sent is ignored.
Example:

"019abc12-4567-7890-abcd-ef1234567891"

Path Parameters

​
taskId
string<uuid>
required

UUID of the task.

Example:

"019abc12-9012-7890-abcd-ef1234567896"

Response

Task details

Task status and metadata. Use GET /r/tasks/{taskId}/result for output data and download URLs.

​
id
string<uuid>
required

Unique task identifier (returned by runWorkflow / runWorkflowBySlug).

Example:

"019abc12-9012-7890-abcd-ef1234567896"

​
workflow_id
string<uuid>
required

ID of the workflow template this task was created from.

Example:

"019abc12-8901-7890-abcd-ef1234567895"

​
task_source
enum<string>
required

How the task was created:

  • jwt: User executed a workflow via the web UI (JWT auth).
  • api_key: Executed programmatically via API Key (Bearer sk-xxx).
Available options:
jwt,
api_key
​
task_status
enum<string>
required

Current state of the task:

  • pending: Task created, waiting to be picked up by the scheduler.
  • waiting: The scheduler received the task, waiting for an available agent with matching labels.
  • queued: Task assigned to an agent, waiting for ACK.
  • running: Agent is executing the ComfyUI workflow.
  • completed: Execution finished successfully, output is available.
  • failed: Execution failed, check the error field for details.
  • cancelled: Task was cancelled before completion.
Available options:
pending,
waiting,
queued,
running,
completed,
failed,
cancelled
​
created_at
string<date-time>
required

When the task was submitted (ISO 8601).

Example:

"2025-02-10T14:00:00Z"

​
task_error
string

Error message if the task failed. Empty string for non-failed tasks.

Example:

""

​
retry_count
integer

Number of times this task has been retried. 0 for the original attempt. Increments on each automatic retry up to the workflow's max_retries.

Example:

0

​
started_at
string<date-time> | null

When the agent started executing the task. null if not yet started.

Example:

"2025-02-10T14:00:05Z"

​
completed_at
string<date-time> | null

When the task reached a terminal state (completed, failed, or cancelled). null if still running.

Example:

"2025-02-10T14:01:30Z"

​
agent_id
string

ID of the agent that processed this task. null if not yet assigned.

Example:

"agent-gpu-01"

​
agent_labels
string[]

Labels of the agent at the time of assignment. null if not yet assigned.

Example:
["gpu", "a100"]
​
gateway_id
string

ID of the gateway that dispatched this task. null if not yet dispatched.

Example:

"gw-a1b2c3d4"

​
gpu_type
string | null

GPU model that executed (or is executing) this task (e.g. "NVIDIA GeForce RTX 4090"). Available for all task sources.

Example:

"NVIDIA GeForce RTX 4090"

​
dispatch_target
enum<string>

Where the task was executed:

  • agent: Executed on a BYOC (Bring Your Own Compute) agent.
  • comfy_cloud: Executed on ComfyUI Cloud.
Available options:
agent,
comfy_cloud
Example:

"agent"

​
target_pool
enum<string>

Dispatch pool. Echoed back from the run request (P2.2). For agent-fulfilled tasks, this records which pool the task was routed through — useful for audit and accounting. Always present; defaults to team on legacy rows.

Available options:
team,
community
Example:

"team"

​
tool_type
enum<string>

Tool runtime used by this workflow:

  • comfyui: ComfyUI API workflow JSON (default, backward compatible).
  • nerfstudio: Nerfstudio 3DGS pipeline spec.
Available options:
comfyui,
nerfstudio
Example:

"comfyui"