Tasks

Atomically claim the next matching task run for the calling agent

POST/api/agent/tasks/claim-next

Header Parameters

X-Compozy-Session-ID*string

Daemon-issued active session id

X-Compozy-Agent*string

Daemon-issued session agent name

Request Body

application/json

JSON request body

TypeScript Definitions

Use the request body type in TypeScript.

idempotency_key?string

lease_seconds?integer

Formatint64

priority_min?integer

required_capabilities?array<string>

run_id?string

wait?boolean

workspace_id?string

Response Body

`application/json`

curl -X POST "https://example.com/api/agent/tasks/claim-next" \  -H "X-Compozy-Session-ID: string" \  -H "X-Compozy-Agent: string" \  -H "Content-Type: application/json" \  -d '{}'

{  "claim": {    "coordination_channel": {      "allowed_message_kinds": [        "status"      ],      "display_name": "string",      "id": "string",      "last_activity_at": "2019-08-24T14:15:22Z",      "purpose": "string",      "run_id": "string",      "task_id": "string",      "workflow_id": "string",      "workspace_id": "string"    },    "lease": {      "claim_token_hash": "string",      "claimed_by": {        "kind": "human",        "ref": "string"      },      "coordination_channel": {        "allowed_message_kinds": [          "status"        ],        "display_name": "string",        "id": "string",        "last_activity_at": "2019-08-24T14:15:22Z",        "purpose": "string",        "run_id": "string",        "task_id": "string",        "workflow_id": "string",        "workspace_id": "string"      },      "heartbeat_at": "2019-08-24T14:15:22Z",      "lease_until": "2019-08-24T14:15:22Z",      "resolved_network_participation": {        "mode": "local",        "source": "explicit_request",        "version": "network-participation/v1"      },      "run_id": "string",      "session_id": "string",      "status": "queued",      "task_id": "string"    },    "run": {      "attempt": 0,      "claim_token_hash": "string",      "claimed_at": "2019-08-24T14:15:22Z",      "claimed_by": {        "kind": "human",        "ref": "string"      },      "coordination_channel": {        "allowed_message_kinds": [          "status"        ],        "display_name": "string",        "id": "string",        "last_activity_at": "2019-08-24T14:15:22Z",        "purpose": "string",        "run_id": "string",        "task_id": "string",        "workflow_id": "string",        "workspace_id": "string"      },      "designation": {        "brief": "string",        "index": 0      },      "designation_group_id": "string",      "ended_at": "2019-08-24T14:15:22Z",      "error": "string",      "failure_kind": "string",      "heartbeat_at": "2019-08-24T14:15:22Z",      "id": "string",      "idempotency_key": "string",      "lease_until": "2019-08-24T14:15:22Z",      "metadata": null,      "origin": {        "kind": "cli",        "ref": "string"      },      "previous_run_id": "string",      "queued_at": "2019-08-24T14:15:22Z",      "recovery_count": 0,      "resolved_network_participation": {        "mode": "local",        "source": "explicit_request",        "version": "network-participation/v1"      },      "resolved_worktree_mode": "none",      "resolved_worktree_ref": "string",      "result": null,      "session_id": "string",      "started_at": "2019-08-24T14:15:22Z",      "status": "queued",      "task_id": "string",      "worktree_id": "string"    },    "task": {      "effective_paused": true,      "id": "string",      "identifier": "string",      "latest_event_seq": 0,      "owner": {        "kind": "human",        "ref": "string"      },      "paused": true,      "paused_by_task_id": "string",      "priority": "low",      "scope": "global",      "status": "draft",      "title": "string",      "workspace_id": "string"    }  }}

Complete a claimed task run for the calling agent

POST/api/agent/tasks/{run_id}/complete

Path Parameters

run_id*string

Task run id

Header Parameters

X-Compozy-Session-ID*string

Daemon-issued active session id

X-Compozy-Agent*string

Daemon-issued session agent name

Request Body

application/json

JSON request body

TypeScript Definitions

Use the request body type in TypeScript.

created_task_ids?array<string>

result?unknown

Response Body

`application/json`

curl -X POST "https://example.com/api/agent/tasks/string/complete" \  -H "X-Compozy-Session-ID: string" \  -H "X-Compozy-Agent: string" \  -H "Content-Type: application/json" \  -d '{}'

{  "lease": {    "claim_token_hash": "string",    "claimed_by": {      "kind": "human",      "ref": "string"    },    "coordination_channel": {      "allowed_message_kinds": [        "status"      ],      "display_name": "string",      "id": "string",      "last_activity_at": "2019-08-24T14:15:22Z",      "purpose": "string",      "run_id": "string",      "task_id": "string",      "workflow_id": "string",      "workspace_id": "string"    },    "heartbeat_at": "2019-08-24T14:15:22Z",    "lease_until": "2019-08-24T14:15:22Z",    "resolved_network_participation": {      "mode": "local",      "source": "explicit_request",      "version": "network-participation/v1"    },    "run_id": "string",    "session_id": "string",    "status": "queued",    "task_id": "string"  }}

Fail a claimed task run for the calling agent

POST/api/agent/tasks/{run_id}/fail

Path Parameters

run_id*string

Task run id

Header Parameters

X-Compozy-Session-ID*string

Daemon-issued active session id

X-Compozy-Agent*string

Daemon-issued session agent name

Request Body

application/json

JSON request body

TypeScript Definitions

Use the request body type in TypeScript.

error*string

metadata?unknown

Response Body

`application/json`

curl -X POST "https://example.com/api/agent/tasks/string/fail" \  -H "X-Compozy-Session-ID: string" \  -H "X-Compozy-Agent: string" \  -H "Content-Type: application/json" \  -d '{    "error": "string"  }'

{  "lease": {    "claim_token_hash": "string",    "claimed_by": {      "kind": "human",      "ref": "string"    },    "coordination_channel": {      "allowed_message_kinds": [        "status"      ],      "display_name": "string",      "id": "string",      "last_activity_at": "2019-08-24T14:15:22Z",      "purpose": "string",      "run_id": "string",      "task_id": "string",      "workflow_id": "string",      "workspace_id": "string"    },    "heartbeat_at": "2019-08-24T14:15:22Z",    "lease_until": "2019-08-24T14:15:22Z",    "resolved_network_participation": {      "mode": "local",      "source": "explicit_request",      "version": "network-participation/v1"    },    "run_id": "string",    "session_id": "string",    "status": "queued",    "task_id": "string"  }}

Extend a claimed task-run lease for the calling agent

POST/api/agent/tasks/{run_id}/heartbeat

Path Parameters

run_id*string

Task run id

Header Parameters

X-Compozy-Session-ID*string

Daemon-issued active session id

X-Compozy-Agent*string

Daemon-issued session agent name

Request Body

application/json

JSON request body

TypeScript Definitions

Use the request body type in TypeScript.

lease_seconds?integer

Formatint64

Response Body

`application/json`

curl -X POST "https://example.com/api/agent/tasks/string/heartbeat" \  -H "X-Compozy-Session-ID: string" \  -H "X-Compozy-Agent: string" \  -H "Content-Type: application/json" \  -d '{}'

{  "lease": {    "claim_token_hash": "string",    "claimed_by": {      "kind": "human",      "ref": "string"    },    "coordination_channel": {      "allowed_message_kinds": [        "status"      ],      "display_name": "string",      "id": "string",      "last_activity_at": "2019-08-24T14:15:22Z",      "purpose": "string",      "run_id": "string",      "task_id": "string",      "workflow_id": "string",      "workspace_id": "string"    },    "heartbeat_at": "2019-08-24T14:15:22Z",    "lease_until": "2019-08-24T14:15:22Z",    "resolved_network_participation": {      "mode": "local",      "source": "explicit_request",      "version": "network-participation/v1"    },    "run_id": "string",    "session_id": "string",    "status": "queued",    "task_id": "string"  }}

Release a claimed task run for the calling agent

POST/api/agent/tasks/{run_id}/release

Path Parameters

run_id*string

Task run id

Header Parameters

X-Compozy-Session-ID*string

Daemon-issued active session id

X-Compozy-Agent*string

Daemon-issued session agent name

Request Body

application/json

JSON request body

TypeScript Definitions

Use the request body type in TypeScript.

reason?string

Response Body

`application/json`

curl -X POST "https://example.com/api/agent/tasks/string/release" \  -H "X-Compozy-Session-ID: string" \  -H "X-Compozy-Agent: string" \  -H "Content-Type: application/json" \  -d '{}'

{  "lease": {    "claim_token_hash": "string",    "claimed_by": {      "kind": "human",      "ref": "string"    },    "coordination_channel": {      "allowed_message_kinds": [        "status"      ],      "display_name": "string",      "id": "string",      "last_activity_at": "2019-08-24T14:15:22Z",      "purpose": "string",      "run_id": "string",      "task_id": "string",      "workflow_id": "string",      "workspace_id": "string"    },    "heartbeat_at": "2019-08-24T14:15:22Z",    "lease_until": "2019-08-24T14:15:22Z",    "resolved_network_participation": {      "mode": "local",      "source": "explicit_request",      "version": "network-participation/v1"    },    "run_id": "string",    "session_id": "string",    "status": "queued",    "task_id": "string"  }}

Start a claimed task run under the calling agent's lease

POST/api/agent/tasks/{run_id}/start

Path Parameters

run_id*string

Task run id

Header Parameters

X-Compozy-Session-ID*string

Daemon-issued active session id

X-Compozy-Agent*string

Daemon-issued session agent name

Request Body

application/json

JSON request body

TypeScript Definitions

Use the request body type in TypeScript.

idempotency_key?string

Response Body

`application/json`

curl -X POST "https://example.com/api/agent/tasks/string/start" \  -H "X-Compozy-Session-ID: string" \  -H "X-Compozy-Agent: string" \  -H "Content-Type: application/json" \  -d '{}'

{  "run": {    "attempt": 0,    "claim_token_hash": "string",    "claimed_at": "2019-08-24T14:15:22Z",    "claimed_by": {      "kind": "human",      "ref": "string"    },    "coordination_channel": {      "allowed_message_kinds": [        "status"      ],      "display_name": "string",      "id": "string",      "last_activity_at": "2019-08-24T14:15:22Z",      "purpose": "string",      "run_id": "string",      "task_id": "string",      "workflow_id": "string",      "workspace_id": "string"    },    "designation": {      "brief": "string",      "index": 0    },    "designation_group_id": "string",    "ended_at": "2019-08-24T14:15:22Z",    "error": "string",    "failure_kind": "string",    "heartbeat_at": "2019-08-24T14:15:22Z",    "id": "string",    "idempotency_key": "string",    "lease_until": "2019-08-24T14:15:22Z",    "metadata": null,    "origin": {      "kind": "cli",      "ref": "string"    },    "previous_run_id": "string",    "queued_at": "2019-08-24T14:15:22Z",    "recovery_count": 0,    "resolved_network_participation": {      "mode": "local",      "source": "explicit_request",      "version": "network-participation/v1"    },    "resolved_worktree_mode": "none",    "resolved_worktree_ref": "string",    "result": null,    "session_id": "string",    "started_at": "2019-08-24T14:15:22Z",    "status": "queued",    "task_id": "string",    "worktree_id": "string"  }}

Get the observer-backed task dashboard

GET/api/observe/tasks/dashboard

Query Parameters

scope?string

Filter by task scope

Value in

"global"
"workspace"

workspace?string

Filter by workspace path, name, or ID

worktree?string

Filter by active run worktree ID

owner_kind?string

Filter by owner kind

Value in

"human"
"agent_session"
"automation"
"extension"
"network_peer"
"pool"

owner_ref?string

Filter by owner reference

participation_channel?string

Filter by resolved participation channel

origin_kind?string

Filter by task origin kind

Value in

"cli"
"web"
"uds"
"http"
"automation"
"extension"
"network"
"agent_session"
"daemon"

Response Body

`application/json`

curl -X GET "https://example.com/api/observe/tasks/dashboard"

{  "dashboard": {    "active_runs": {      "claimed": 0,      "items": [        {          "age_ms": 0,          "attempt": 0,          "error": "string",          "health_status": "string",          "last_activity_at": "2019-08-24T14:15:22Z",          "latest_event_seq": 0,          "max_attempts": 0,          "resolved_network_participation": {            "mode": "local",            "source": "explicit_request",            "version": "network-participation/v1"          },          "run_id": "string",          "run_status": "queued",          "scope": "global",          "session_id": "string",          "stuck": true,          "task_id": "string",          "task_identifier": "string",          "task_owner": {            "kind": "human",            "ref": "string"          },          "task_priority": "low",          "task_status": "draft",          "task_title": "string",          "workspace_id": "string"        }      ],      "queued": 0,      "running": 0,      "starting": 0,      "total": 0    },    "cards": {      "blocked": {        "awaiting_approval": 0,        "awaiting_dependencies": 0,        "health_status": "string",        "tasks": 0      },      "failed": {        "failed_runs": 0,        "forced_stops": 0,        "health_status": "string",        "tasks": 0      },      "in_progress": {        "active_runs": 0,        "claimed_runs": 0,        "health_status": "string",        "queued_runs": 0,        "running_runs": 0,        "starting_runs": 0,        "tasks": 0      },      "latency": {        "claim_latency_ms": {          "average_ms": 0,          "maximum_ms": 0,          "samples": 0        },        "start_latency_ms": {          "average_ms": 0,          "maximum_ms": 0,          "samples": 0        }      }    },    "freshness": {      "age_ms": 0,      "has_live_work": true,      "latest_activity_at": "2019-08-24T14:15:22Z",      "observed_at": "2019-08-24T14:15:22Z",      "stale": true,      "stale_after_ms": 0,      "status": "string"    },    "health": {      "active_orphan_runs": 0,      "queue_backlog": true,      "status": "string",      "stuck_runs": 0    },    "queue": {      "backlog_status": "string",      "backlog_threshold_ms": 0,      "backlog_warning": true,      "depth": [        {          "channel_id": "string",          "count": 0,          "oldest_queue_age_ms": 0,          "oldest_queued_at": "2019-08-24T14:15:22Z"        }      ],      "oldest_queue_age_ms": 0,      "oldest_queued_at": "2019-08-24T14:15:22Z",      "total": 0    },    "status_breakdown": [      {        "count": 0,        "share_percent": 0,        "status": "draft"      }    ],    "totals": {      "active_runs": 0,      "awaiting_approval_tasks": 0,      "blocked_tasks": 0,      "canceled_runs": 0,      "canceled_tasks": 0,      "claimed_runs": 0,      "completed_runs": 0,      "completed_tasks": 0,      "dependency_blocked_tasks": 0,      "draft_tasks": 0,      "failed_runs": 0,      "failed_tasks": 0,      "in_progress_tasks": 0,      "pending_tasks": 0,      "queued_runs": 0,      "ready_tasks": 0,      "running_runs": 0,      "runs_total": 0,      "starting_runs": 0,      "tasks_total": 0    }  }}

Get the observer-backed task inbox

GET/api/observe/tasks/inbox

Query Parameters

scope?string

Filter by task scope

Value in

"global"
"workspace"

workspace?string

Filter by workspace path, name, or ID

worktree?string

Filter by active run worktree ID

owner_kind?string

Filter by owner kind

Value in

"human"
"agent_session"
"automation"
"extension"
"network_peer"
"pool"

owner_ref?string

Filter by owner reference

lane?string

Filter by inbox lane

Value in

"my_work"
"approvals"
"failed_runs"
"blocked"
"archived"

status?string

Filter by canonical task status

Value in

"draft"
"pending"
"blocked"
"needs_attention"
"ready"
"in_progress"
"completed"
"failed"
"canceled"

priority?string

Filter by task priority

Value in

"low"
"medium"
"high"
"urgent"

unread?boolean

Filter by unread state; false selects read items

query?string

Filter by task title or identifier

cursor?string

Opaque actor- and query-bound continuation cursor

limit?integer

Page size from 1 to 200 (default 50)

Formatint32

Response Body

`application/json`

curl -X GET "https://example.com/api/observe/tasks/inbox"

{  "inbox": {    "archived_total": 0,    "facets": {      "priorities": [        {          "count": 0,          "priority": "low"        }      ],      "statuses": [        {          "count": 0,          "status": "draft"        }      ]    },    "groups": [      {        "count": 0,        "items": [          {            "approval_policy": "none",            "approval_state": "not_required",            "blocking_reason": "string",            "lane": "my_work",            "latest_activity_at": "2019-08-24T14:15:22Z",            "run": {              "attempt": 0,              "claimed_at": "2019-08-24T14:15:22Z",              "claimed_by": {                "kind": "human",                "ref": "string"              },              "ended_at": "2019-08-24T14:15:22Z",              "error": "string",              "failure_kind": "string",              "heartbeat_at": "2019-08-24T14:15:22Z",              "id": "string",              "lease_until": "2019-08-24T14:15:22Z",              "max_attempts": 0,              "previous_run_id": "string",              "queued_at": "2019-08-24T14:15:22Z",              "recovery_count": 0,              "resolved_network_participation": {                "mode": "local",                "source": "explicit_request",                "version": "network-participation/v1"              },              "resolved_worktree_mode": "none",              "resolved_worktree_ref": "string",              "session_id": "string",              "started_at": "2019-08-24T14:15:22Z",              "status": "queued",              "task_id": "string",              "worktree_id": "string"            },            "task": {              "id": "string",              "identifier": "string",              "latest_event_seq": 0,              "owner": {                "kind": "human",                "ref": "string"              },              "priority": "low",              "scope": "global",              "status": "draft",              "title": "string",              "workspace_id": "string"            },            "triage": {              "actor": {                "kind": "human",                "ref": "string"              },              "archived": true,              "dismissed": true,              "last_seen_activity_at": "2019-08-24T14:15:22Z",              "read": true,              "task_id": "string",              "updated_at": "2019-08-24T14:15:22Z"            }          }        ],        "lane": "my_work",        "unread_count": 0      }    ],    "page": {      "has_more": true,      "limit": 0,      "next_cursor": "string",      "total": 0    },    "unread_total": 0  }}

Force fail a bounded set of queued or claimed task runs

POST/api/runs/bulk/fail

Request Body

application/json

JSON request body

TypeScript Definitions

Use the request body type in TypeScript.

metadata?unknown

reason?string

run_ids*array<string>

Response Body

`application/json`

curl -X POST "https://example.com/api/runs/bulk/fail" \  -H "Content-Type: application/json" \  -d '{    "run_ids": [      "string"    ]  }'

{  "results": [    {      "error": {        "code": "string",        "details": {          "property1": "string",          "property2": "string"        },        "diagnostic": {          "category": "string",          "code": "string",          "data_freshness": "string",          "doc_url": "string",          "evidence": {            "property1": null,            "property2": null          },          "id": "string",          "message": "string",          "severity": "string",          "suggested_command": "string",          "title": "string"        },        "error": "string"      },      "ok": true,      "run": {        "attempt": 0,        "claim_token_hash": "string",        "claimed_at": "2019-08-24T14:15:22Z",        "claimed_by": {          "kind": "human",          "ref": "string"        },        "coordination_channel": {          "allowed_message_kinds": [            "status"          ],          "display_name": "string",          "id": "string",          "last_activity_at": "2019-08-24T14:15:22Z",          "purpose": "string",          "run_id": "string",          "task_id": "string",          "workflow_id": "string",          "workspace_id": "string"        },        "designation": {          "brief": "string",          "index": 0        },        "designation_group_id": "string",        "ended_at": "2019-08-24T14:15:22Z",        "error": "string",        "failure_kind": "string",        "heartbeat_at": "2019-08-24T14:15:22Z",        "id": "string",        "idempotency_key": "string",        "lease_until": "2019-08-24T14:15:22Z",        "metadata": null,        "origin": {          "kind": "cli",          "ref": "string"        },        "previous_run_id": "string",        "queued_at": "2019-08-24T14:15:22Z",        "recovery_count": 0,        "resolved_network_participation": {          "mode": "local",          "source": "explicit_request",          "version": "network-participation/v1"        },        "resolved_worktree_mode": "none",        "resolved_worktree_ref": "string",        "result": null,        "session_id": "string",        "started_at": "2019-08-24T14:15:22Z",        "status": "queued",        "task_id": "string",        "worktree_id": "string"      },      "run_id": "string"    }  ]}

Force release a bounded set of claimed task runs

POST/api/runs/bulk/release

Request Body

application/json

JSON request body

TypeScript Definitions

Use the request body type in TypeScript.

metadata?unknown

reason?string

run_ids*array<string>

Response Body

`application/json`

curl -X POST "https://example.com/api/runs/bulk/release" \  -H "Content-Type: application/json" \  -d '{    "run_ids": [      "string"    ]  }'

{  "results": [    {      "error": {        "code": "string",        "details": {          "property1": "string",          "property2": "string"        },        "diagnostic": {          "category": "string",          "code": "string",          "data_freshness": "string",          "doc_url": "string",          "evidence": {            "property1": null,            "property2": null          },          "id": "string",          "message": "string",          "severity": "string",          "suggested_command": "string",          "title": "string"        },        "error": "string"      },      "ok": true,      "run": {        "attempt": 0,        "claim_token_hash": "string",        "claimed_at": "2019-08-24T14:15:22Z",        "claimed_by": {          "kind": "human",          "ref": "string"        },        "coordination_channel": {          "allowed_message_kinds": [            "status"          ],          "display_name": "string",          "id": "string",          "last_activity_at": "2019-08-24T14:15:22Z",          "purpose": "string",          "run_id": "string",          "task_id": "string",          "workflow_id": "string",          "workspace_id": "string"        },        "designation": {          "brief": "string",          "index": 0        },        "designation_group_id": "string",        "ended_at": "2019-08-24T14:15:22Z",        "error": "string",        "failure_kind": "string",        "heartbeat_at": "2019-08-24T14:15:22Z",        "id": "string",        "idempotency_key": "string",        "lease_until": "2019-08-24T14:15:22Z",        "metadata": null,        "origin": {          "kind": "cli",          "ref": "string"        },        "previous_run_id": "string",        "queued_at": "2019-08-24T14:15:22Z",        "recovery_count": 0,        "resolved_network_participation": {          "mode": "local",          "source": "explicit_request",          "version": "network-participation/v1"        },        "resolved_worktree_mode": "none",        "resolved_worktree_ref": "string",        "result": null,        "session_id": "string",        "started_at": "2019-08-24T14:15:22Z",        "status": "queued",        "task_id": "string",        "worktree_id": "string"      },      "run_id": "string"    }  ]}

Force fail one queued or claimed task run

POST/api/runs/{id}/fail

Path Parameters

id*string

Task run id

Request Body

application/json

JSON request body

TypeScript Definitions

Use the request body type in TypeScript.

metadata?unknown

reason*string

Response Body

`application/json`

curl -X POST "https://example.com/api/runs/string/fail" \  -H "Content-Type: application/json" \  -d '{    "reason": "string"  }'

{  "run": {    "attempt": 0,    "claim_token_hash": "string",    "claimed_at": "2019-08-24T14:15:22Z",    "claimed_by": {      "kind": "human",      "ref": "string"    },    "coordination_channel": {      "allowed_message_kinds": [        "status"      ],      "display_name": "string",      "id": "string",      "last_activity_at": "2019-08-24T14:15:22Z",      "purpose": "string",      "run_id": "string",      "task_id": "string",      "workflow_id": "string",      "workspace_id": "string"    },    "designation": {      "brief": "string",      "index": 0    },    "designation_group_id": "string",    "ended_at": "2019-08-24T14:15:22Z",    "error": "string",    "failure_kind": "string",    "heartbeat_at": "2019-08-24T14:15:22Z",    "id": "string",    "idempotency_key": "string",    "lease_until": "2019-08-24T14:15:22Z",    "metadata": null,    "origin": {      "kind": "cli",      "ref": "string"    },    "previous_run_id": "string",    "queued_at": "2019-08-24T14:15:22Z",    "recovery_count": 0,    "resolved_network_participation": {      "mode": "local",      "source": "explicit_request",      "version": "network-participation/v1"    },    "resolved_worktree_mode": "none",    "resolved_worktree_ref": "string",    "result": null,    "session_id": "string",    "started_at": "2019-08-24T14:15:22Z",    "status": "queued",    "task_id": "string",    "worktree_id": "string"  }}

Inspect one task run with diagnostics

GET/api/runs/{id}/inspect

Path Parameters

id*string

Task run id

Response Body

`application/json`

curl -X GET "https://example.com/api/runs/string/inspect"

{  "inspect": {    "as_of": "2019-08-24T14:15:22Z",    "bound_session": {      "agent_name": "string",      "failure_kind": "string",      "last_activity_at": "2019-08-24T14:15:22Z",      "provider_name": "string",      "session_id": "string",      "started_at": "2019-08-24T14:15:22Z",      "state": "string",      "stop_reason": "string",      "workspace_id": "string"    },    "current_run": {      "attempt": 0,      "bound_session_id": "string",      "claim_token_hash_truncated": "string",      "ended_at": "2019-08-24T14:15:22Z",      "failure_kind": "string",      "heartbeat_age_seconds": 0,      "heartbeat_at": "2019-08-24T14:15:22Z",      "last_error_summary": "string",      "lease_until": "2019-08-24T14:15:22Z",      "previous_run_id": "string",      "queued_at": "2019-08-24T14:15:22Z",      "retries": 0,      "run_id": "string",      "started_at": "2019-08-24T14:15:22Z",      "status": "queued",      "task_id": "string"    },    "diagnostics": [      {        "category": "string",        "code": "string",        "data_freshness": "string",        "doc_url": "string",        "evidence": {          "property1": null,          "property2": null        },        "id": "string",        "message": "string",        "severity": "string",        "suggested_command": "string",        "title": "string"      }    ],    "next_action": "string",    "recent_events": [      {        "id": "string",        "outcome": "string",        "run_id": "string",        "session_id": "string",        "summary": "string",        "task_id": "string",        "timestamp": "2019-08-24T14:15:22Z",        "type": "string"      }    ],    "recent_runs": [      {        "attempt": 0,        "bound_session_id": "string",        "claim_token_hash_truncated": "string",        "ended_at": "2019-08-24T14:15:22Z",        "failure_kind": "string",        "heartbeat_age_seconds": 0,        "heartbeat_at": "2019-08-24T14:15:22Z",        "last_error_summary": "string",        "lease_until": "2019-08-24T14:15:22Z",        "previous_run_id": "string",        "queued_at": "2019-08-24T14:15:22Z",        "retries": 0,        "run_id": "string",        "started_at": "2019-08-24T14:15:22Z",        "status": "queued",        "task_id": "string"      }    ],    "scheduler": {      "paused": true,      "paused_at": "2019-08-24T14:15:22Z",      "paused_by": "string",      "reason": "string",      "updated_at": "2019-08-24T14:15:22Z"    },    "target": "string",    "task": {      "active_run": {        "attempt": 0,        "claim_token_hash": "string",        "claimed_at": "2019-08-24T14:15:22Z",        "claimed_by": {          "kind": "human",          "ref": "string"        },        "coordination_channel": {          "allowed_message_kinds": [            "status"          ],          "display_name": "string",          "id": "string",          "last_activity_at": "2019-08-24T14:15:22Z",          "purpose": "string",          "run_id": "string",          "task_id": "string",          "workflow_id": "string",          "workspace_id": "string"        },        "designation": {          "brief": "string",          "index": 0        },        "designation_group_id": "string",        "ended_at": "2019-08-24T14:15:22Z",        "error": "string",        "failure_kind": "string",        "heartbeat_at": "2019-08-24T14:15:22Z",        "id": "string",        "lease_until": "2019-08-24T14:15:22Z",        "max_attempts": 0,        "previous_run_id": "string",        "queued_at": "2019-08-24T14:15:22Z",        "recovery_count": 0,        "resolved_network_participation": {          "mode": "local",          "source": "explicit_request",          "version": "network-participation/v1"        },        "resolved_worktree_mode": "none",        "resolved_worktree_ref": "string",        "session_id": "string",        "started_at": "2019-08-24T14:15:22Z",        "status": "queued",        "task_id": "string",        "worktree_id": "string"      },      "approval_policy": "none",      "approval_state": "not_required",      "auto_enqueue_on_ready": true,      "blocked_reasons": [        {          "block_id": "string",          "depends_on_task_ids": [            "string"          ],          "kind": "needs_input",          "reason": "string",          "source": "dependency"        }      ],      "child_count": 0,      "closed_at": "2019-08-24T14:15:22Z",      "created_at": "2019-08-24T14:15:22Z",      "created_by": {        "kind": "human",        "ref": "string"      },      "current_run_id": "string",      "dependencies": [        {          "created_at": "2019-08-24T14:15:22Z",          "depends_on": {            "effective_paused": true,            "id": "string",            "identifier": "string",            "latest_event_seq": 0,            "owner": {              "kind": "human",              "ref": "string"            },            "paused": true,            "paused_by_task_id": "string",            "priority": "low",            "scope": "global",            "status": "draft",            "title": "string",            "workspace_id": "string"          },          "depends_on_task_id": "string",          "kind": "blocks",          "task_id": "string"        }      ],      "dependency_count": 0,      "draft": true,      "effective_paused": true,      "id": "string",      "identifier": "string",      "last_activity_at": "2019-08-24T14:15:22Z",      "latest_event_seq": 0,      "max_attempts": 0,      "needs_attention": true,      "needs_attention_at": "2019-08-24T14:15:22Z",      "needs_attention_by": {        "kind": "human",        "ref": "string"      },      "needs_attention_reason": "string",      "origin": {        "kind": "cli",        "ref": "string"      },      "owner": {        "kind": "human",        "ref": "string"      },      "parent_task_id": "string",      "paused": true,      "paused_at": "2019-08-24T14:15:22Z",      "paused_by": "string",      "paused_by_task_id": "string",      "paused_reason": "string",      "priority": "low",      "resolved_network_participation": {        "mode": "local",        "source": "explicit_request",        "version": "network-participation/v1"      },      "scope": "global",      "status": "draft",      "title": "string",      "updated_at": "2019-08-24T14:15:22Z",      "wake_creator": true,      "workspace_id": "string"    }  }}

Recover one needs_attention task run

POST/api/runs/{id}/recover

Path Parameters

id*string

Task run id

Request Body

application/json

JSON request body

TypeScript Definitions

Use the request body type in TypeScript.

metadata?unknown

reason?string

Response Body

`application/json`

curl -X POST "https://example.com/api/runs/string/recover" \  -H "Content-Type: application/json" \  -d '{}'

{  "previous_run": {    "attempt": 0,    "claim_token_hash": "string",    "claimed_at": "2019-08-24T14:15:22Z",    "claimed_by": {      "kind": "human",      "ref": "string"    },    "coordination_channel": {      "allowed_message_kinds": [        "status"      ],      "display_name": "string",      "id": "string",      "last_activity_at": "2019-08-24T14:15:22Z",      "purpose": "string",      "run_id": "string",      "task_id": "string",      "workflow_id": "string",      "workspace_id": "string"    },    "designation": {      "brief": "string",      "index": 0    },    "designation_group_id": "string",    "ended_at": "2019-08-24T14:15:22Z",    "error": "string",    "failure_kind": "string",    "heartbeat_at": "2019-08-24T14:15:22Z",    "id": "string",    "idempotency_key": "string",    "lease_until": "2019-08-24T14:15:22Z",    "metadata": null,    "origin": {      "kind": "cli",      "ref": "string"    },    "previous_run_id": "string",    "queued_at": "2019-08-24T14:15:22Z",    "recovery_count": 0,    "resolved_network_participation": {      "mode": "local",      "source": "explicit_request",      "version": "network-participation/v1"    },    "resolved_worktree_mode": "none",    "resolved_worktree_ref": "string",    "result": null,    "session_id": "string",    "started_at": "2019-08-24T14:15:22Z",    "status": "queued",    "task_id": "string",    "worktree_id": "string"  },  "run": {    "attempt": 0,    "claim_token_hash": "string",    "claimed_at": "2019-08-24T14:15:22Z",    "claimed_by": {      "kind": "human",      "ref": "string"    },    "coordination_channel": {      "allowed_message_kinds": [        "status"      ],      "display_name": "string",      "id": "string",      "last_activity_at": "2019-08-24T14:15:22Z",      "purpose": "string",      "run_id": "string",      "task_id": "string",      "workflow_id": "string",      "workspace_id": "string"    },    "designation": {      "brief": "string",      "index": 0    },    "designation_group_id": "string",    "ended_at": "2019-08-24T14:15:22Z",    "error": "string",    "failure_kind": "string",    "heartbeat_at": "2019-08-24T14:15:22Z",    "id": "string",    "idempotency_key": "string",    "lease_until": "2019-08-24T14:15:22Z",    "metadata": null,    "origin": {      "kind": "cli",      "ref": "string"    },    "previous_run_id": "string",    "queued_at": "2019-08-24T14:15:22Z",    "recovery_count": 0,    "resolved_network_participation": {      "mode": "local",      "source": "explicit_request",      "version": "network-participation/v1"    },    "resolved_worktree_mode": "none",    "resolved_worktree_ref": "string",    "result": null,    "session_id": "string",    "started_at": "2019-08-24T14:15:22Z",    "status": "queued",    "task_id": "string",    "worktree_id": "string"  }}

Force release one claimed task run

POST/api/runs/{id}/release

Path Parameters

id*string

Task run id

Request Body

application/json

JSON request body

TypeScript Definitions

Use the request body type in TypeScript.

metadata?unknown

reason?string

Response Body

`application/json`

curl -X POST "https://example.com/api/runs/string/release" \  -H "Content-Type: application/json" \  -d '{}'

{  "run": {    "attempt": 0,    "claim_token_hash": "string",    "claimed_at": "2019-08-24T14:15:22Z",    "claimed_by": {      "kind": "human",      "ref": "string"    },    "coordination_channel": {      "allowed_message_kinds": [        "status"      ],      "display_name": "string",      "id": "string",      "last_activity_at": "2019-08-24T14:15:22Z",      "purpose": "string",      "run_id": "string",      "task_id": "string",      "workflow_id": "string",      "workspace_id": "string"    },    "designation": {      "brief": "string",      "index": 0    },    "designation_group_id": "string",    "ended_at": "2019-08-24T14:15:22Z",    "error": "string",    "failure_kind": "string",    "heartbeat_at": "2019-08-24T14:15:22Z",    "id": "string",    "idempotency_key": "string",    "lease_until": "2019-08-24T14:15:22Z",    "metadata": null,    "origin": {      "kind": "cli",      "ref": "string"    },    "previous_run_id": "string",    "queued_at": "2019-08-24T14:15:22Z",    "recovery_count": 0,    "resolved_network_participation": {      "mode": "local",      "source": "explicit_request",      "version": "network-participation/v1"    },    "resolved_worktree_mode": "none",    "resolved_worktree_ref": "string",    "result": null,    "session_id": "string",    "started_at": "2019-08-24T14:15:22Z",    "status": "queued",    "task_id": "string",    "worktree_id": "string"  }}

Retry one failed task run

POST/api/runs/{id}/retry

Path Parameters

id*string

Task run id

Request Body

application/json

JSON request body

TypeScript Definitions

Use the request body type in TypeScript.

metadata?unknown

Response Body

`application/json`

curl -X POST "https://example.com/api/runs/string/retry" \  -H "Content-Type: application/json" \  -d '{}'

{  "previous_run": {    "attempt": 0,    "claim_token_hash": "string",    "claimed_at": "2019-08-24T14:15:22Z",    "claimed_by": {      "kind": "human",      "ref": "string"    },    "coordination_channel": {      "allowed_message_kinds": [        "status"      ],      "display_name": "string",      "id": "string",      "last_activity_at": "2019-08-24T14:15:22Z",      "purpose": "string",      "run_id": "string",      "task_id": "string",      "workflow_id": "string",      "workspace_id": "string"    },    "designation": {      "brief": "string",      "index": 0    },    "designation_group_id": "string",    "ended_at": "2019-08-24T14:15:22Z",    "error": "string",    "failure_kind": "string",    "heartbeat_at": "2019-08-24T14:15:22Z",    "id": "string",    "idempotency_key": "string",    "lease_until": "2019-08-24T14:15:22Z",    "metadata": null,    "origin": {      "kind": "cli",      "ref": "string"    },    "previous_run_id": "string",    "queued_at": "2019-08-24T14:15:22Z",    "recovery_count": 0,    "resolved_network_participation": {      "mode": "local",      "source": "explicit_request",      "version": "network-participation/v1"    },    "resolved_worktree_mode": "none",    "resolved_worktree_ref": "string",    "result": null,    "session_id": "string",    "started_at": "2019-08-24T14:15:22Z",    "status": "queued",    "task_id": "string",    "worktree_id": "string"  },  "run": {    "attempt": 0,    "claim_token_hash": "string",    "claimed_at": "2019-08-24T14:15:22Z",    "claimed_by": {      "kind": "human",      "ref": "string"    },    "coordination_channel": {      "allowed_message_kinds": [        "status"      ],      "display_name": "string",      "id": "string",      "last_activity_at": "2019-08-24T14:15:22Z",      "purpose": "string",      "run_id": "string",      "task_id": "string",      "workflow_id": "string",      "workspace_id": "string"    },    "designation": {      "brief": "string",      "index": 0    },    "designation_group_id": "string",    "ended_at": "2019-08-24T14:15:22Z",    "error": "string",    "failure_kind": "string",    "heartbeat_at": "2019-08-24T14:15:22Z",    "id": "string",    "idempotency_key": "string",    "lease_until": "2019-08-24T14:15:22Z",    "metadata": null,    "origin": {      "kind": "cli",      "ref": "string"    },    "previous_run_id": "string",    "queued_at": "2019-08-24T14:15:22Z",    "recovery_count": 0,    "resolved_network_participation": {      "mode": "local",      "source": "explicit_request",      "version": "network-participation/v1"    },    "resolved_worktree_mode": "none",    "resolved_worktree_ref": "string",    "result": null,    "session_id": "string",    "started_at": "2019-08-24T14:15:22Z",    "status": "queued",    "task_id": "string",    "worktree_id": "string"  }}

Get scheduler pause state and queue pressure

GET/api/scheduler

Response Body

`application/json`

curl -X GET "https://example.com/api/scheduler"

{  "scheduler": {    "active_claim_count": 0,    "as_of": "2019-08-24T14:15:22Z",    "needs_attention_run_count": 0,    "paused": true,    "paused_at": "2019-08-24T14:15:22Z",    "paused_by": "string",    "paused_reason": "string",    "paused_task_count": 0,    "queued_run_count": 0,    "starved_run_count": 0  }}

List queued scheduler backlog rows

GET/api/scheduler/backlog

Query Parameters

limit?integer

Maximum number of queued runs to return

Formatint32

scope?string

Filter by catalog visibility

Value in

"all"
"global"
"workspace"

workspace?string

Filter by workspace path, name, or ID

include_paused?boolean

Include runs blocked by task pause state

Response Body

`application/json`

curl -X GET "https://example.com/api/scheduler/backlog"

{  "backlog": {    "runs": [      {        "run": {          "attempt": 0,          "claim_token_hash": "string",          "claimed_at": "2019-08-24T14:15:22Z",          "claimed_by": {            "kind": "human",            "ref": "string"          },          "coordination_channel": {            "allowed_message_kinds": [              "status"            ],            "display_name": "string",            "id": "string",            "last_activity_at": "2019-08-24T14:15:22Z",            "purpose": "string",            "run_id": "string",            "task_id": "string",            "workflow_id": "string",            "workspace_id": "string"          },          "designation": {            "brief": "string",            "index": 0          },          "designation_group_id": "string",          "ended_at": "2019-08-24T14:15:22Z",          "error": "string",          "failure_kind": "string",          "heartbeat_at": "2019-08-24T14:15:22Z",          "id": "string",          "idempotency_key": "string",          "lease_until": "2019-08-24T14:15:22Z",          "metadata": null,          "origin": {            "kind": "cli",            "ref": "string"          },          "previous_run_id": "string",          "queued_at": "2019-08-24T14:15:22Z",          "recovery_count": 0,          "resolved_network_participation": {            "mode": "local",            "source": "explicit_request",            "version": "network-participation/v1"          },          "resolved_worktree_mode": "none",          "resolved_worktree_ref": "string",          "result": null,          "session_id": "string",          "started_at": "2019-08-24T14:15:22Z",          "status": "queued",          "task_id": "string",          "worktree_id": "string"        },        "task": {          "active_run": {            "attempt": 0,            "claim_token_hash": "string",            "claimed_at": "2019-08-24T14:15:22Z",            "claimed_by": {              "kind": "human",              "ref": "string"            },            "coordination_channel": {              "allowed_message_kinds": [                "status"              ],              "display_name": "string",              "id": "string",              "last_activity_at": "2019-08-24T14:15:22Z",              "purpose": "string",              "run_id": "string",              "task_id": "string",              "workflow_id": "string",              "workspace_id": "string"            },            "designation": {              "brief": "string",              "index": 0            },            "designation_group_id": "string",            "ended_at": "2019-08-24T14:15:22Z",            "error": "string",            "failure_kind": "string",            "heartbeat_at": "2019-08-24T14:15:22Z",            "id": "string",            "lease_until": "2019-08-24T14:15:22Z",            "max_attempts": 0,            "previous_run_id": "string",            "queued_at": "2019-08-24T14:15:22Z",            "recovery_count": 0,            "resolved_network_participation": {              "mode": "local",              "source": "explicit_request",              "version": "network-participation/v1"            },            "resolved_worktree_mode": "none",            "resolved_worktree_ref": "string",            "session_id": "string",            "started_at": "2019-08-24T14:15:22Z",            "status": "queued",            "task_id": "string",            "worktree_id": "string"          },          "approval_policy": "none",          "approval_state": "not_required",          "auto_enqueue_on_ready": true,          "blocked_reasons": [            {              "block_id": "string",              "depends_on_task_ids": [                "string"              ],              "kind": "needs_input",              "reason": "string",              "source": "dependency"            }          ],          "child_count": 0,          "closed_at": "2019-08-24T14:15:22Z",          "created_at": "2019-08-24T14:15:22Z",          "created_by": {            "kind": "human",            "ref": "string"          },          "current_run_id": "string",          "dependencies": [            {              "created_at": "2019-08-24T14:15:22Z",              "depends_on": {                "effective_paused": true,                "id": "string",                "identifier": "string",                "latest_event_seq": 0,                "owner": {                  "kind": "human",                  "ref": "string"                },                "paused": true,                "paused_by_task_id": "string",                "priority": "low",                "scope": "global",                "status": "draft",                "title": "string",                "workspace_id": "string"              },              "depends_on_task_id": "string",              "kind": "blocks",              "task_id": "string"            }          ],          "dependency_count": 0,          "draft": true,          "effective_paused": true,          "id": "string",          "identifier": "string",          "last_activity_at": "2019-08-24T14:15:22Z",          "latest_event_seq": 0,          "max_attempts": 0,          "needs_attention": true,          "needs_attention_at": "2019-08-24T14:15:22Z",          "needs_attention_by": {            "kind": "human",            "ref": "string"          },          "needs_attention_reason": "string",          "origin": {            "kind": "cli",            "ref": "string"          },          "owner": {            "kind": "human",            "ref": "string"          },          "parent_task_id": "string",          "paused": true,          "paused_at": "2019-08-24T14:15:22Z",          "paused_by": "string",          "paused_by_task_id": "string",          "paused_reason": "string",          "priority": "low",          "resolved_network_participation": {            "mode": "local",            "source": "explicit_request",            "version": "network-participation/v1"          },          "scope": "global",          "status": "draft",          "title": "string",          "updated_at": "2019-08-24T14:15:22Z",          "wake_creator": true,          "workspace_id": "string"        }      }    ],    "total": 0  }}

Pause the scheduler and wait for active claims to drain

POST/api/scheduler/drain

Request Body

application/json

JSON request body

TypeScript Definitions

Use the request body type in TypeScript.

reason?string

timeout_seconds?|

Formatint64

Range0 <= value <= 9223372036

Response Body

`application/json`

curl -X POST "https://example.com/api/scheduler/drain" \  -H "Content-Type: application/json" \  -d '{}'

{  "completed": true,  "completed_at": "2019-08-24T14:15:22Z",  "remaining_claims": 0,  "scheduler": {    "active_claim_count": 0,    "as_of": "2019-08-24T14:15:22Z",    "needs_attention_run_count": 0,    "paused": true,    "paused_at": "2019-08-24T14:15:22Z",    "paused_by": "string",    "paused_reason": "string",    "paused_task_count": 0,    "queued_run_count": 0,    "starved_run_count": 0  },  "started_at": "2019-08-24T14:15:22Z",  "timed_out": true}

Pause scheduler dispatch and task-run claims

POST/api/scheduler/pause

Request Body

application/json

JSON request body

TypeScript Definitions

Use the request body type in TypeScript.

reason?string

Response Body

`application/json`

curl -X POST "https://example.com/api/scheduler/pause" \  -H "Content-Type: application/json" \  -d '{}'

{  "scheduler": {    "active_claim_count": 0,    "as_of": "2019-08-24T14:15:22Z",    "needs_attention_run_count": 0,    "paused": true,    "paused_at": "2019-08-24T14:15:22Z",    "paused_by": "string",    "paused_reason": "string",    "paused_task_count": 0,    "queued_run_count": 0,    "starved_run_count": 0  }}

Resume scheduler dispatch and task-run claims

POST/api/scheduler/resume

Request Body

application/json

JSON request body

TypeScript Definitions

Use the request body type in TypeScript.

reason?string

Response Body

`application/json`

curl -X POST "https://example.com/api/scheduler/resume" \  -H "Content-Type: application/json" \  -d '{}'

{  "scheduler": {    "active_claim_count": 0,    "as_of": "2019-08-24T14:15:22Z",    "needs_attention_run_count": 0,    "paused": true,    "paused_at": "2019-08-24T14:15:22Z",    "paused_by": "string",    "paused_reason": "string",    "paused_task_count": 0,    "queued_run_count": 0,    "starved_run_count": 0  }}

Get one task-run review

GET/api/task-reviews/{id}

Path Parameters

id*string

Review id

Response Body

`application/json`

curl -X GET "https://example.com/api/task-reviews/string"

{  "review": {    "attempt": 0,    "confidence": 0,    "created_at": "2019-08-24T14:15:22Z",    "deadline_at": "2019-08-24T14:15:22Z",    "delivery_id": "string",    "missing_work": null,    "next_round_guidance": "string",    "outcome": "approved",    "parent_review_id": "string",    "policy": "none",    "reason": "string",    "requested_at": "2019-08-24T14:15:22Z",    "review_id": "string",    "review_round": 0,    "review_text": "string",    "reviewed_at": "2019-08-24T14:15:22Z",    "reviewed_by": {      "kind": "human",      "ref": "string"    },    "reviewer_agent_name": "string",    "reviewer_channel_id": "string",    "reviewer_peer_id": "string",    "reviewer_session_id": "string",    "routed_at": "2019-08-24T14:15:22Z",    "run_id": "string",    "started_at": "2019-08-24T14:15:22Z",    "status": "requested",    "task_id": "string",    "updated_at": "2019-08-24T14:15:22Z"  }}

Submit one task-run review verdict

POST/api/task-reviews/{id}/verdict

Path Parameters

id*string

Review id

Request Body

application/json

JSON request body

TypeScript Definitions

Use the request body type in TypeScript.

run_id*string

verdict*

Response Body

`application/json`

curl -X POST "https://example.com/api/task-reviews/string/verdict" \  -H "Content-Type: application/json" \  -d '{    "run_id": "string",    "verdict": {      "confidence": 0,      "delivery_id": "string",      "outcome": "approved",      "reason": "string"    }  }'

{  "circuit_opened": true,  "continuation_run": {    "attempt": 0,    "claim_token_hash": "string",    "claimed_at": "2019-08-24T14:15:22Z",    "claimed_by": {      "kind": "human",      "ref": "string"    },    "coordination_channel": {      "allowed_message_kinds": [        "status"      ],      "display_name": "string",      "id": "string",      "last_activity_at": "2019-08-24T14:15:22Z",      "purpose": "string",      "run_id": "string",      "task_id": "string",      "workflow_id": "string",      "workspace_id": "string"    },    "designation": {      "brief": "string",      "index": 0    },    "designation_group_id": "string",    "ended_at": "2019-08-24T14:15:22Z",    "error": "string",    "failure_kind": "string",    "heartbeat_at": "2019-08-24T14:15:22Z",    "id": "string",    "idempotency_key": "string",    "lease_until": "2019-08-24T14:15:22Z",    "metadata": null,    "origin": {      "kind": "cli",      "ref": "string"    },    "previous_run_id": "string",    "queued_at": "2019-08-24T14:15:22Z",    "recovery_count": 0,    "resolved_network_participation": {      "mode": "local",      "source": "explicit_request",      "version": "network-participation/v1"    },    "resolved_worktree_mode": "none",    "resolved_worktree_ref": "string",    "result": null,    "session_id": "string",    "started_at": "2019-08-24T14:15:22Z",    "status": "queued",    "task_id": "string",    "worktree_id": "string"  },  "review": {    "attempt": 0,    "confidence": 0,    "created_at": "2019-08-24T14:15:22Z",    "deadline_at": "2019-08-24T14:15:22Z",    "delivery_id": "string",    "missing_work": null,    "next_round_guidance": "string",    "outcome": "approved",    "parent_review_id": "string",    "policy": "none",    "reason": "string",    "requested_at": "2019-08-24T14:15:22Z",    "review_id": "string",    "review_round": 0,    "review_text": "string",    "reviewed_at": "2019-08-24T14:15:22Z",    "reviewed_by": {      "kind": "human",      "ref": "string"    },    "reviewer_agent_name": "string",    "reviewer_channel_id": "string",    "reviewer_peer_id": "string",    "reviewer_session_id": "string",    "routed_at": "2019-08-24T14:15:22Z",    "run_id": "string",    "started_at": "2019-08-24T14:15:22Z",    "status": "requested",    "task_id": "string",    "updated_at": "2019-08-24T14:15:22Z"  }}

Get one task run detail

GET/api/task-runs/{id}

Path Parameters

id*string

Task run id

Response Body

`application/json`

curl -X GET "https://example.com/api/task-runs/string"

{  "run": {    "network": {      "conversation": {        "channel": "string",        "stream_url": "string",        "surface": "string",        "thread_id": "string",        "workspace_id": "string"      },      "usage": {        "budget": {          "exhausted_reason": "string",          "input_tokens_used": 0,          "output_tokens_used": 0,          "participation_status": {            "available": true,            "owner": {              "id": "string",              "kind": "session",              "workspace_id": "string"            },            "participating": true,            "reason": "string"          },          "updated_at": "2019-08-24T14:15:22Z",          "wakes_used": 0,          "wall_time_used": "string"        },        "details": [          {            "channel": "string",            "charged_wall_time": "string",            "depth": 0,            "input_tokens": 0,            "output_tokens": 0,            "participation_status": {              "available": true,              "owner": {                "id": "string",                "kind": "session",                "workspace_id": "string"              },              "participating": true,              "reason": "string"            },            "reason": "string",            "reserved_at": "2019-08-24T14:15:22Z",            "root_id": "string",            "settled_at": "2019-08-24T14:15:22Z",            "state": "string",            "task_run_id": "string",            "usage_state": "string",            "wake_id": "string",            "workspace_id": "string"          }        ],        "next_cursor": "string",        "total": {          "actual_wake_count": 0,          "charged_wall_time": "string",          "input_tokens": 0,          "output_tokens": 0,          "reserved_wake_count": 0,          "unavailable_wake_count": 0,          "wake_count": 0        },        "workspace_id": "string"      }    },    "run": {      "attempt": 0,      "claim_token_hash": "string",      "claimed_at": "2019-08-24T14:15:22Z",      "claimed_by": {        "kind": "human",        "ref": "string"      },      "coordination_channel": {        "allowed_message_kinds": [          "status"        ],        "display_name": "string",        "id": "string",        "last_activity_at": "2019-08-24T14:15:22Z",        "purpose": "string",        "run_id": "string",        "task_id": "string",        "workflow_id": "string",        "workspace_id": "string"      },      "designation": {        "brief": "string",        "index": 0      },      "designation_group_id": "string",      "ended_at": "2019-08-24T14:15:22Z",      "error": "string",      "failure_kind": "string",      "heartbeat_at": "2019-08-24T14:15:22Z",      "id": "string",      "idempotency_key": "string",      "lease_until": "2019-08-24T14:15:22Z",      "metadata": null,      "origin": {        "kind": "cli",        "ref": "string"      },      "previous_run_id": "string",      "queued_at": "2019-08-24T14:15:22Z",      "recovery_count": 0,      "resolved_network_participation": {        "mode": "local",        "source": "explicit_request",        "version": "network-participation/v1"      },      "resolved_worktree_mode": "none",      "resolved_worktree_ref": "string",      "result": null,      "session_id": "string",      "started_at": "2019-08-24T14:15:22Z",      "status": "queued",      "task_id": "string",      "worktree_id": "string"    },    "session": {      "agent_name": "string",      "created_at": "2019-08-24T14:15:22Z",      "name": "string",      "session_id": "string",      "state": "string",      "updated_at": "2019-08-24T14:15:22Z",      "workspace_id": "string"    },    "summary": {      "cost_currency": "string",      "cost_source": "agent_reported",      "cost_status": "actual",      "input_tokens": 0,      "last_activity_at": "2019-08-24T14:15:22Z",      "last_event_type": "string",      "output_tokens": 0,      "tool_call_count": 0,      "total_cost": 0,      "total_tokens": 0,      "turn_count": 0    },    "task": {      "effective_paused": true,      "id": "string",      "identifier": "string",      "latest_event_seq": 0,      "owner": {        "kind": "human",        "ref": "string"      },      "paused": true,      "paused_by_task_id": "string",      "priority": "low",      "scope": "global",      "status": "draft",      "title": "string",      "workspace_id": "string"    }  }}

Attach an existing session to one task run

POST/api/task-runs/{id}/attach-session

Path Parameters

id*string

Task run id

Request Body

application/json

JSON request body

TypeScript Definitions

Use the request body type in TypeScript.

session_id*string

Response Body

`application/json`

curl -X POST "https://example.com/api/task-runs/string/attach-session" \  -H "Content-Type: application/json" \  -d '{    "session_id": "string"  }'

{  "run": {    "attempt": 0,    "claim_token_hash": "string",    "claimed_at": "2019-08-24T14:15:22Z",    "claimed_by": {      "kind": "human",      "ref": "string"    },    "coordination_channel": {      "allowed_message_kinds": [        "status"      ],      "display_name": "string",      "id": "string",      "last_activity_at": "2019-08-24T14:15:22Z",      "purpose": "string",      "run_id": "string",      "task_id": "string",      "workflow_id": "string",      "workspace_id": "string"    },    "designation": {      "brief": "string",      "index": 0    },    "designation_group_id": "string",    "ended_at": "2019-08-24T14:15:22Z",    "error": "string",    "failure_kind": "string",    "heartbeat_at": "2019-08-24T14:15:22Z",    "id": "string",    "idempotency_key": "string",    "lease_until": "2019-08-24T14:15:22Z",    "metadata": null,    "origin": {      "kind": "cli",      "ref": "string"    },    "previous_run_id": "string",    "queued_at": "2019-08-24T14:15:22Z",    "recovery_count": 0,    "resolved_network_participation": {      "mode": "local",      "source": "explicit_request",      "version": "network-participation/v1"    },    "resolved_worktree_mode": "none",    "resolved_worktree_ref": "string",    "result": null,    "session_id": "string",    "started_at": "2019-08-24T14:15:22Z",    "status": "queued",    "task_id": "string",    "worktree_id": "string"  }}

Cancel one task run

POST/api/task-runs/{id}/cancel

Path Parameters

id*string

Task run id

Request Body

application/json

JSON request body

TypeScript Definitions

Use the request body type in TypeScript.

metadata?unknown

reason?string

Response Body

`application/json`

curl -X POST "https://example.com/api/task-runs/string/cancel" \  -H "Content-Type: application/json" \  -d '{}'

{  "run": {    "attempt": 0,    "claim_token_hash": "string",    "claimed_at": "2019-08-24T14:15:22Z",    "claimed_by": {      "kind": "human",      "ref": "string"    },    "coordination_channel": {      "allowed_message_kinds": [        "status"      ],      "display_name": "string",      "id": "string",      "last_activity_at": "2019-08-24T14:15:22Z",      "purpose": "string",      "run_id": "string",      "task_id": "string",      "workflow_id": "string",      "workspace_id": "string"    },    "designation": {      "brief": "string",      "index": 0    },    "designation_group_id": "string",    "ended_at": "2019-08-24T14:15:22Z",    "error": "string",    "failure_kind": "string",    "heartbeat_at": "2019-08-24T14:15:22Z",    "id": "string",    "idempotency_key": "string",    "lease_until": "2019-08-24T14:15:22Z",    "metadata": null,    "origin": {      "kind": "cli",      "ref": "string"    },    "previous_run_id": "string",    "queued_at": "2019-08-24T14:15:22Z",    "recovery_count": 0,    "resolved_network_participation": {      "mode": "local",      "source": "explicit_request",      "version": "network-participation/v1"    },    "resolved_worktree_mode": "none",    "resolved_worktree_ref": "string",    "result": null,    "session_id": "string",    "started_at": "2019-08-24T14:15:22Z",    "status": "queued",    "task_id": "string",    "worktree_id": "string"  }}

Complete one running task run

POST/api/task-runs/{id}/complete

Path Parameters

id*string

Task run id

Request Body

application/json

JSON request body

TypeScript Definitions

Use the request body type in TypeScript.

created_task_ids?array<string>

result?unknown

Response Body

`application/json`

curl -X POST "https://example.com/api/task-runs/string/complete" \  -H "Content-Type: application/json" \  -d '{}'

{  "run": {    "attempt": 0,    "claim_token_hash": "string",    "claimed_at": "2019-08-24T14:15:22Z",    "claimed_by": {      "kind": "human",      "ref": "string"    },    "coordination_channel": {      "allowed_message_kinds": [        "status"      ],      "display_name": "string",      "id": "string",      "last_activity_at": "2019-08-24T14:15:22Z",      "purpose": "string",      "run_id": "string",      "task_id": "string",      "workflow_id": "string",      "workspace_id": "string"    },    "designation": {      "brief": "string",      "index": 0    },    "designation_group_id": "string",    "ended_at": "2019-08-24T14:15:22Z",    "error": "string",    "failure_kind": "string",    "heartbeat_at": "2019-08-24T14:15:22Z",    "id": "string",    "idempotency_key": "string",    "lease_until": "2019-08-24T14:15:22Z",    "metadata": null,    "origin": {      "kind": "cli",      "ref": "string"    },    "previous_run_id": "string",    "queued_at": "2019-08-24T14:15:22Z",    "recovery_count": 0,    "resolved_network_participation": {      "mode": "local",      "source": "explicit_request",      "version": "network-participation/v1"    },    "resolved_worktree_mode": "none",    "resolved_worktree_ref": "string",    "result": null,    "session_id": "string",    "started_at": "2019-08-24T14:15:22Z",    "status": "queued",    "task_id": "string",    "worktree_id": "string"  }}

Stream one task run coordination conversation

GET/api/task-runs/{id}/conversation/stream

Path Parameters

id*string

Task run id

Query Parameters

after?string

Replay messages after this message id

Response Body

`text/event-stream`

`application/json`

curl -X GET "https://example.com/api/task-runs/string/conversation/stream"

{  "message": {    "body": null,    "causation_id": "string",    "channel": "string",    "direct_id": "string",    "direction": "string",    "display_name": "string",    "intent": "string",    "kind": "string",    "local": true,    "mentions": [      "string"    ],    "message_id": "string",    "peer_from": "string",    "peer_to": "string",    "preview_text": "string",    "reply_to": "string",    "session_id": "string",    "size_bytes": 0,    "surface": "string",    "text": "string",    "thread_id": "string",    "timestamp": "2019-08-24T14:15:22Z",    "trace_id": "string",    "work_id": "string",    "workspace_id": "string"  },  "usage": {    "budget": {      "exhausted_reason": "string",      "input_tokens_used": 0,      "output_tokens_used": 0,      "participation_status": {        "available": true,        "owner": {          "id": "string",          "kind": "session",          "workspace_id": "string"        },        "participating": true,        "reason": "string"      },      "updated_at": "2019-08-24T14:15:22Z",      "wakes_used": 0,      "wall_time_used": "string"    },    "details": [      {        "channel": "string",        "charged_wall_time": "string",        "depth": 0,        "input_tokens": 0,        "output_tokens": 0,        "participation_status": {          "available": true,          "owner": {            "id": "string",            "kind": "session",            "workspace_id": "string"          },          "participating": true,          "reason": "string"        },        "reason": "string",        "reserved_at": "2019-08-24T14:15:22Z",        "root_id": "string",        "settled_at": "2019-08-24T14:15:22Z",        "state": "string",        "task_run_id": "string",        "usage_state": "string",        "wake_id": "string",        "workspace_id": "string"      }    ],    "next_cursor": "string",    "total": {      "actual_wake_count": 0,      "charged_wall_time": "string",      "input_tokens": 0,      "output_tokens": 0,      "reserved_wake_count": 0,      "unavailable_wake_count": 0,      "wake_count": 0    },    "workspace_id": "string"  }}

Fail one task run

POST/api/task-runs/{id}/fail

Path Parameters

id*string

Task run id

Request Body

application/json

JSON request body

TypeScript Definitions

Use the request body type in TypeScript.

error*string

metadata?unknown

Response Body

`application/json`

curl -X POST "https://example.com/api/task-runs/string/fail" \  -H "Content-Type: application/json" \  -d '{    "error": "string"  }'

{  "run": {    "attempt": 0,    "claim_token_hash": "string",    "claimed_at": "2019-08-24T14:15:22Z",    "claimed_by": {      "kind": "human",      "ref": "string"    },    "coordination_channel": {      "allowed_message_kinds": [        "status"      ],      "display_name": "string",      "id": "string",      "last_activity_at": "2019-08-24T14:15:22Z",      "purpose": "string",      "run_id": "string",      "task_id": "string",      "workflow_id": "string",      "workspace_id": "string"    },    "designation": {      "brief": "string",      "index": 0    },    "designation_group_id": "string",    "ended_at": "2019-08-24T14:15:22Z",    "error": "string",    "failure_kind": "string",    "heartbeat_at": "2019-08-24T14:15:22Z",    "id": "string",    "idempotency_key": "string",    "lease_until": "2019-08-24T14:15:22Z",    "metadata": null,    "origin": {      "kind": "cli",      "ref": "string"    },    "previous_run_id": "string",    "queued_at": "2019-08-24T14:15:22Z",    "recovery_count": 0,    "resolved_network_participation": {      "mode": "local",      "source": "explicit_request",      "version": "network-participation/v1"    },    "resolved_worktree_mode": "none",    "resolved_worktree_ref": "string",    "result": null,    "session_id": "string",    "started_at": "2019-08-24T14:15:22Z",    "status": "queued",    "task_id": "string",    "worktree_id": "string"  }}

List reviews for one task run

GET/api/task-runs/{id}/reviews

Path Parameters

id*string

Task run id

Query Parameters

status?string

Filter by review status

Value in

"requested"
"routed"
"in_review"
"recorded"
"circuit_opened"
"canceled"

reviewer_session_id?string

Filter by reviewer session id

limit?integer

Maximum number of records to return

Formatint32

Response Body

`application/json`

curl -X GET "https://example.com/api/task-runs/string/reviews"

{  "reviews": [    {      "attempt": 0,      "confidence": 0,      "created_at": "2019-08-24T14:15:22Z",      "deadline_at": "2019-08-24T14:15:22Z",      "delivery_id": "string",      "missing_work": null,      "next_round_guidance": "string",      "outcome": "approved",      "parent_review_id": "string",      "policy": "none",      "reason": "string",      "requested_at": "2019-08-24T14:15:22Z",      "review_id": "string",      "review_round": 0,      "review_text": "string",      "reviewed_at": "2019-08-24T14:15:22Z",      "reviewed_by": {        "kind": "human",        "ref": "string"      },      "reviewer_agent_name": "string",      "reviewer_channel_id": "string",      "reviewer_peer_id": "string",      "reviewer_session_id": "string",      "routed_at": "2019-08-24T14:15:22Z",      "run_id": "string",      "started_at": "2019-08-24T14:15:22Z",      "status": "requested",      "task_id": "string",      "updated_at": "2019-08-24T14:15:22Z"    }  ]}

Request review for one terminal task run

POST/api/task-runs/{id}/reviews

Path Parameters

id*string

Task run id

Request Body

application/json

JSON request body

TypeScript Definitions

Use the request body type in TypeScript.

attempt?integer

deadline_at*string

Formatdate-time

parent_review_id?string

policy?string

Value in

"none"
"always"
"on_success"
"on_failure"

reason?string

review_round?integer

run_id*string

task_id*string

Response Body

`application/json`

curl -X POST "https://example.com/api/task-runs/string/reviews" \  -H "Content-Type: application/json" \  -d '{    "deadline_at": "2019-08-24T14:15:22Z",    "run_id": "string",    "task_id": "string"  }'

{  "created": true,  "review": {    "attempt": 0,    "confidence": 0,    "created_at": "2019-08-24T14:15:22Z",    "deadline_at": "2019-08-24T14:15:22Z",    "delivery_id": "string",    "missing_work": null,    "next_round_guidance": "string",    "outcome": "approved",    "parent_review_id": "string",    "policy": "none",    "reason": "string",    "requested_at": "2019-08-24T14:15:22Z",    "review_id": "string",    "review_round": 0,    "review_text": "string",    "reviewed_at": "2019-08-24T14:15:22Z",    "reviewed_by": {      "kind": "human",      "ref": "string"    },    "reviewer_agent_name": "string",    "reviewer_channel_id": "string",    "reviewer_peer_id": "string",    "reviewer_session_id": "string",    "routed_at": "2019-08-24T14:15:22Z",    "run_id": "string",    "started_at": "2019-08-24T14:15:22Z",    "status": "requested",    "task_id": "string",    "updated_at": "2019-08-24T14:15:22Z"  }}

Start one claimed task run

POST/api/task-runs/{id}/start

Path Parameters

id*string

Task run id

Request Body

application/json

JSON request body

TypeScript Definitions

Use the request body type in TypeScript.

idempotency_key?string

Response Body

`application/json`

curl -X POST "https://example.com/api/task-runs/string/start" \  -H "Content-Type: application/json" \  -d '{}'

{  "run": {    "attempt": 0,    "claim_token_hash": "string",    "claimed_at": "2019-08-24T14:15:22Z",    "claimed_by": {      "kind": "human",      "ref": "string"    },    "coordination_channel": {      "allowed_message_kinds": [        "status"      ],      "display_name": "string",      "id": "string",      "last_activity_at": "2019-08-24T14:15:22Z",      "purpose": "string",      "run_id": "string",      "task_id": "string",      "workflow_id": "string",      "workspace_id": "string"    },    "designation": {      "brief": "string",      "index": 0    },    "designation_group_id": "string",    "ended_at": "2019-08-24T14:15:22Z",    "error": "string",    "failure_kind": "string",    "heartbeat_at": "2019-08-24T14:15:22Z",    "id": "string",    "idempotency_key": "string",    "lease_until": "2019-08-24T14:15:22Z",    "metadata": null,    "origin": {      "kind": "cli",      "ref": "string"    },    "previous_run_id": "string",    "queued_at": "2019-08-24T14:15:22Z",    "recovery_count": 0,    "resolved_network_participation": {      "mode": "local",      "source": "explicit_request",      "version": "network-participation/v1"    },    "resolved_worktree_mode": "none",    "resolved_worktree_ref": "string",    "result": null,    "session_id": "string",    "started_at": "2019-08-24T14:15:22Z",    "status": "queued",    "task_id": "string",    "worktree_id": "string"  }}

List a bounded task catalog page

GET/api/tasks

Query Parameters

scope?string

Filter by catalog visibility

Value in

"all"
"global"
"workspace"

workspace?string

Filter by workspace path, name, or ID

status?string

Filter by task status

Value in

"draft"
"pending"
"blocked"
"needs_attention"
"ready"
"in_progress"
"completed"
"failed"
"canceled"

priority?string

Filter by task priority

Value in

"low"
"medium"
"high"
"urgent"

include_drafts?boolean

Include draft tasks in list results

approval_state?string

Filter by task approval state

Value in

"not_required"
"pending"
"approved"
"rejected"

owner_kind?string

Filter by owner kind

Value in

"human"
"agent_session"
"automation"
"extension"
"network_peer"
"pool"

owner_ref?string

Filter by owner reference

parent_task_id?string

Filter by parent task ID

worktree?string

Filter by active run worktree ID

participation_channel?string

Filter by resolved participation channel

query?string

Filter by task title or identifier

sort?string

Order by recent activity or priority

Value in

"recent"
"priority"

cursor?string

Opaque query-bound continuation cursor

limit?integer

Page size from 1 to 200 (default 50)

Formatint32

Response Body

`application/json`

curl -X GET "https://example.com/api/tasks"

{  "facets": {    "owners": [      {        "count": 0,        "owner": {          "kind": "human",          "ref": "string"        }      }    ],    "statuses": [      {        "count": 0,        "status": "draft"      }    ]  },  "page": {    "has_more": true,    "limit": 0,    "next_cursor": "string",    "total": 0  },  "tasks": [    {      "active_run": {        "attempt": 0,        "claimed_at": "2019-08-24T14:15:22Z",        "claimed_by": {          "kind": "human",          "ref": "string"        },        "ended_at": "2019-08-24T14:15:22Z",        "error": "string",        "failure_kind": "string",        "heartbeat_at": "2019-08-24T14:15:22Z",        "id": "string",        "lease_until": "2019-08-24T14:15:22Z",        "max_attempts": 0,        "previous_run_id": "string",        "queued_at": "2019-08-24T14:15:22Z",        "recovery_count": 0,        "resolved_network_participation": {          "mode": "local",          "source": "explicit_request",          "version": "network-participation/v1"        },        "resolved_worktree_mode": "none",        "resolved_worktree_ref": "string",        "session_id": "string",        "started_at": "2019-08-24T14:15:22Z",        "status": "queued",        "task_id": "string",        "worktree_id": "string"      },      "approval_policy": "none",      "approval_state": "not_required",      "auto_enqueue_on_ready": true,      "child_count": 0,      "closed_at": "2019-08-24T14:15:22Z",      "created_at": "2019-08-24T14:15:22Z",      "created_by": {        "kind": "human",        "ref": "string"      },      "current_run_id": "string",      "dependency_count": 0,      "draft": true,      "id": "string",      "identifier": "string",      "last_activity_at": "2019-08-24T14:15:22Z",      "latest_event_seq": 0,      "max_attempts": 0,      "needs_attention": true,      "needs_attention_at": "2019-08-24T14:15:22Z",      "needs_attention_by": {        "kind": "human",        "ref": "string"      },      "needs_attention_reason": "string",      "origin": {        "kind": "cli",        "ref": "string"      },      "owner": {        "kind": "human",        "ref": "string"      },      "parent_task_id": "string",      "priority": "low",      "resolved_network_participation": {        "mode": "local",        "source": "explicit_request",        "version": "network-participation/v1"      },      "scope": "global",      "status": "draft",      "title": "string",      "updated_at": "2019-08-24T14:15:22Z",      "wake_creator": true,      "workspace_id": "string"    }  ]}

Create a task

POST/api/tasks

Request Body

application/json

JSON request body

TypeScript Definitions

Use the request body type in TypeScript.

approval_policy?string

Value in

"none"
"manual"

auto_enqueue_on_ready?boolean

description?string

draft?boolean

id?string

identifier?string

max_attempts?integer|null

metadata?unknown

network_participation?|||

owner?|null

priority?string

Value in

"low"
"medium"
"high"
"urgent"

scope*string

Value in

"global"
"workspace"

title*string

wake_creator?boolean|null

workspace?string

Response Body

`application/json`

curl -X POST "https://example.com/api/tasks" \  -H "Content-Type: application/json" \  -d '{    "scope": "global",    "title": "string"  }'

{  "task": {    "approval_policy": "none",    "approval_state": "not_required",    "auto_enqueue_on_ready": true,    "blocked_reasons": [      {        "block_id": "string",        "depends_on_task_ids": [          "string"        ],        "kind": "needs_input",        "reason": "string",        "source": "dependency"      }    ],    "closed_at": "2019-08-24T14:15:22Z",    "created_at": "2019-08-24T14:15:22Z",    "created_by": {      "kind": "human",      "ref": "string"    },    "current_run_id": "string",    "description": "string",    "draft": true,    "effective_paused": true,    "id": "string",    "identifier": "string",    "latest_event_seq": 0,    "max_attempts": 0,    "metadata": null,    "needs_attention": true,    "needs_attention_at": "2019-08-24T14:15:22Z",    "needs_attention_by": {      "kind": "human",      "ref": "string"    },    "needs_attention_reason": "string",    "origin": {      "kind": "cli",      "ref": "string"    },    "owner": {      "kind": "human",      "ref": "string"    },    "parent_task_id": "string",    "paused": true,    "paused_at": "2019-08-24T14:15:22Z",    "paused_by": "string",    "paused_by_task_id": "string",    "paused_reason": "string",    "priority": "low",    "resolved_network_participation": {      "mode": "local",      "source": "explicit_request",      "version": "network-participation/v1"    },    "scope": "global",    "status": "draft",    "title": "string",    "updated_at": "2019-08-24T14:15:22Z",    "wake_creator": true,    "workspace_id": "string"  }}

Get one task with detail

GET/api/tasks/{id}

Path Parameters

id*string

Task id

Response Body

`application/json`

curl -X GET "https://example.com/api/tasks/string"

{  "task": {    "children": [      {        "active_run": {          "attempt": 0,          "claim_token_hash": "string",          "claimed_at": "2019-08-24T14:15:22Z",          "claimed_by": {            "kind": "human",            "ref": "string"          },          "coordination_channel": {            "allowed_message_kinds": [              "status"            ],            "display_name": "string",            "id": "string",            "last_activity_at": "2019-08-24T14:15:22Z",            "purpose": "string",            "run_id": "string",            "task_id": "string",            "workflow_id": "string",            "workspace_id": "string"          },          "designation": {            "brief": "string",            "index": 0          },          "designation_group_id": "string",          "ended_at": "2019-08-24T14:15:22Z",          "error": "string",          "failure_kind": "string",          "heartbeat_at": "2019-08-24T14:15:22Z",          "id": "string",          "lease_until": "2019-08-24T14:15:22Z",          "max_attempts": 0,          "previous_run_id": "string",          "queued_at": "2019-08-24T14:15:22Z",          "recovery_count": 0,          "resolved_network_participation": {            "mode": "local",            "source": "explicit_request",            "version": "network-participation/v1"          },          "resolved_worktree_mode": "none",          "resolved_worktree_ref": "string",          "session_id": "string",          "started_at": "2019-08-24T14:15:22Z",          "status": "queued",          "task_id": "string",          "worktree_id": "string"        },        "approval_policy": "none",        "approval_state": "not_required",        "auto_enqueue_on_ready": true,        "blocked_reasons": [          {            "block_id": "string",            "depends_on_task_ids": [              "string"            ],            "kind": "needs_input",            "reason": "string",            "source": "dependency"          }        ],        "child_count": 0,        "closed_at": "2019-08-24T14:15:22Z",        "created_at": "2019-08-24T14:15:22Z",        "created_by": {          "kind": "human",          "ref": "string"        },        "current_run_id": "string",        "dependencies": [          {            "created_at": "2019-08-24T14:15:22Z",            "depends_on": {              "effective_paused": true,              "id": "string",              "identifier": "string",              "latest_event_seq": 0,              "owner": {                "kind": "human",                "ref": "string"              },              "paused": true,              "paused_by_task_id": "string",              "priority": "low",              "scope": "global",              "status": "draft",              "title": "string",              "workspace_id": "string"            },            "depends_on_task_id": "string",            "kind": "blocks",            "task_id": "string"          }        ],        "dependency_count": 0,        "draft": true,        "effective_paused": true,        "id": "string",        "identifier": "string",        "last_activity_at": "2019-08-24T14:15:22Z",        "latest_event_seq": 0,        "max_attempts": 0,        "needs_attention": true,        "needs_attention_at": "2019-08-24T14:15:22Z",        "needs_attention_by": {          "kind": "human",          "ref": "string"        },        "needs_attention_reason": "string",        "origin": {          "kind": "cli",          "ref": "string"        },        "owner": {          "kind": "human",          "ref": "string"        },        "parent_task_id": "string",        "paused": true,        "paused_at": "2019-08-24T14:15:22Z",        "paused_by": "string",        "paused_by_task_id": "string",        "paused_reason": "string",        "priority": "low",        "resolved_network_participation": {          "mode": "local",          "source": "explicit_request",          "version": "network-participation/v1"        },        "scope": "global",        "status": "draft",        "title": "string",        "updated_at": "2019-08-24T14:15:22Z",        "wake_creator": true,        "workspace_id": "string"      }    ],    "dependencies": [      {        "created_at": "2019-08-24T14:15:22Z",        "depends_on_task_id": "string",        "kind": "blocks",        "task_id": "string"      }    ],    "dependency_references": [      {        "created_at": "2019-08-24T14:15:22Z",        "depends_on": {          "effective_paused": true,          "id": "string",          "identifier": "string",          "latest_event_seq": 0,          "owner": {            "kind": "human",            "ref": "string"          },          "paused": true,          "paused_by_task_id": "string",          "priority": "low",          "scope": "global",          "status": "draft",          "title": "string",          "workspace_id": "string"        },        "depends_on_task_id": "string",        "kind": "blocks",        "task_id": "string"      }    ],    "designation_rollups": [      {        "created_at": "2019-08-24T14:15:22Z",        "designation_group_id": "string",        "summary": null,        "task_id": "string"      }    ],    "events": [      {        "actor": {          "kind": "human",          "ref": "string"        },        "event_type": "string",        "id": "string",        "origin": {          "kind": "cli",          "ref": "string"        },        "payload": null,        "run_id": "string",        "task_id": "string",        "timestamp": "2019-08-24T14:15:22Z"      }    ],    "runs": [      {        "attempt": 0,        "claim_token_hash": "string",        "claimed_at": "2019-08-24T14:15:22Z",        "claimed_by": {          "kind": "human",          "ref": "string"        },        "coordination_channel": {          "allowed_message_kinds": [            "status"          ],          "display_name": "string",          "id": "string",          "last_activity_at": "2019-08-24T14:15:22Z",          "purpose": "string",          "run_id": "string",          "task_id": "string",          "workflow_id": "string",          "workspace_id": "string"        },        "designation": {          "brief": "string",          "index": 0        },        "designation_group_id": "string",        "ended_at": "2019-08-24T14:15:22Z",        "error": "string",        "failure_kind": "string",        "heartbeat_at": "2019-08-24T14:15:22Z",        "id": "string",        "idempotency_key": "string",        "lease_until": "2019-08-24T14:15:22Z",        "metadata": null,        "origin": {          "kind": "cli",          "ref": "string"        },        "previous_run_id": "string",        "queued_at": "2019-08-24T14:15:22Z",        "recovery_count": 0,        "resolved_network_participation": {          "mode": "local",          "source": "explicit_request",          "version": "network-participation/v1"        },        "resolved_worktree_mode": "none",        "resolved_worktree_ref": "string",        "result": null,        "session_id": "string",        "started_at": "2019-08-24T14:15:22Z",        "status": "queued",        "task_id": "string",        "worktree_id": "string"      }    ],    "summary": {      "active_run": {        "attempt": 0,        "claim_token_hash": "string",        "claimed_at": "2019-08-24T14:15:22Z",        "claimed_by": {          "kind": "human",          "ref": "string"        },        "coordination_channel": {          "allowed_message_kinds": [            "status"          ],          "display_name": "string",          "id": "string",          "last_activity_at": "2019-08-24T14:15:22Z",          "purpose": "string",          "run_id": "string",          "task_id": "string",          "workflow_id": "string",          "workspace_id": "string"        },        "designation": {          "brief": "string",          "index": 0        },        "designation_group_id": "string",        "ended_at": "2019-08-24T14:15:22Z",        "error": "string",        "failure_kind": "string",        "heartbeat_at": "2019-08-24T14:15:22Z",        "id": "string",        "lease_until": "2019-08-24T14:15:22Z",        "max_attempts": 0,        "previous_run_id": "string",        "queued_at": "2019-08-24T14:15:22Z",        "recovery_count": 0,        "resolved_network_participation": {          "mode": "local",          "source": "explicit_request",          "version": "network-participation/v1"        },        "resolved_worktree_mode": "none",        "resolved_worktree_ref": "string",        "session_id": "string",        "started_at": "2019-08-24T14:15:22Z",        "status": "queued",        "task_id": "string",        "worktree_id": "string"      },      "approval_policy": "none",      "approval_state": "not_required",      "auto_enqueue_on_ready": true,      "blocked_reasons": [        {          "block_id": "string",          "depends_on_task_ids": [            "string"          ],          "kind": "needs_input",          "reason": "string",          "source": "dependency"        }      ],      "child_count": 0,      "closed_at": "2019-08-24T14:15:22Z",      "created_at": "2019-08-24T14:15:22Z",      "created_by": {        "kind": "human",        "ref": "string"      },      "current_run_id": "string",      "dependencies": [        {          "created_at": "2019-08-24T14:15:22Z",          "depends_on": {            "effective_paused": true,            "id": "string",            "identifier": "string",            "latest_event_seq": 0,            "owner": {              "kind": "human",              "ref": "string"            },            "paused": true,            "paused_by_task_id": "string",            "priority": "low",            "scope": "global",            "status": "draft",            "title": "string",            "workspace_id": "string"          },          "depends_on_task_id": "string",          "kind": "blocks",          "task_id": "string"        }      ],      "dependency_count": 0,      "draft": true,      "effective_paused": true,      "id": "string",      "identifier": "string",      "last_activity_at": "2019-08-24T14:15:22Z",      "latest_event_seq": 0,      "max_attempts": 0,      "needs_attention": true,      "needs_attention_at": "2019-08-24T14:15:22Z",      "needs_attention_by": {        "kind": "human",        "ref": "string"      },      "needs_attention_reason": "string",      "origin": {        "kind": "cli",        "ref": "string"      },      "owner": {        "kind": "human",        "ref": "string"      },      "parent_task_id": "string",      "paused": true,      "paused_at": "2019-08-24T14:15:22Z",      "paused_by": "string",      "paused_by_task_id": "string",      "paused_reason": "string",      "priority": "low",      "resolved_network_participation": {        "mode": "local",        "source": "explicit_request",        "version": "network-participation/v1"      },      "scope": "global",      "status": "draft",      "title": "string",      "updated_at": "2019-08-24T14:15:22Z",      "wake_creator": true,      "workspace_id": "string"    },    "task": {      "approval_policy": "none",      "approval_state": "not_required",      "auto_enqueue_on_ready": true,      "blocked_reasons": [        {          "block_id": "string",          "depends_on_task_ids": [            "string"          ],          "kind": "needs_input",          "reason": "string",          "source": "dependency"        }      ],      "closed_at": "2019-08-24T14:15:22Z",      "created_at": "2019-08-24T14:15:22Z",      "created_by": {        "kind": "human",        "ref": "string"      },      "current_run_id": "string",      "description": "string",      "draft": true,      "effective_paused": true,      "id": "string",      "identifier": "string",      "latest_event_seq": 0,      "max_attempts": 0,      "metadata": null,      "needs_attention": true,      "needs_attention_at": "2019-08-24T14:15:22Z",      "needs_attention_by": {        "kind": "human",        "ref": "string"      },      "needs_attention_reason": "string",      "origin": {        "kind": "cli",        "ref": "string"      },      "owner": {        "kind": "human",        "ref": "string"      },      "parent_task_id": "string",      "paused": true,      "paused_at": "2019-08-24T14:15:22Z",      "paused_by": "string",      "paused_by_task_id": "string",      "paused_reason": "string",      "priority": "low",      "resolved_network_participation": {        "mode": "local",        "source": "explicit_request",        "version": "network-participation/v1"      },      "scope": "global",      "status": "draft",      "title": "string",      "updated_at": "2019-08-24T14:15:22Z",      "wake_creator": true,      "workspace_id": "string"    }  }}

Update one task

PATCH/api/tasks/{id}

Path Parameters

id*string

Task id

Request Body

application/json

JSON request body

TypeScript Definitions

Use the request body type in TypeScript.

approval_policy?|

Value in

"none"
"manual"

auto_enqueue_on_ready?boolean|null

clear_owner?boolean

description?string|null

max_attempts?integer|null

metadata?unknown

network_participation?|||

owner?|null

priority?|

Value in

"low"
"medium"
"high"
"urgent"

title?string|null

Response Body

`application/json`

curl -X PATCH "https://example.com/api/tasks/string" \  -H "Content-Type: application/json" \  -d '{}'

{  "task": {    "approval_policy": "none",    "approval_state": "not_required",    "auto_enqueue_on_ready": true,    "blocked_reasons": [      {        "block_id": "string",        "depends_on_task_ids": [          "string"        ],        "kind": "needs_input",        "reason": "string",        "source": "dependency"      }    ],    "closed_at": "2019-08-24T14:15:22Z",    "created_at": "2019-08-24T14:15:22Z",    "created_by": {      "kind": "human",      "ref": "string"    },    "current_run_id": "string",    "description": "string",    "draft": true,    "effective_paused": true,    "id": "string",    "identifier": "string",    "latest_event_seq": 0,    "max_attempts": 0,    "metadata": null,    "needs_attention": true,    "needs_attention_at": "2019-08-24T14:15:22Z",    "needs_attention_by": {      "kind": "human",      "ref": "string"    },    "needs_attention_reason": "string",    "origin": {      "kind": "cli",      "ref": "string"    },    "owner": {      "kind": "human",      "ref": "string"    },    "parent_task_id": "string",    "paused": true,    "paused_at": "2019-08-24T14:15:22Z",    "paused_by": "string",    "paused_by_task_id": "string",    "paused_reason": "string",    "priority": "low",    "resolved_network_participation": {      "mode": "local",      "source": "explicit_request",      "version": "network-participation/v1"    },    "scope": "global",    "status": "draft",    "title": "string",    "updated_at": "2019-08-24T14:15:22Z",    "wake_creator": true,    "workspace_id": "string"  }}

Delete one task

DELETE/api/tasks/{id}

Path Parameters

id*string

Task id

Response Body

`application/json`

curl -X DELETE "https://example.com/api/tasks/string"

Empty

Approve one approval-gated task and enqueue executable work

POST/api/tasks/{id}/approve

Path Parameters

id*string

Task id

Request Body

application/json

JSON request body

TypeScript Definitions

Use the request body type in TypeScript.

idempotency_key?string

metadata?unknown

network_participation?|||

Response Body

`application/json`

curl -X POST "https://example.com/api/tasks/string/approve" \  -H "Content-Type: application/json" \  -d '{}'

{  "run": {    "attempt": 0,    "claim_token_hash": "string",    "claimed_at": "2019-08-24T14:15:22Z",    "claimed_by": {      "kind": "human",      "ref": "string"    },    "coordination_channel": {      "allowed_message_kinds": [        "status"      ],      "display_name": "string",      "id": "string",      "last_activity_at": "2019-08-24T14:15:22Z",      "purpose": "string",      "run_id": "string",      "task_id": "string",      "workflow_id": "string",      "workspace_id": "string"    },    "designation": {      "brief": "string",      "index": 0    },    "designation_group_id": "string",    "ended_at": "2019-08-24T14:15:22Z",    "error": "string",    "failure_kind": "string",    "heartbeat_at": "2019-08-24T14:15:22Z",    "id": "string",    "idempotency_key": "string",    "lease_until": "2019-08-24T14:15:22Z",    "metadata": null,    "origin": {      "kind": "cli",      "ref": "string"    },    "previous_run_id": "string",    "queued_at": "2019-08-24T14:15:22Z",    "recovery_count": 0,    "resolved_network_participation": {      "mode": "local",      "source": "explicit_request",      "version": "network-participation/v1"    },    "resolved_worktree_mode": "none",    "resolved_worktree_ref": "string",    "result": null,    "session_id": "string",    "started_at": "2019-08-24T14:15:22Z",    "status": "queued",    "task_id": "string",    "worktree_id": "string"  },  "task": {    "approval_policy": "none",    "approval_state": "not_required",    "auto_enqueue_on_ready": true,    "blocked_reasons": [      {        "block_id": "string",        "depends_on_task_ids": [          "string"        ],        "kind": "needs_input",        "reason": "string",        "source": "dependency"      }    ],    "closed_at": "2019-08-24T14:15:22Z",    "created_at": "2019-08-24T14:15:22Z",    "created_by": {      "kind": "human",      "ref": "string"    },    "current_run_id": "string",    "description": "string",    "draft": true,    "effective_paused": true,    "id": "string",    "identifier": "string",    "latest_event_seq": 0,    "max_attempts": 0,    "metadata": null,    "needs_attention": true,    "needs_attention_at": "2019-08-24T14:15:22Z",    "needs_attention_by": {      "kind": "human",      "ref": "string"    },    "needs_attention_reason": "string",    "origin": {      "kind": "cli",      "ref": "string"    },    "owner": {      "kind": "human",      "ref": "string"    },    "parent_task_id": "string",    "paused": true,    "paused_at": "2019-08-24T14:15:22Z",    "paused_by": "string",    "paused_by_task_id": "string",    "paused_reason": "string",    "priority": "low",    "resolved_network_participation": {      "mode": "local",      "source": "explicit_request",      "version": "network-participation/v1"    },    "scope": "global",    "status": "draft",    "title": "string",    "updated_at": "2019-08-24T14:15:22Z",    "wake_creator": true,    "workspace_id": "string"  }}

List typed task blocks

GET/api/tasks/{id}/blocks

Path Parameters

id*string

Task id

Query Parameters

include_cleared?boolean

Include cleared task blocks

Response Body

`application/json`

curl -X GET "https://example.com/api/tasks/string/blocks"

{  "blocks": [    {      "clear_note": "string",      "cleared_at": "2019-08-24T14:15:22Z",      "cleared_by": {        "kind": "human",        "ref": "string"      },      "created_at": "2019-08-24T14:15:22Z",      "created_by": {        "kind": "human",        "ref": "string"      },      "details": null,      "expires_at": "2019-08-24T14:15:22Z",      "id": "string",      "kind": "needs_input",      "reason": "string",      "task_id": "string",      "workspace_id": "string"    }  ]}

Create one typed task block

POST/api/tasks/{id}/blocks

Path Parameters

id*string

Task id

Request Body

application/json

JSON request body

TypeScript Definitions

Use the request body type in TypeScript.

details?unknown

expires_at?|

Formatdate-time

kind*string

Value in

"needs_input"
"capability"
"transient"

reason*string

run_id?string

Response Body

`application/json`

curl -X POST "https://example.com/api/tasks/string/blocks" \  -H "Content-Type: application/json" \  -d '{    "kind": "needs_input",    "reason": "string"  }'

{  "block": {    "clear_note": "string",    "cleared_at": "2019-08-24T14:15:22Z",    "cleared_by": {      "kind": "human",      "ref": "string"    },    "created_at": "2019-08-24T14:15:22Z",    "created_by": {      "kind": "human",      "ref": "string"    },    "details": null,    "expires_at": "2019-08-24T14:15:22Z",    "id": "string",    "kind": "needs_input",    "reason": "string",    "task_id": "string",    "workspace_id": "string"  }}

Clear one typed task block

POST/api/tasks/{id}/blocks/{block_id}/clear

Path Parameters

id*string

Task id

block_id*string

Task block id

Request Body

application/json

JSON request body

TypeScript Definitions

Use the request body type in TypeScript.

note?string

Response Body

`application/json`

curl -X POST "https://example.com/api/tasks/string/blocks/string/clear" \  -H "Content-Type: application/json" \  -d '{}'

{  "block": {    "clear_note": "string",    "cleared_at": "2019-08-24T14:15:22Z",    "cleared_by": {      "kind": "human",      "ref": "string"    },    "created_at": "2019-08-24T14:15:22Z",    "created_by": {      "kind": "human",      "ref": "string"    },    "details": null,    "expires_at": "2019-08-24T14:15:22Z",    "id": "string",    "kind": "needs_input",    "reason": "string",    "task_id": "string",    "workspace_id": "string"  }}

Cancel one task tree

POST/api/tasks/{id}/cancel

Path Parameters

id*string

Task id

Request Body

application/json

JSON request body

TypeScript Definitions

Use the request body type in TypeScript.

metadata?unknown

reason?string

Response Body

`application/json`

curl -X POST "https://example.com/api/tasks/string/cancel" \  -H "Content-Type: application/json" \  -d '{}'

{  "task": {    "approval_policy": "none",    "approval_state": "not_required",    "auto_enqueue_on_ready": true,    "blocked_reasons": [      {        "block_id": "string",        "depends_on_task_ids": [          "string"        ],        "kind": "needs_input",        "reason": "string",        "source": "dependency"      }    ],    "closed_at": "2019-08-24T14:15:22Z",    "created_at": "2019-08-24T14:15:22Z",    "created_by": {      "kind": "human",      "ref": "string"    },    "current_run_id": "string",    "description": "string",    "draft": true,    "effective_paused": true,    "id": "string",    "identifier": "string",    "latest_event_seq": 0,    "max_attempts": 0,    "metadata": null,    "needs_attention": true,    "needs_attention_at": "2019-08-24T14:15:22Z",    "needs_attention_by": {      "kind": "human",      "ref": "string"    },    "needs_attention_reason": "string",    "origin": {      "kind": "cli",      "ref": "string"    },    "owner": {      "kind": "human",      "ref": "string"    },    "parent_task_id": "string",    "paused": true,    "paused_at": "2019-08-24T14:15:22Z",    "paused_by": "string",    "paused_by_task_id": "string",    "paused_reason": "string",    "priority": "low",    "resolved_network_participation": {      "mode": "local",      "source": "explicit_request",      "version": "network-participation/v1"    },    "scope": "global",    "status": "draft",    "title": "string",    "updated_at": "2019-08-24T14:15:22Z",    "wake_creator": true,    "workspace_id": "string"  }}

Create one child task

POST/api/tasks/{id}/children

Path Parameters

id*string

Parent task id

Request Body

application/json

JSON request body

TypeScript Definitions

Use the request body type in TypeScript.

approval_policy?string

Value in

"none"
"manual"

auto_enqueue_on_ready?boolean

description?string

draft?boolean

id?string

identifier?string

max_attempts?integer|null

metadata?unknown

network_participation?|||

owner?|null

priority?string

Value in

"low"
"medium"
"high"
"urgent"

scope*string

Value in

"global"
"workspace"

title*string

wake_creator?boolean|null

workspace?string

Response Body

`application/json`

curl -X POST "https://example.com/api/tasks/string/children" \  -H "Content-Type: application/json" \  -d '{    "scope": "global",    "title": "string"  }'

{  "task": {    "approval_policy": "none",    "approval_state": "not_required",    "auto_enqueue_on_ready": true,    "blocked_reasons": [      {        "block_id": "string",        "depends_on_task_ids": [          "string"        ],        "kind": "needs_input",        "reason": "string",        "source": "dependency"      }    ],    "closed_at": "2019-08-24T14:15:22Z",    "created_at": "2019-08-24T14:15:22Z",    "created_by": {      "kind": "human",      "ref": "string"    },    "current_run_id": "string",    "description": "string",    "draft": true,    "effective_paused": true,    "id": "string",    "identifier": "string",    "latest_event_seq": 0,    "max_attempts": 0,    "metadata": null,    "needs_attention": true,    "needs_attention_at": "2019-08-24T14:15:22Z",    "needs_attention_by": {      "kind": "human",      "ref": "string"    },    "needs_attention_reason": "string",    "origin": {      "kind": "cli",      "ref": "string"    },    "owner": {      "kind": "human",      "ref": "string"    },    "parent_task_id": "string",    "paused": true,    "paused_at": "2019-08-24T14:15:22Z",    "paused_by": "string",    "paused_by_task_id": "string",    "paused_reason": "string",    "priority": "low",    "resolved_network_participation": {      "mode": "local",      "source": "explicit_request",      "version": "network-participation/v1"    },    "scope": "global",    "status": "draft",    "title": "string",    "updated_at": "2019-08-24T14:15:22Z",    "wake_creator": true,    "workspace_id": "string"  }}

Add one task dependency

POST/api/tasks/{id}/dependencies

Path Parameters

id*string

Task id

Request Body

application/json

JSON request body

TypeScript Definitions

Use the request body type in TypeScript.

depends_on_task_id*string

kind?"blocks"

Value in

"blocks"

Response Body

`application/json`

curl -X POST "https://example.com/api/tasks/string/dependencies" \  -H "Content-Type: application/json" \  -d '{    "depends_on_task_id": "string"  }'

{  "task": {    "children": [      {        "active_run": {          "attempt": 0,          "claim_token_hash": "string",          "claimed_at": "2019-08-24T14:15:22Z",          "claimed_by": {            "kind": "human",            "ref": "string"          },          "coordination_channel": {            "allowed_message_kinds": [              "status"            ],            "display_name": "string",            "id": "string",            "last_activity_at": "2019-08-24T14:15:22Z",            "purpose": "string",            "run_id": "string",            "task_id": "string",            "workflow_id": "string",            "workspace_id": "string"          },          "designation": {            "brief": "string",            "index": 0          },          "designation_group_id": "string",          "ended_at": "2019-08-24T14:15:22Z",          "error": "string",          "failure_kind": "string",          "heartbeat_at": "2019-08-24T14:15:22Z",          "id": "string",          "lease_until": "2019-08-24T14:15:22Z",          "max_attempts": 0,          "previous_run_id": "string",          "queued_at": "2019-08-24T14:15:22Z",          "recovery_count": 0,          "resolved_network_participation": {            "mode": "local",            "source": "explicit_request",            "version": "network-participation/v1"          },          "resolved_worktree_mode": "none",          "resolved_worktree_ref": "string",          "session_id": "string",          "started_at": "2019-08-24T14:15:22Z",          "status": "queued",          "task_id": "string",          "worktree_id": "string"        },        "approval_policy": "none",        "approval_state": "not_required",        "auto_enqueue_on_ready": true,        "blocked_reasons": [          {            "block_id": "string",            "depends_on_task_ids": [              "string"            ],            "kind": "needs_input",            "reason": "string",            "source": "dependency"          }        ],        "child_count": 0,        "closed_at": "2019-08-24T14:15:22Z",        "created_at": "2019-08-24T14:15:22Z",        "created_by": {          "kind": "human",          "ref": "string"        },        "current_run_id": "string",        "dependencies": [          {            "created_at": "2019-08-24T14:15:22Z",            "depends_on": {              "effective_paused": true,              "id": "string",              "identifier": "string",              "latest_event_seq": 0,              "owner": {                "kind": "human",                "ref": "string"              },              "paused": true,              "paused_by_task_id": "string",              "priority": "low",              "scope": "global",              "status": "draft",              "title": "string",              "workspace_id": "string"            },            "depends_on_task_id": "string",            "kind": "blocks",            "task_id": "string"          }        ],        "dependency_count": 0,        "draft": true,        "effective_paused": true,        "id": "string",        "identifier": "string",        "last_activity_at": "2019-08-24T14:15:22Z",        "latest_event_seq": 0,        "max_attempts": 0,        "needs_attention": true,        "needs_attention_at": "2019-08-24T14:15:22Z",        "needs_attention_by": {          "kind": "human",          "ref": "string"        },        "needs_attention_reason": "string",        "origin": {          "kind": "cli",          "ref": "string"        },        "owner": {          "kind": "human",          "ref": "string"        },        "parent_task_id": "string",        "paused": true,        "paused_at": "2019-08-24T14:15:22Z",        "paused_by": "string",        "paused_by_task_id": "string",        "paused_reason": "string",        "priority": "low",        "resolved_network_participation": {          "mode": "local",          "source": "explicit_request",          "version": "network-participation/v1"        },        "scope": "global",        "status": "draft",        "title": "string",        "updated_at": "2019-08-24T14:15:22Z",        "wake_creator": true,        "workspace_id": "string"      }    ],    "dependencies": [      {        "created_at": "2019-08-24T14:15:22Z",        "depends_on_task_id": "string",        "kind": "blocks",        "task_id": "string"      }    ],    "dependency_references": [      {        "created_at": "2019-08-24T14:15:22Z",        "depends_on": {          "effective_paused": true,          "id": "string",          "identifier": "string",          "latest_event_seq": 0,          "owner": {            "kind": "human",            "ref": "string"          },          "paused": true,          "paused_by_task_id": "string",          "priority": "low",          "scope": "global",          "status": "draft",          "title": "string",          "workspace_id": "string"        },        "depends_on_task_id": "string",        "kind": "blocks",        "task_id": "string"      }    ],    "designation_rollups": [      {        "created_at": "2019-08-24T14:15:22Z",        "designation_group_id": "string",        "summary": null,        "task_id": "string"      }    ],    "events": [      {        "actor": {          "kind": "human",          "ref": "string"        },        "event_type": "string",        "id": "string",        "origin": {          "kind": "cli",          "ref": "string"        },        "payload": null,        "run_id": "string",        "task_id": "string",        "timestamp": "2019-08-24T14:15:22Z"      }    ],    "runs": [      {        "attempt": 0,        "claim_token_hash": "string",        "claimed_at": "2019-08-24T14:15:22Z",        "claimed_by": {          "kind": "human",          "ref": "string"        },        "coordination_channel": {          "allowed_message_kinds": [            "status"          ],          "display_name": "string",          "id": "string",          "last_activity_at": "2019-08-24T14:15:22Z",          "purpose": "string",          "run_id": "string",          "task_id": "string",          "workflow_id": "string",          "workspace_id": "string"        },        "designation": {          "brief": "string",          "index": 0        },        "designation_group_id": "string",        "ended_at": "2019-08-24T14:15:22Z",        "error": "string",        "failure_kind": "string",        "heartbeat_at": "2019-08-24T14:15:22Z",        "id": "string",        "idempotency_key": "string",        "lease_until": "2019-08-24T14:15:22Z",        "metadata": null,        "origin": {          "kind": "cli",          "ref": "string"        },        "previous_run_id": "string",        "queued_at": "2019-08-24T14:15:22Z",        "recovery_count": 0,        "resolved_network_participation": {          "mode": "local",          "source": "explicit_request",          "version": "network-participation/v1"        },        "resolved_worktree_mode": "none",        "resolved_worktree_ref": "string",        "result": null,        "session_id": "string",        "started_at": "2019-08-24T14:15:22Z",        "status": "queued",        "task_id": "string",        "worktree_id": "string"      }    ],    "summary": {      "active_run": {        "attempt": 0,        "claim_token_hash": "string",        "claimed_at": "2019-08-24T14:15:22Z",        "claimed_by": {          "kind": "human",          "ref": "string"        },        "coordination_channel": {          "allowed_message_kinds": [            "status"          ],          "display_name": "string",          "id": "string",          "last_activity_at": "2019-08-24T14:15:22Z",          "purpose": "string",          "run_id": "string",          "task_id": "string",          "workflow_id": "string",          "workspace_id": "string"        },        "designation": {          "brief": "string",          "index": 0        },        "designation_group_id": "string",        "ended_at": "2019-08-24T14:15:22Z",        "error": "string",        "failure_kind": "string",        "heartbeat_at": "2019-08-24T14:15:22Z",        "id": "string",        "lease_until": "2019-08-24T14:15:22Z",        "max_attempts": 0,        "previous_run_id": "string",        "queued_at": "2019-08-24T14:15:22Z",        "recovery_count": 0,        "resolved_network_participation": {          "mode": "local",          "source": "explicit_request",          "version": "network-participation/v1"        },        "resolved_worktree_mode": "none",        "resolved_worktree_ref": "string",        "session_id": "string",        "started_at": "2019-08-24T14:15:22Z",        "status": "queued",        "task_id": "string",        "worktree_id": "string"      },      "approval_policy": "none",      "approval_state": "not_required",      "auto_enqueue_on_ready": true,      "blocked_reasons": [        {          "block_id": "string",          "depends_on_task_ids": [            "string"          ],          "kind": "needs_input",          "reason": "string",          "source": "dependency"        }      ],      "child_count": 0,      "closed_at": "2019-08-24T14:15:22Z",      "created_at": "2019-08-24T14:15:22Z",      "created_by": {        "kind": "human",        "ref": "string"      },      "current_run_id": "string",      "dependencies": [        {          "created_at": "2019-08-24T14:15:22Z",          "depends_on": {            "effective_paused": true,            "id": "string",            "identifier": "string",            "latest_event_seq": 0,            "owner": {              "kind": "human",              "ref": "string"            },            "paused": true,            "paused_by_task_id": "string",            "priority": "low",            "scope": "global",            "status": "draft",            "title": "string",            "workspace_id": "string"          },          "depends_on_task_id": "string",          "kind": "blocks",          "task_id": "string"        }      ],      "dependency_count": 0,      "draft": true,      "effective_paused": true,      "id": "string",      "identifier": "string",      "last_activity_at": "2019-08-24T14:15:22Z",      "latest_event_seq": 0,      "max_attempts": 0,      "needs_attention": true,      "needs_attention_at": "2019-08-24T14:15:22Z",      "needs_attention_by": {        "kind": "human",        "ref": "string"      },      "needs_attention_reason": "string",      "origin": {        "kind": "cli",        "ref": "string"      },      "owner": {        "kind": "human",        "ref": "string"      },      "parent_task_id": "string",      "paused": true,      "paused_at": "2019-08-24T14:15:22Z",      "paused_by": "string",      "paused_by_task_id": "string",      "paused_reason": "string",      "priority": "low",      "resolved_network_participation": {        "mode": "local",        "source": "explicit_request",        "version": "network-participation/v1"      },      "scope": "global",      "status": "draft",      "title": "string",      "updated_at": "2019-08-24T14:15:22Z",      "wake_creator": true,      "workspace_id": "string"    },    "task": {      "approval_policy": "none",      "approval_state": "not_required",      "auto_enqueue_on_ready": true,      "blocked_reasons": [        {          "block_id": "string",          "depends_on_task_ids": [            "string"          ],          "kind": "needs_input",          "reason": "string",          "source": "dependency"        }      ],      "closed_at": "2019-08-24T14:15:22Z",      "created_at": "2019-08-24T14:15:22Z",      "created_by": {        "kind": "human",        "ref": "string"      },      "current_run_id": "string",      "description": "string",      "draft": true,      "effective_paused": true,      "id": "string",      "identifier": "string",      "latest_event_seq": 0,      "max_attempts": 0,      "metadata": null,      "needs_attention": true,      "needs_attention_at": "2019-08-24T14:15:22Z",      "needs_attention_by": {        "kind": "human",        "ref": "string"      },      "needs_attention_reason": "string",      "origin": {        "kind": "cli",        "ref": "string"      },      "owner": {        "kind": "human",        "ref": "string"      },      "parent_task_id": "string",      "paused": true,      "paused_at": "2019-08-24T14:15:22Z",      "paused_by": "string",      "paused_by_task_id": "string",      "paused_reason": "string",      "priority": "low",      "resolved_network_participation": {        "mode": "local",        "source": "explicit_request",        "version": "network-participation/v1"      },      "scope": "global",      "status": "draft",      "title": "string",      "updated_at": "2019-08-24T14:15:22Z",      "wake_creator": true,      "workspace_id": "string"    }  }}

Remove one task dependency

DELETE/api/tasks/{id}/dependencies/{depends_on_id}

Path Parameters

id*string

Task id

depends_on_id*string

Dependency task id

Response Body

`application/json`

curl -X DELETE "https://example.com/api/tasks/string/dependencies/string"

{  "task": {    "children": [      {        "active_run": {          "attempt": 0,          "claim_token_hash": "string",          "claimed_at": "2019-08-24T14:15:22Z",          "claimed_by": {            "kind": "human",            "ref": "string"          },          "coordination_channel": {            "allowed_message_kinds": [              "status"            ],            "display_name": "string",            "id": "string",            "last_activity_at": "2019-08-24T14:15:22Z",            "purpose": "string",            "run_id": "string",            "task_id": "string",            "workflow_id": "string",            "workspace_id": "string"          },          "designation": {            "brief": "string",            "index": 0          },          "designation_group_id": "string",          "ended_at": "2019-08-24T14:15:22Z",          "error": "string",          "failure_kind": "string",          "heartbeat_at": "2019-08-24T14:15:22Z",          "id": "string",          "lease_until": "2019-08-24T14:15:22Z",          "max_attempts": 0,          "previous_run_id": "string",          "queued_at": "2019-08-24T14:15:22Z",          "recovery_count": 0,          "resolved_network_participation": {            "mode": "local",            "source": "explicit_request",            "version": "network-participation/v1"          },          "resolved_worktree_mode": "none",          "resolved_worktree_ref": "string",          "session_id": "string",          "started_at": "2019-08-24T14:15:22Z",          "status": "queued",          "task_id": "string",          "worktree_id": "string"        },        "approval_policy": "none",        "approval_state": "not_required",        "auto_enqueue_on_ready": true,        "blocked_reasons": [          {            "block_id": "string",            "depends_on_task_ids": [              "string"            ],            "kind": "needs_input",            "reason": "string",            "source": "dependency"          }        ],        "child_count": 0,        "closed_at": "2019-08-24T14:15:22Z",        "created_at": "2019-08-24T14:15:22Z",        "created_by": {          "kind": "human",          "ref": "string"        },        "current_run_id": "string",        "dependencies": [          {            "created_at": "2019-08-24T14:15:22Z",            "depends_on": {              "effective_paused": true,              "id": "string",              "identifier": "string",              "latest_event_seq": 0,              "owner": {                "kind": "human",                "ref": "string"              },              "paused": true,              "paused_by_task_id": "string",              "priority": "low",              "scope": "global",              "status": "draft",              "title": "string",              "workspace_id": "string"            },            "depends_on_task_id": "string",            "kind": "blocks",            "task_id": "string"          }        ],        "dependency_count": 0,        "draft": true,        "effective_paused": true,        "id": "string",        "identifier": "string",        "last_activity_at": "2019-08-24T14:15:22Z",        "latest_event_seq": 0,        "max_attempts": 0,        "needs_attention": true,        "needs_attention_at": "2019-08-24T14:15:22Z",        "needs_attention_by": {          "kind": "human",          "ref": "string"        },        "needs_attention_reason": "string",        "origin": {          "kind": "cli",          "ref": "string"        },        "owner": {          "kind": "human",          "ref": "string"        },        "parent_task_id": "string",        "paused": true,        "paused_at": "2019-08-24T14:15:22Z",        "paused_by": "string",        "paused_by_task_id": "string",        "paused_reason": "string",        "priority": "low",        "resolved_network_participation": {          "mode": "local",          "source": "explicit_request",          "version": "network-participation/v1"        },        "scope": "global",        "status": "draft",        "title": "string",        "updated_at": "2019-08-24T14:15:22Z",        "wake_creator": true,        "workspace_id": "string"      }    ],    "dependencies": [      {        "created_at": "2019-08-24T14:15:22Z",        "depends_on_task_id": "string",        "kind": "blocks",        "task_id": "string"      }    ],    "dependency_references": [      {        "created_at": "2019-08-24T14:15:22Z",        "depends_on": {          "effective_paused": true,          "id": "string",          "identifier": "string",          "latest_event_seq": 0,          "owner": {            "kind": "human",            "ref": "string"          },          "paused": true,          "paused_by_task_id": "string",          "priority": "low",          "scope": "global",          "status": "draft",          "title": "string",          "workspace_id": "string"        },        "depends_on_task_id": "string",        "kind": "blocks",        "task_id": "string"      }    ],    "designation_rollups": [      {        "created_at": "2019-08-24T14:15:22Z",        "designation_group_id": "string",        "summary": null,        "task_id": "string"      }    ],    "events": [      {        "actor": {          "kind": "human",          "ref": "string"        },        "event_type": "string",        "id": "string",        "origin": {          "kind": "cli",          "ref": "string"        },        "payload": null,        "run_id": "string",        "task_id": "string",        "timestamp": "2019-08-24T14:15:22Z"      }    ],    "runs": [      {        "attempt": 0,        "claim_token_hash": "string",        "claimed_at": "2019-08-24T14:15:22Z",        "claimed_by": {          "kind": "human",          "ref": "string"        },        "coordination_channel": {          "allowed_message_kinds": [            "status"          ],          "display_name": "string",          "id": "string",          "last_activity_at": "2019-08-24T14:15:22Z",          "purpose": "string",          "run_id": "string",          "task_id": "string",          "workflow_id": "string",          "workspace_id": "string"        },        "designation": {          "brief": "string",          "index": 0        },        "designation_group_id": "string",        "ended_at": "2019-08-24T14:15:22Z",        "error": "string",        "failure_kind": "string",        "heartbeat_at": "2019-08-24T14:15:22Z",        "id": "string",        "idempotency_key": "string",        "lease_until": "2019-08-24T14:15:22Z",        "metadata": null,        "origin": {          "kind": "cli",          "ref": "string"        },        "previous_run_id": "string",        "queued_at": "2019-08-24T14:15:22Z",        "recovery_count": 0,        "resolved_network_participation": {          "mode": "local",          "source": "explicit_request",          "version": "network-participation/v1"        },        "resolved_worktree_mode": "none",        "resolved_worktree_ref": "string",        "result": null,        "session_id": "string",        "started_at": "2019-08-24T14:15:22Z",        "status": "queued",        "task_id": "string",        "worktree_id": "string"      }    ],    "summary": {      "active_run": {        "attempt": 0,        "claim_token_hash": "string",        "claimed_at": "2019-08-24T14:15:22Z",        "claimed_by": {          "kind": "human",          "ref": "string"        },        "coordination_channel": {          "allowed_message_kinds": [            "status"          ],          "display_name": "string",          "id": "string",          "last_activity_at": "2019-08-24T14:15:22Z",          "purpose": "string",          "run_id": "string",          "task_id": "string",          "workflow_id": "string",          "workspace_id": "string"        },        "designation": {          "brief": "string",          "index": 0        },        "designation_group_id": "string",        "ended_at": "2019-08-24T14:15:22Z",        "error": "string",        "failure_kind": "string",        "heartbeat_at": "2019-08-24T14:15:22Z",        "id": "string",        "lease_until": "2019-08-24T14:15:22Z",        "max_attempts": 0,        "previous_run_id": "string",        "queued_at": "2019-08-24T14:15:22Z",        "recovery_count": 0,        "resolved_network_participation": {          "mode": "local",          "source": "explicit_request",          "version": "network-participation/v1"        },        "resolved_worktree_mode": "none",        "resolved_worktree_ref": "string",        "session_id": "string",        "started_at": "2019-08-24T14:15:22Z",        "status": "queued",        "task_id": "string",        "worktree_id": "string"      },      "approval_policy": "none",      "approval_state": "not_required",      "auto_enqueue_on_ready": true,      "blocked_reasons": [        {          "block_id": "string",          "depends_on_task_ids": [            "string"          ],          "kind": "needs_input",          "reason": "string",          "source": "dependency"        }      ],      "child_count": 0,      "closed_at": "2019-08-24T14:15:22Z",      "created_at": "2019-08-24T14:15:22Z",      "created_by": {        "kind": "human",        "ref": "string"      },      "current_run_id": "string",      "dependencies": [        {          "created_at": "2019-08-24T14:15:22Z",          "depends_on": {            "effective_paused": true,            "id": "string",            "identifier": "string",            "latest_event_seq": 0,            "owner": {              "kind": "human",              "ref": "string"            },            "paused": true,            "paused_by_task_id": "string",            "priority": "low",            "scope": "global",            "status": "draft",            "title": "string",            "workspace_id": "string"          },          "depends_on_task_id": "string",          "kind": "blocks",          "task_id": "string"        }      ],      "dependency_count": 0,      "draft": true,      "effective_paused": true,      "id": "string",      "identifier": "string",      "last_activity_at": "2019-08-24T14:15:22Z",      "latest_event_seq": 0,      "max_attempts": 0,      "needs_attention": true,      "needs_attention_at": "2019-08-24T14:15:22Z",      "needs_attention_by": {        "kind": "human",        "ref": "string"      },      "needs_attention_reason": "string",      "origin": {        "kind": "cli",        "ref": "string"      },      "owner": {        "kind": "human",        "ref": "string"      },      "parent_task_id": "string",      "paused": true,      "paused_at": "2019-08-24T14:15:22Z",      "paused_by": "string",      "paused_by_task_id": "string",      "paused_reason": "string",      "priority": "low",      "resolved_network_participation": {        "mode": "local",        "source": "explicit_request",        "version": "network-participation/v1"      },      "scope": "global",      "status": "draft",      "title": "string",      "updated_at": "2019-08-24T14:15:22Z",      "wake_creator": true,      "workspace_id": "string"    },    "task": {      "approval_policy": "none",      "approval_state": "not_required",      "auto_enqueue_on_ready": true,      "blocked_reasons": [        {          "block_id": "string",          "depends_on_task_ids": [            "string"          ],          "kind": "needs_input",          "reason": "string",          "source": "dependency"        }      ],      "closed_at": "2019-08-24T14:15:22Z",      "created_at": "2019-08-24T14:15:22Z",      "created_by": {        "kind": "human",        "ref": "string"      },      "current_run_id": "string",      "description": "string",      "draft": true,      "effective_paused": true,      "id": "string",      "identifier": "string",      "latest_event_seq": 0,      "max_attempts": 0,      "metadata": null,      "needs_attention": true,      "needs_attention_at": "2019-08-24T14:15:22Z",      "needs_attention_by": {        "kind": "human",        "ref": "string"      },      "needs_attention_reason": "string",      "origin": {        "kind": "cli",        "ref": "string"      },      "owner": {        "kind": "human",        "ref": "string"      },      "parent_task_id": "string",      "paused": true,      "paused_at": "2019-08-24T14:15:22Z",      "paused_by": "string",      "paused_by_task_id": "string",      "paused_reason": "string",      "priority": "low",      "resolved_network_participation": {        "mode": "local",        "source": "explicit_request",        "version": "network-participation/v1"      },      "scope": "global",      "status": "draft",      "title": "string",      "updated_at": "2019-08-24T14:15:22Z",      "wake_creator": true,      "workspace_id": "string"    }  }}

Get one task execution profile

GET/api/tasks/{id}/execution-profile

Path Parameters

id*string

Task id

Response Body

`application/json`

curl -X GET "https://example.com/api/tasks/string/execution-profile"

{  "profile": {    "coordinator": {      "agent_name": "string",      "guidance": "string",      "mode": "inherit",      "model": "string",      "provider": "string"    },    "created_at": "2019-08-24T14:15:22Z",    "network_participation": {      "mode": "local"    },    "participants": {      "allowed_agent_names": [        "string"      ],      "allowed_channel_ids": [        "string"      ],      "allowed_peer_ids": [        "string"      ],      "preferred_agent_names": [        "string"      ],      "preferred_capabilities": [        "string"      ],      "preferred_channel_ids": [        "string"      ],      "preferred_peer_ids": [        "string"      ],      "required_capabilities": [        "string"      ]    },    "review": {      "agent_name": "string",      "allowed_agent_names": [        "string"      ],      "allowed_channel_ids": [        "string"      ],      "allowed_peer_ids": [        "string"      ],      "model": "string",      "preferred_agent_names": [        "string"      ],      "preferred_capabilities": [        "string"      ],      "preferred_channel_ids": [        "string"      ],      "preferred_peer_ids": [        "string"      ],      "provider": "string",      "required_capabilities": [        "string"      ]    },    "runtime": {      "mode": "default"    },    "sandbox": {      "mode": "inherit",      "sandbox_ref": "string"    },    "task_id": "string",    "updated_at": "2019-08-24T14:15:22Z",    "worker": {      "agent_name": "string",      "allowed_agent_names": [        "string"      ],      "mode": "inherit",      "model": "string",      "preferred_agent_names": [        "string"      ],      "preferred_capabilities": [        "string"      ],      "provider": "string",      "required_capabilities": [        "string"      ]    },    "worktree": {      "mode": "inherit",      "worktree_ref": "string"    }  }}

Delete one task execution profile

DELETE/api/tasks/{id}/execution-profile

Path Parameters

id*string

Task id

Response Body

`application/json`

curl -X DELETE "https://example.com/api/tasks/string/execution-profile"

Empty

Replace one task execution profile

PUT/api/tasks/{id}/execution-profile

Path Parameters

id*string

Task id

Request Body

application/json

JSON request body

TypeScript Definitions

Use the request body type in TypeScript.

coordinator*

created_at*string

Formatdate-time

network_participation?|||

participants*

review*

runtime*

sandbox*

task_id*string

updated_at*string

Formatdate-time

worker*

worktree*

Response Body

`application/json`

curl -X PUT "https://example.com/api/tasks/string/execution-profile" \  -H "Content-Type: application/json" \  -d '{    "coordinator": {      "mode": "inherit"    },    "created_at": "2019-08-24T14:15:22Z",    "participants": {},    "review": {},    "runtime": {      "mode": "default"    },    "sandbox": {      "mode": "inherit"    },    "task_id": "string",    "updated_at": "2019-08-24T14:15:22Z",    "worker": {      "mode": "inherit"    },    "worktree": {      "mode": "inherit"    }  }'

{  "profile": {    "coordinator": {      "agent_name": "string",      "guidance": "string",      "mode": "inherit",      "model": "string",      "provider": "string"    },    "created_at": "2019-08-24T14:15:22Z",    "network_participation": {      "mode": "local"    },    "participants": {      "allowed_agent_names": [        "string"      ],      "allowed_channel_ids": [        "string"      ],      "allowed_peer_ids": [        "string"      ],      "preferred_agent_names": [        "string"      ],      "preferred_capabilities": [        "string"      ],      "preferred_channel_ids": [        "string"      ],      "preferred_peer_ids": [        "string"      ],      "required_capabilities": [        "string"      ]    },    "review": {      "agent_name": "string",      "allowed_agent_names": [        "string"      ],      "allowed_channel_ids": [        "string"      ],      "allowed_peer_ids": [        "string"      ],      "model": "string",      "preferred_agent_names": [        "string"      ],      "preferred_capabilities": [        "string"      ],      "preferred_channel_ids": [        "string"      ],      "preferred_peer_ids": [        "string"      ],      "provider": "string",      "required_capabilities": [        "string"      ]    },    "runtime": {      "mode": "default"    },    "sandbox": {      "mode": "inherit",      "sandbox_ref": "string"    },    "task_id": "string",    "updated_at": "2019-08-24T14:15:22Z",    "worker": {      "agent_name": "string",      "allowed_agent_names": [        "string"      ],      "mode": "inherit",      "model": "string",      "preferred_agent_names": [        "string"      ],      "preferred_capabilities": [        "string"      ],      "provider": "string",      "required_capabilities": [        "string"      ]    },    "worktree": {      "mode": "inherit",      "worktree_ref": "string"    }  }}

Set one task worktree policy

PATCH/api/tasks/{id}/execution-profile/worktree

Path Parameters

id*string

Task id

Request Body

application/json

JSON request body

TypeScript Definitions

Use the request body type in TypeScript.

mode*string

Value in

"inherit"
"none"
"ref"
"per_run"

worktree_ref?string

Response Body

`application/json`

curl -X PATCH "https://example.com/api/tasks/string/execution-profile/worktree" \  -H "Content-Type: application/json" \  -d '{    "mode": "inherit"  }'

{  "profile": {    "coordinator": {      "agent_name": "string",      "guidance": "string",      "mode": "inherit",      "model": "string",      "provider": "string"    },    "created_at": "2019-08-24T14:15:22Z",    "network_participation": {      "mode": "local"    },    "participants": {      "allowed_agent_names": [        "string"      ],      "allowed_channel_ids": [        "string"      ],      "allowed_peer_ids": [        "string"      ],      "preferred_agent_names": [        "string"      ],      "preferred_capabilities": [        "string"      ],      "preferred_channel_ids": [        "string"      ],      "preferred_peer_ids": [        "string"      ],      "required_capabilities": [        "string"      ]    },    "review": {      "agent_name": "string",      "allowed_agent_names": [        "string"      ],      "allowed_channel_ids": [        "string"      ],      "allowed_peer_ids": [        "string"      ],      "model": "string",      "preferred_agent_names": [        "string"      ],      "preferred_capabilities": [        "string"      ],      "preferred_channel_ids": [        "string"      ],      "preferred_peer_ids": [        "string"      ],      "provider": "string",      "required_capabilities": [        "string"      ]    },    "runtime": {      "mode": "default"    },    "sandbox": {      "mode": "inherit",      "sandbox_ref": "string"    },    "task_id": "string",    "updated_at": "2019-08-24T14:15:22Z",    "worker": {      "agent_name": "string",      "allowed_agent_names": [        "string"      ],      "mode": "inherit",      "model": "string",      "preferred_agent_names": [        "string"      ],      "preferred_capabilities": [        "string"      ],      "provider": "string",      "required_capabilities": [        "string"      ]    },    "worktree": {      "mode": "inherit",      "worktree_ref": "string"    }  }}

Inspect one task with diagnostics

GET/api/tasks/{id}/inspect

Path Parameters

id*string

Task id

Response Body

`application/json`

curl -X GET "https://example.com/api/tasks/string/inspect"

{  "inspect": {    "as_of": "2019-08-24T14:15:22Z",    "bound_session": {      "agent_name": "string",      "failure_kind": "string",      "last_activity_at": "2019-08-24T14:15:22Z",      "provider_name": "string",      "session_id": "string",      "started_at": "2019-08-24T14:15:22Z",      "state": "string",      "stop_reason": "string",      "workspace_id": "string"    },    "current_run": {      "attempt": 0,      "bound_session_id": "string",      "claim_token_hash_truncated": "string",      "ended_at": "2019-08-24T14:15:22Z",      "failure_kind": "string",      "heartbeat_age_seconds": 0,      "heartbeat_at": "2019-08-24T14:15:22Z",      "last_error_summary": "string",      "lease_until": "2019-08-24T14:15:22Z",      "previous_run_id": "string",      "queued_at": "2019-08-24T14:15:22Z",      "retries": 0,      "run_id": "string",      "started_at": "2019-08-24T14:15:22Z",      "status": "queued",      "task_id": "string"    },    "diagnostics": [      {        "category": "string",        "code": "string",        "data_freshness": "string",        "doc_url": "string",        "evidence": {          "property1": null,          "property2": null        },        "id": "string",        "message": "string",        "severity": "string",        "suggested_command": "string",        "title": "string"      }    ],    "next_action": "string",    "recent_events": [      {        "id": "string",        "outcome": "string",        "run_id": "string",        "session_id": "string",        "summary": "string",        "task_id": "string",        "timestamp": "2019-08-24T14:15:22Z",        "type": "string"      }    ],    "recent_runs": [      {        "attempt": 0,        "bound_session_id": "string",        "claim_token_hash_truncated": "string",        "ended_at": "2019-08-24T14:15:22Z",        "failure_kind": "string",        "heartbeat_age_seconds": 0,        "heartbeat_at": "2019-08-24T14:15:22Z",        "last_error_summary": "string",        "lease_until": "2019-08-24T14:15:22Z",        "previous_run_id": "string",        "queued_at": "2019-08-24T14:15:22Z",        "retries": 0,        "run_id": "string",        "started_at": "2019-08-24T14:15:22Z",        "status": "queued",        "task_id": "string"      }    ],    "scheduler": {      "paused": true,      "paused_at": "2019-08-24T14:15:22Z",      "paused_by": "string",      "reason": "string",      "updated_at": "2019-08-24T14:15:22Z"    },    "target": "string",    "task": {      "active_run": {        "attempt": 0,        "claim_token_hash": "string",        "claimed_at": "2019-08-24T14:15:22Z",        "claimed_by": {          "kind": "human",          "ref": "string"        },        "coordination_channel": {          "allowed_message_kinds": [            "status"          ],          "display_name": "string",          "id": "string",          "last_activity_at": "2019-08-24T14:15:22Z",          "purpose": "string",          "run_id": "string",          "task_id": "string",          "workflow_id": "string",          "workspace_id": "string"        },        "designation": {          "brief": "string",          "index": 0        },        "designation_group_id": "string",        "ended_at": "2019-08-24T14:15:22Z",        "error": "string",        "failure_kind": "string",        "heartbeat_at": "2019-08-24T14:15:22Z",        "id": "string",        "lease_until": "2019-08-24T14:15:22Z",        "max_attempts": 0,        "previous_run_id": "string",        "queued_at": "2019-08-24T14:15:22Z",        "recovery_count": 0,        "resolved_network_participation": {          "mode": "local",          "source": "explicit_request",          "version": "network-participation/v1"        },        "resolved_worktree_mode": "none",        "resolved_worktree_ref": "string",        "session_id": "string",        "started_at": "2019-08-24T14:15:22Z",        "status": "queued",        "task_id": "string",        "worktree_id": "string"      },      "approval_policy": "none",      "approval_state": "not_required",      "auto_enqueue_on_ready": true,      "blocked_reasons": [        {          "block_id": "string",          "depends_on_task_ids": [            "string"          ],          "kind": "needs_input",          "reason": "string",          "source": "dependency"        }      ],      "child_count": 0,      "closed_at": "2019-08-24T14:15:22Z",      "created_at": "2019-08-24T14:15:22Z",      "created_by": {        "kind": "human",        "ref": "string"      },      "current_run_id": "string",      "dependencies": [        {          "created_at": "2019-08-24T14:15:22Z",          "depends_on": {            "effective_paused": true,            "id": "string",            "identifier": "string",            "latest_event_seq": 0,            "owner": {              "kind": "human",              "ref": "string"            },            "paused": true,            "paused_by_task_id": "string",            "priority": "low",            "scope": "global",            "status": "draft",            "title": "string",            "workspace_id": "string"          },          "depends_on_task_id": "string",          "kind": "blocks",          "task_id": "string"        }      ],      "dependency_count": 0,      "draft": true,      "effective_paused": true,      "id": "string",      "identifier": "string",      "last_activity_at": "2019-08-24T14:15:22Z",      "latest_event_seq": 0,      "max_attempts": 0,      "needs_attention": true,      "needs_attention_at": "2019-08-24T14:15:22Z",      "needs_attention_by": {        "kind": "human",        "ref": "string"      },      "needs_attention_reason": "string",      "origin": {        "kind": "cli",        "ref": "string"      },      "owner": {        "kind": "human",        "ref": "string"      },      "parent_task_id": "string",      "paused": true,      "paused_at": "2019-08-24T14:15:22Z",      "paused_by": "string",      "paused_by_task_id": "string",      "paused_reason": "string",      "priority": "low",      "resolved_network_participation": {        "mode": "local",        "source": "explicit_request",        "version": "network-participation/v1"      },      "scope": "global",      "status": "draft",      "title": "string",      "updated_at": "2019-08-24T14:15:22Z",      "wake_creator": true,      "workspace_id": "string"    }  }}

List bridge terminal notification subscriptions for one task

GET/api/tasks/{id}/notifications/bridges

Path Parameters

id*string

Task id

Query Parameters

bridge_instance_id?string

Filter by bridge instance id

scope?string

Filter by bridge scope

Value in

"global"
"workspace"

workspace_id?string

Filter by workspace id

limit?integer

Maximum number of records to return

Formatint32

Response Body

`application/json`

curl -X GET "https://example.com/api/tasks/string/notifications/bridges"

{  "subscriptions": [    {      "bridge_instance_id": "string",      "created_at": "2019-08-24T14:15:22Z",      "created_by": {        "kind": "human",        "ref": "string"      },      "cursor": {        "consumer_id": "string",        "last_delivered_at": "2019-08-24T14:15:22Z",        "last_delivery_id": "string",        "last_error": "string",        "last_sequence": 0,        "scope": {          "kind": "global",          "workspace_id": "string"        },        "stream_name": "string",        "subject_id": "string",        "updated_at": "2019-08-24T14:15:22Z"      },      "delivery_mode": "direct-send",      "group_id": "string",      "peer_id": "string",      "scope": "global",      "subscription_id": "string",      "task_id": "string",      "thread_id": "string",      "updated_at": "2019-08-24T14:15:22Z",      "workspace_id": "string"    }  ]}

Create one bridge terminal notification subscription for a task

POST/api/tasks/{id}/notifications/bridges

Path Parameters

id*string

Task id

Request Body

application/json

JSON request body

TypeScript Definitions

Use the request body type in TypeScript.

bridge_instance_id*string

delivery_mode*string

Value in

"direct-send"
"reply"

group_id?string

peer_id?string

scope*string

Value in

"global"
"workspace"

subscription_id?string

thread_id?string

workspace_id?string

Response Body

`application/json`

curl -X POST "https://example.com/api/tasks/string/notifications/bridges" \  -H "Content-Type: application/json" \  -d '{    "bridge_instance_id": "string",    "delivery_mode": "direct-send",    "scope": "global"  }'

{  "subscription": {    "bridge_instance_id": "string",    "created_at": "2019-08-24T14:15:22Z",    "created_by": {      "kind": "human",      "ref": "string"    },    "cursor": {      "consumer_id": "string",      "last_delivered_at": "2019-08-24T14:15:22Z",      "last_delivery_id": "string",      "last_error": "string",      "last_sequence": 0,      "scope": {        "kind": "global",        "workspace_id": "string"      },      "stream_name": "string",      "subject_id": "string",      "updated_at": "2019-08-24T14:15:22Z"    },    "delivery_mode": "direct-send",    "group_id": "string",    "peer_id": "string",    "scope": "global",    "subscription_id": "string",    "task_id": "string",    "thread_id": "string",    "updated_at": "2019-08-24T14:15:22Z",    "workspace_id": "string"  }}

Get one bridge terminal notification subscription for a task

GET/api/tasks/{id}/notifications/bridges/{subscription_id}

Path Parameters

id*string

Task id

subscription_id*string

Bridge task subscription id

Response Body

`application/json`

curl -X GET "https://example.com/api/tasks/string/notifications/bridges/string"

{  "subscription": {    "bridge_instance_id": "string",    "created_at": "2019-08-24T14:15:22Z",    "created_by": {      "kind": "human",      "ref": "string"    },    "cursor": {      "consumer_id": "string",      "last_delivered_at": "2019-08-24T14:15:22Z",      "last_delivery_id": "string",      "last_error": "string",      "last_sequence": 0,      "scope": {        "kind": "global",        "workspace_id": "string"      },      "stream_name": "string",      "subject_id": "string",      "updated_at": "2019-08-24T14:15:22Z"    },    "delivery_mode": "direct-send",    "group_id": "string",    "peer_id": "string",    "scope": "global",    "subscription_id": "string",    "task_id": "string",    "thread_id": "string",    "updated_at": "2019-08-24T14:15:22Z",    "workspace_id": "string"  }}

Delete one bridge terminal notification subscription for a task

DELETE/api/tasks/{id}/notifications/bridges/{subscription_id}

Path Parameters

id*string

Task id

subscription_id*string

Bridge task subscription id

Response Body

`application/json`

curl -X DELETE "https://example.com/api/tasks/string/notifications/bridges/string"

Empty

Pause one task for future scheduler claims

POST/api/tasks/{id}/pause

Path Parameters

id*string

Task id

Request Body

application/json

JSON request body

TypeScript Definitions

Use the request body type in TypeScript.

metadata?unknown

reason*string

Response Body

`application/json`

curl -X POST "https://example.com/api/tasks/string/pause" \  -H "Content-Type: application/json" \  -d '{    "reason": "string"  }'

{  "task": {    "approval_policy": "none",    "approval_state": "not_required",    "auto_enqueue_on_ready": true,    "blocked_reasons": [      {        "block_id": "string",        "depends_on_task_ids": [          "string"        ],        "kind": "needs_input",        "reason": "string",        "source": "dependency"      }    ],    "closed_at": "2019-08-24T14:15:22Z",    "created_at": "2019-08-24T14:15:22Z",    "created_by": {      "kind": "human",      "ref": "string"    },    "current_run_id": "string",    "description": "string",    "draft": true,    "effective_paused": true,    "id": "string",    "identifier": "string",    "latest_event_seq": 0,    "max_attempts": 0,    "metadata": null,    "needs_attention": true,    "needs_attention_at": "2019-08-24T14:15:22Z",    "needs_attention_by": {      "kind": "human",      "ref": "string"    },    "needs_attention_reason": "string",    "origin": {      "kind": "cli",      "ref": "string"    },    "owner": {      "kind": "human",      "ref": "string"    },    "parent_task_id": "string",    "paused": true,    "paused_at": "2019-08-24T14:15:22Z",    "paused_by": "string",    "paused_by_task_id": "string",    "paused_reason": "string",    "priority": "low",    "resolved_network_participation": {      "mode": "local",      "source": "explicit_request",      "version": "network-participation/v1"    },    "scope": "global",    "status": "draft",    "title": "string",    "updated_at": "2019-08-24T14:15:22Z",    "wake_creator": true,    "workspace_id": "string"  }}

Publish one draft task and enqueue executable work

POST/api/tasks/{id}/publish

Path Parameters

id*string

Task id

Request Body

application/json

JSON request body

TypeScript Definitions

Use the request body type in TypeScript.

idempotency_key?string

metadata?unknown

network_participation?|||

Response Body

`application/json`

curl -X POST "https://example.com/api/tasks/string/publish" \  -H "Content-Type: application/json" \  -d '{}'

{  "run": {    "attempt": 0,    "claim_token_hash": "string",    "claimed_at": "2019-08-24T14:15:22Z",    "claimed_by": {      "kind": "human",      "ref": "string"    },    "coordination_channel": {      "allowed_message_kinds": [        "status"      ],      "display_name": "string",      "id": "string",      "last_activity_at": "2019-08-24T14:15:22Z",      "purpose": "string",      "run_id": "string",      "task_id": "string",      "workflow_id": "string",      "workspace_id": "string"    },    "designation": {      "brief": "string",      "index": 0    },    "designation_group_id": "string",    "ended_at": "2019-08-24T14:15:22Z",    "error": "string",    "failure_kind": "string",    "heartbeat_at": "2019-08-24T14:15:22Z",    "id": "string",    "idempotency_key": "string",    "lease_until": "2019-08-24T14:15:22Z",    "metadata": null,    "origin": {      "kind": "cli",      "ref": "string"    },    "previous_run_id": "string",    "queued_at": "2019-08-24T14:15:22Z",    "recovery_count": 0,    "resolved_network_participation": {      "mode": "local",      "source": "explicit_request",      "version": "network-participation/v1"    },    "resolved_worktree_mode": "none",    "resolved_worktree_ref": "string",    "result": null,    "session_id": "string",    "started_at": "2019-08-24T14:15:22Z",    "status": "queued",    "task_id": "string",    "worktree_id": "string"  },  "task": {    "approval_policy": "none",    "approval_state": "not_required",    "auto_enqueue_on_ready": true,    "blocked_reasons": [      {        "block_id": "string",        "depends_on_task_ids": [          "string"        ],        "kind": "needs_input",        "reason": "string",        "source": "dependency"      }    ],    "closed_at": "2019-08-24T14:15:22Z",    "created_at": "2019-08-24T14:15:22Z",    "created_by": {      "kind": "human",      "ref": "string"    },    "current_run_id": "string",    "description": "string",    "draft": true,    "effective_paused": true,    "id": "string",    "identifier": "string",    "latest_event_seq": 0,    "max_attempts": 0,    "metadata": null,    "needs_attention": true,    "needs_attention_at": "2019-08-24T14:15:22Z",    "needs_attention_by": {      "kind": "human",      "ref": "string"    },    "needs_attention_reason": "string",    "origin": {      "kind": "cli",      "ref": "string"    },    "owner": {      "kind": "human",      "ref": "string"    },    "parent_task_id": "string",    "paused": true,    "paused_at": "2019-08-24T14:15:22Z",    "paused_by": "string",    "paused_by_task_id": "string",    "paused_reason": "string",    "priority": "low",    "resolved_network_participation": {      "mode": "local",      "source": "explicit_request",      "version": "network-participation/v1"    },    "scope": "global",    "status": "draft",    "title": "string",    "updated_at": "2019-08-24T14:15:22Z",    "wake_creator": true,    "workspace_id": "string"  }}

Recover one task from needs_attention

POST/api/tasks/{id}/recover

Path Parameters

id*string

Task id

Request Body

application/json

JSON request body

TypeScript Definitions

Use the request body type in TypeScript.

note?string

Response Body

`application/json`

curl -X POST "https://example.com/api/tasks/string/recover" \  -H "Content-Type: application/json" \  -d '{}'

{  "task": {    "approval_policy": "none",    "approval_state": "not_required",    "auto_enqueue_on_ready": true,    "blocked_reasons": [      {        "block_id": "string",        "depends_on_task_ids": [          "string"        ],        "kind": "needs_input",        "reason": "string",        "source": "dependency"      }    ],    "closed_at": "2019-08-24T14:15:22Z",    "created_at": "2019-08-24T14:15:22Z",    "created_by": {      "kind": "human",      "ref": "string"    },    "current_run_id": "string",    "description": "string",    "draft": true,    "effective_paused": true,    "id": "string",    "identifier": "string",    "latest_event_seq": 0,    "max_attempts": 0,    "metadata": null,    "needs_attention": true,    "needs_attention_at": "2019-08-24T14:15:22Z",    "needs_attention_by": {      "kind": "human",      "ref": "string"    },    "needs_attention_reason": "string",    "origin": {      "kind": "cli",      "ref": "string"    },    "owner": {      "kind": "human",      "ref": "string"    },    "parent_task_id": "string",    "paused": true,    "paused_at": "2019-08-24T14:15:22Z",    "paused_by": "string",    "paused_by_task_id": "string",    "paused_reason": "string",    "priority": "low",    "resolved_network_participation": {      "mode": "local",      "source": "explicit_request",      "version": "network-participation/v1"    },    "scope": "global",    "status": "draft",    "title": "string",    "updated_at": "2019-08-24T14:15:22Z",    "wake_creator": true,    "workspace_id": "string"  }}

Reject one approval-gated task

POST/api/tasks/{id}/reject

Path Parameters

id*string

Task id

Response Body

`application/json`

curl -X POST "https://example.com/api/tasks/string/reject"

{  "task": {    "approval_policy": "none",    "approval_state": "not_required",    "auto_enqueue_on_ready": true,    "blocked_reasons": [      {        "block_id": "string",        "depends_on_task_ids": [          "string"        ],        "kind": "needs_input",        "reason": "string",        "source": "dependency"      }    ],    "closed_at": "2019-08-24T14:15:22Z",    "created_at": "2019-08-24T14:15:22Z",    "created_by": {      "kind": "human",      "ref": "string"    },    "current_run_id": "string",    "description": "string",    "draft": true,    "effective_paused": true,    "id": "string",    "identifier": "string",    "latest_event_seq": 0,    "max_attempts": 0,    "metadata": null,    "needs_attention": true,    "needs_attention_at": "2019-08-24T14:15:22Z",    "needs_attention_by": {      "kind": "human",      "ref": "string"    },    "needs_attention_reason": "string",    "origin": {      "kind": "cli",      "ref": "string"    },    "owner": {      "kind": "human",      "ref": "string"    },    "parent_task_id": "string",    "paused": true,    "paused_at": "2019-08-24T14:15:22Z",    "paused_by": "string",    "paused_by_task_id": "string",    "paused_reason": "string",    "priority": "low",    "resolved_network_participation": {      "mode": "local",      "source": "explicit_request",      "version": "network-participation/v1"    },    "scope": "global",    "status": "draft",    "title": "string",    "updated_at": "2019-08-24T14:15:22Z",    "wake_creator": true,    "workspace_id": "string"  }}

Resume one paused task for future scheduler claims

POST/api/tasks/{id}/resume

Path Parameters

id*string

Task id

Request Body

application/json

JSON request body

TypeScript Definitions

Use the request body type in TypeScript.

metadata?unknown

Response Body

`application/json`

curl -X POST "https://example.com/api/tasks/string/resume" \  -H "Content-Type: application/json" \  -d '{}'

{  "task": {    "approval_policy": "none",    "approval_state": "not_required",    "auto_enqueue_on_ready": true,    "blocked_reasons": [      {        "block_id": "string",        "depends_on_task_ids": [          "string"        ],        "kind": "needs_input",        "reason": "string",        "source": "dependency"      }    ],    "closed_at": "2019-08-24T14:15:22Z",    "created_at": "2019-08-24T14:15:22Z",    "created_by": {      "kind": "human",      "ref": "string"    },    "current_run_id": "string",    "description": "string",    "draft": true,    "effective_paused": true,    "id": "string",    "identifier": "string",    "latest_event_seq": 0,    "max_attempts": 0,    "metadata": null,    "needs_attention": true,    "needs_attention_at": "2019-08-24T14:15:22Z",    "needs_attention_by": {      "kind": "human",      "ref": "string"    },    "needs_attention_reason": "string",    "origin": {      "kind": "cli",      "ref": "string"    },    "owner": {      "kind": "human",      "ref": "string"    },    "parent_task_id": "string",    "paused": true,    "paused_at": "2019-08-24T14:15:22Z",    "paused_by": "string",    "paused_by_task_id": "string",    "paused_reason": "string",    "priority": "low",    "resolved_network_participation": {      "mode": "local",      "source": "explicit_request",      "version": "network-participation/v1"    },    "scope": "global",    "status": "draft",    "title": "string",    "updated_at": "2019-08-24T14:15:22Z",    "wake_creator": true,    "workspace_id": "string"  }}

List task-run reviews for one task

GET/api/tasks/{id}/reviews

Path Parameters

id*string

Task id

Query Parameters

status?string

Filter by review status

Value in

"requested"
"routed"
"in_review"
"recorded"
"circuit_opened"
"canceled"

reviewer_session_id?string

Filter by reviewer session id

limit?integer

Maximum number of records to return

Formatint32

Response Body

`application/json`

curl -X GET "https://example.com/api/tasks/string/reviews"

{  "reviews": [    {      "attempt": 0,      "confidence": 0,      "created_at": "2019-08-24T14:15:22Z",      "deadline_at": "2019-08-24T14:15:22Z",      "delivery_id": "string",      "missing_work": null,      "next_round_guidance": "string",      "outcome": "approved",      "parent_review_id": "string",      "policy": "none",      "reason": "string",      "requested_at": "2019-08-24T14:15:22Z",      "review_id": "string",      "review_round": 0,      "review_text": "string",      "reviewed_at": "2019-08-24T14:15:22Z",      "reviewed_by": {        "kind": "human",        "ref": "string"      },      "reviewer_agent_name": "string",      "reviewer_channel_id": "string",      "reviewer_peer_id": "string",      "reviewer_session_id": "string",      "routed_at": "2019-08-24T14:15:22Z",      "run_id": "string",      "started_at": "2019-08-24T14:15:22Z",      "status": "requested",      "task_id": "string",      "updated_at": "2019-08-24T14:15:22Z"    }  ]}

List runs for one task

GET/api/tasks/{id}/runs

Path Parameters

id*string

Task id

Query Parameters

status?string

Filter by run status

Value in

"queued"
"claimed"
"starting"
"running"
"completed"
"failed"
"canceled"
"needs_attention"

session_id?string

Filter by attached session id

participation_channel?string

Filter by resolved participation channel

limit?integer

Maximum number of records to return

Formatint32

Response Body

`application/json`

curl -X GET "https://example.com/api/tasks/string/runs"

{  "runs": [    {      "attempt": 0,      "claim_token_hash": "string",      "claimed_at": "2019-08-24T14:15:22Z",      "claimed_by": {        "kind": "human",        "ref": "string"      },      "coordination_channel": {        "allowed_message_kinds": [          "status"        ],        "display_name": "string",        "id": "string",        "last_activity_at": "2019-08-24T14:15:22Z",        "purpose": "string",        "run_id": "string",        "task_id": "string",        "workflow_id": "string",        "workspace_id": "string"      },      "designation": {        "brief": "string",        "index": 0      },      "designation_group_id": "string",      "ended_at": "2019-08-24T14:15:22Z",      "error": "string",      "failure_kind": "string",      "heartbeat_at": "2019-08-24T14:15:22Z",      "id": "string",      "idempotency_key": "string",      "lease_until": "2019-08-24T14:15:22Z",      "metadata": null,      "origin": {        "kind": "cli",        "ref": "string"      },      "previous_run_id": "string",      "queued_at": "2019-08-24T14:15:22Z",      "recovery_count": 0,      "resolved_network_participation": {        "mode": "local",        "source": "explicit_request",        "version": "network-participation/v1"      },      "resolved_worktree_mode": "none",      "resolved_worktree_ref": "string",      "result": null,      "session_id": "string",      "started_at": "2019-08-24T14:15:22Z",      "status": "queued",      "task_id": "string",      "worktree_id": "string"    }  ]}

Enqueue one task run

POST/api/tasks/{id}/runs

Path Parameters

id*string

Task id

Request Body

application/json

JSON request body

TypeScript Definitions

Use the request body type in TypeScript.

idempotency_key?string

metadata?unknown

network_participation?|||

Response Body

`application/json`

curl -X POST "https://example.com/api/tasks/string/runs" \  -H "Content-Type: application/json" \  -d '{}'

{  "run": {    "attempt": 0,    "claim_token_hash": "string",    "claimed_at": "2019-08-24T14:15:22Z",    "claimed_by": {      "kind": "human",      "ref": "string"    },    "coordination_channel": {      "allowed_message_kinds": [        "status"      ],      "display_name": "string",      "id": "string",      "last_activity_at": "2019-08-24T14:15:22Z",      "purpose": "string",      "run_id": "string",      "task_id": "string",      "workflow_id": "string",      "workspace_id": "string"    },    "designation": {      "brief": "string",      "index": 0    },    "designation_group_id": "string",    "ended_at": "2019-08-24T14:15:22Z",    "error": "string",    "failure_kind": "string",    "heartbeat_at": "2019-08-24T14:15:22Z",    "id": "string",    "idempotency_key": "string",    "lease_until": "2019-08-24T14:15:22Z",    "metadata": null,    "origin": {      "kind": "cli",      "ref": "string"    },    "previous_run_id": "string",    "queued_at": "2019-08-24T14:15:22Z",    "recovery_count": 0,    "resolved_network_participation": {      "mode": "local",      "source": "explicit_request",      "version": "network-participation/v1"    },    "resolved_worktree_mode": "none",    "resolved_worktree_ref": "string",    "result": null,    "session_id": "string",    "started_at": "2019-08-24T14:15:22Z",    "status": "queued",    "task_id": "string",    "worktree_id": "string"  }}

Enqueue designated sibling runs for one task

POST/api/tasks/{id}/runs/fan-out

Path Parameters

id*string

Task id

Request Body

application/json

JSON request body

TypeScript Definitions

Use the request body type in TypeScript.

designations*array<>

idempotency_key?string

network_participation?|||

worktree_per_run?boolean

Response Body

`application/json`

curl -X POST "https://example.com/api/tasks/string/runs/fan-out" \  -H "Content-Type: application/json" \  -d '{    "designations": [      {        "brief": "string"      }    ]  }'

{  "designation_group_id": "string",  "runs": [    {      "attempt": 0,      "claim_token_hash": "string",      "claimed_at": "2019-08-24T14:15:22Z",      "claimed_by": {        "kind": "human",        "ref": "string"      },      "coordination_channel": {        "allowed_message_kinds": [          "status"        ],        "display_name": "string",        "id": "string",        "last_activity_at": "2019-08-24T14:15:22Z",        "purpose": "string",        "run_id": "string",        "task_id": "string",        "workflow_id": "string",        "workspace_id": "string"      },      "designation": {        "brief": "string",        "index": 0      },      "designation_group_id": "string",      "ended_at": "2019-08-24T14:15:22Z",      "error": "string",      "failure_kind": "string",      "heartbeat_at": "2019-08-24T14:15:22Z",      "id": "string",      "idempotency_key": "string",      "lease_until": "2019-08-24T14:15:22Z",      "metadata": null,      "origin": {        "kind": "cli",        "ref": "string"      },      "previous_run_id": "string",      "queued_at": "2019-08-24T14:15:22Z",      "recovery_count": 0,      "resolved_network_participation": {        "mode": "local",        "source": "explicit_request",        "version": "network-participation/v1"      },      "resolved_worktree_mode": "none",      "resolved_worktree_ref": "string",      "result": null,      "session_id": "string",      "started_at": "2019-08-24T14:15:22Z",      "status": "queued",      "task_id": "string",      "worktree_id": "string"    }  ]}

Start one task by enqueueing executable work

POST/api/tasks/{id}/start

Path Parameters

id*string

Task id

Request Body

application/json

JSON request body

TypeScript Definitions

Use the request body type in TypeScript.

idempotency_key?string

metadata?unknown

network_participation?|||

Response Body

`application/json`

curl -X POST "https://example.com/api/tasks/string/start" \  -H "Content-Type: application/json" \  -d '{}'

{  "run": {    "attempt": 0,    "claim_token_hash": "string",    "claimed_at": "2019-08-24T14:15:22Z",    "claimed_by": {      "kind": "human",      "ref": "string"    },    "coordination_channel": {      "allowed_message_kinds": [        "status"      ],      "display_name": "string",      "id": "string",      "last_activity_at": "2019-08-24T14:15:22Z",      "purpose": "string",      "run_id": "string",      "task_id": "string",      "workflow_id": "string",      "workspace_id": "string"    },    "designation": {      "brief": "string",      "index": 0    },    "designation_group_id": "string",    "ended_at": "2019-08-24T14:15:22Z",    "error": "string",    "failure_kind": "string",    "heartbeat_at": "2019-08-24T14:15:22Z",    "id": "string",    "idempotency_key": "string",    "lease_until": "2019-08-24T14:15:22Z",    "metadata": null,    "origin": {      "kind": "cli",      "ref": "string"    },    "previous_run_id": "string",    "queued_at": "2019-08-24T14:15:22Z",    "recovery_count": 0,    "resolved_network_participation": {      "mode": "local",      "source": "explicit_request",      "version": "network-participation/v1"    },    "resolved_worktree_mode": "none",    "resolved_worktree_ref": "string",    "result": null,    "session_id": "string",    "started_at": "2019-08-24T14:15:22Z",    "status": "queued",    "task_id": "string",    "worktree_id": "string"  },  "task": {    "approval_policy": "none",    "approval_state": "not_required",    "auto_enqueue_on_ready": true,    "blocked_reasons": [      {        "block_id": "string",        "depends_on_task_ids": [          "string"        ],        "kind": "needs_input",        "reason": "string",        "source": "dependency"      }    ],    "closed_at": "2019-08-24T14:15:22Z",    "created_at": "2019-08-24T14:15:22Z",    "created_by": {      "kind": "human",      "ref": "string"    },    "current_run_id": "string",    "description": "string",    "draft": true,    "effective_paused": true,    "id": "string",    "identifier": "string",    "latest_event_seq": 0,    "max_attempts": 0,    "metadata": null,    "needs_attention": true,    "needs_attention_at": "2019-08-24T14:15:22Z",    "needs_attention_by": {      "kind": "human",      "ref": "string"    },    "needs_attention_reason": "string",    "origin": {      "kind": "cli",      "ref": "string"    },    "owner": {      "kind": "human",      "ref": "string"    },    "parent_task_id": "string",    "paused": true,    "paused_at": "2019-08-24T14:15:22Z",    "paused_by": "string",    "paused_by_task_id": "string",    "paused_reason": "string",    "priority": "low",    "resolved_network_participation": {      "mode": "local",      "source": "explicit_request",      "version": "network-participation/v1"    },    "scope": "global",    "status": "draft",    "title": "string",    "updated_at": "2019-08-24T14:15:22Z",    "wake_creator": true,    "workspace_id": "string"  }}

Stream task-native live events for one task

GET/api/tasks/{id}/stream

Path Parameters

id*string

Task id

Query Parameters

after_sequence?integer

Replay events after the supplied task stream sequence

Formatint64

Response Body

`text/event-stream`

`application/json`

curl -X GET "https://example.com/api/tasks/string/stream"

{  "sequence": 0,  "timeline": {    "actor": {      "kind": "human",      "ref": "string"    },    "event_id": "string",    "event_type": "string",    "origin": {      "kind": "cli",      "ref": "string"    },    "payload": null,    "run": {      "attempt": 0,      "claim_token_hash": "string",      "claimed_at": "2019-08-24T14:15:22Z",      "claimed_by": {        "kind": "human",        "ref": "string"      },      "coordination_channel": {        "allowed_message_kinds": [          "status"        ],        "display_name": "string",        "id": "string",        "last_activity_at": "2019-08-24T14:15:22Z",        "purpose": "string",        "run_id": "string",        "task_id": "string",        "workflow_id": "string",        "workspace_id": "string"      },      "designation": {        "brief": "string",        "index": 0      },      "designation_group_id": "string",      "ended_at": "2019-08-24T14:15:22Z",      "error": "string",      "failure_kind": "string",      "heartbeat_at": "2019-08-24T14:15:22Z",      "id": "string",      "lease_until": "2019-08-24T14:15:22Z",      "max_attempts": 0,      "previous_run_id": "string",      "queued_at": "2019-08-24T14:15:22Z",      "recovery_count": 0,      "resolved_network_participation": {        "mode": "local",        "source": "explicit_request",        "version": "network-participation/v1"      },      "resolved_worktree_mode": "none",      "resolved_worktree_ref": "string",      "session_id": "string",      "started_at": "2019-08-24T14:15:22Z",      "status": "queued",      "task_id": "string",      "worktree_id": "string"    },    "sequence": 0,    "task": {      "effective_paused": true,      "id": "string",      "identifier": "string",      "latest_event_seq": 0,      "owner": {        "kind": "human",        "ref": "string"      },      "paused": true,      "paused_by_task_id": "string",      "priority": "low",      "scope": "global",      "status": "draft",      "title": "string",      "workspace_id": "string"    },    "timestamp": "2019-08-24T14:15:22Z"  },  "type": "string"}

Get one task timeline

GET/api/tasks/{id}/timeline

Path Parameters

id*string

Task id

Query Parameters

after_sequence?integer

Return only events after the supplied sequence

Formatint64

limit?integer

Maximum number of timeline items to return

Formatint32

Response Body

`application/json`

curl -X GET "https://example.com/api/tasks/string/timeline"

{  "timeline": [    {      "actor": {        "kind": "human",        "ref": "string"      },      "event_id": "string",      "event_type": "string",      "origin": {        "kind": "cli",        "ref": "string"      },      "payload": null,      "run": {        "attempt": 0,        "claim_token_hash": "string",        "claimed_at": "2019-08-24T14:15:22Z",        "claimed_by": {          "kind": "human",          "ref": "string"        },        "coordination_channel": {          "allowed_message_kinds": [            "status"          ],          "display_name": "string",          "id": "string",          "last_activity_at": "2019-08-24T14:15:22Z",          "purpose": "string",          "run_id": "string",          "task_id": "string",          "workflow_id": "string",          "workspace_id": "string"        },        "designation": {          "brief": "string",          "index": 0        },        "designation_group_id": "string",        "ended_at": "2019-08-24T14:15:22Z",        "error": "string",        "failure_kind": "string",        "heartbeat_at": "2019-08-24T14:15:22Z",        "id": "string",        "lease_until": "2019-08-24T14:15:22Z",        "max_attempts": 0,        "previous_run_id": "string",        "queued_at": "2019-08-24T14:15:22Z",        "recovery_count": 0,        "resolved_network_participation": {          "mode": "local",          "source": "explicit_request",          "version": "network-participation/v1"        },        "resolved_worktree_mode": "none",        "resolved_worktree_ref": "string",        "session_id": "string",        "started_at": "2019-08-24T14:15:22Z",        "status": "queued",        "task_id": "string",        "worktree_id": "string"      },      "sequence": 0,      "task": {        "effective_paused": true,        "id": "string",        "identifier": "string",        "latest_event_seq": 0,        "owner": {          "kind": "human",          "ref": "string"        },        "paused": true,        "paused_by_task_id": "string",        "priority": "low",        "scope": "global",        "status": "draft",        "title": "string",        "workspace_id": "string"      },      "timestamp": "2019-08-24T14:15:22Z"    }  ]}

Get one task tree live view

GET/api/tasks/{id}/tree

Path Parameters

id*string

Task id

Response Body

`application/json`

curl -X GET "https://example.com/api/tasks/string/tree"

{  "tree": {    "descendants": [      {        "active_run": {          "attempt": 0,          "claim_token_hash": "string",          "claimed_at": "2019-08-24T14:15:22Z",          "claimed_by": {            "kind": "human",            "ref": "string"          },          "coordination_channel": {            "allowed_message_kinds": [              "status"            ],            "display_name": "string",            "id": "string",            "last_activity_at": "2019-08-24T14:15:22Z",            "purpose": "string",            "run_id": "string",            "task_id": "string",            "workflow_id": "string",            "workspace_id": "string"          },          "designation": {            "brief": "string",            "index": 0          },          "designation_group_id": "string",          "ended_at": "2019-08-24T14:15:22Z",          "error": "string",          "failure_kind": "string",          "heartbeat_at": "2019-08-24T14:15:22Z",          "id": "string",          "lease_until": "2019-08-24T14:15:22Z",          "max_attempts": 0,          "previous_run_id": "string",          "queued_at": "2019-08-24T14:15:22Z",          "recovery_count": 0,          "resolved_network_participation": {            "mode": "local",            "source": "explicit_request",            "version": "network-participation/v1"          },          "resolved_worktree_mode": "none",          "resolved_worktree_ref": "string",          "session_id": "string",          "started_at": "2019-08-24T14:15:22Z",          "status": "queued",          "task_id": "string",          "worktree_id": "string"        },        "child_count": 0,        "depth": 0,        "last_activity_at": "2019-08-24T14:15:22Z",        "parent_task_id": "string",        "task": {          "effective_paused": true,          "id": "string",          "identifier": "string",          "latest_event_seq": 0,          "owner": {            "kind": "human",            "ref": "string"          },          "paused": true,          "paused_by_task_id": "string",          "priority": "low",          "scope": "global",          "status": "draft",          "title": "string",          "workspace_id": "string"        }      }    ],    "root": {      "active_run": {        "attempt": 0,        "claim_token_hash": "string",        "claimed_at": "2019-08-24T14:15:22Z",        "claimed_by": {          "kind": "human",          "ref": "string"        },        "coordination_channel": {          "allowed_message_kinds": [            "status"          ],          "display_name": "string",          "id": "string",          "last_activity_at": "2019-08-24T14:15:22Z",          "purpose": "string",          "run_id": "string",          "task_id": "string",          "workflow_id": "string",          "workspace_id": "string"        },        "designation": {          "brief": "string",          "index": 0        },        "designation_group_id": "string",        "ended_at": "2019-08-24T14:15:22Z",        "error": "string",        "failure_kind": "string",        "heartbeat_at": "2019-08-24T14:15:22Z",        "id": "string",        "lease_until": "2019-08-24T14:15:22Z",        "max_attempts": 0,        "previous_run_id": "string",        "queued_at": "2019-08-24T14:15:22Z",        "recovery_count": 0,        "resolved_network_participation": {          "mode": "local",          "source": "explicit_request",          "version": "network-participation/v1"        },        "resolved_worktree_mode": "none",        "resolved_worktree_ref": "string",        "session_id": "string",        "started_at": "2019-08-24T14:15:22Z",        "status": "queued",        "task_id": "string",        "worktree_id": "string"      },      "child_count": 0,      "depth": 0,      "last_activity_at": "2019-08-24T14:15:22Z",      "parent_task_id": "string",      "task": {        "effective_paused": true,        "id": "string",        "identifier": "string",        "latest_event_seq": 0,        "owner": {          "kind": "human",          "ref": "string"        },        "paused": true,        "paused_by_task_id": "string",        "priority": "low",        "scope": "global",        "status": "draft",        "title": "string",        "workspace_id": "string"      }    }  }}

Archive one task inbox item

POST/api/tasks/{id}/triage/archive

Path Parameters

id*string

Task id

Response Body

`application/json`

curl -X POST "https://example.com/api/tasks/string/triage/archive"

{  "triage": {    "actor": {      "kind": "human",      "ref": "string"    },    "archived": true,    "dismissed": true,    "last_seen_activity_at": "2019-08-24T14:15:22Z",    "read": true,    "task_id": "string",    "updated_at": "2019-08-24T14:15:22Z"  }}

Dismiss one task inbox item

POST/api/tasks/{id}/triage/dismiss

Path Parameters

id*string

Task id

Response Body

`application/json`

curl -X POST "https://example.com/api/tasks/string/triage/dismiss"

{  "triage": {    "actor": {      "kind": "human",      "ref": "string"    },    "archived": true,    "dismissed": true,    "last_seen_activity_at": "2019-08-24T14:15:22Z",    "read": true,    "task_id": "string",    "updated_at": "2019-08-24T14:15:22Z"  }}

Mark one task inbox item as read

POST/api/tasks/{id}/triage/read

Path Parameters

id*string

Task id

Response Body

`application/json`

curl -X POST "https://example.com/api/tasks/string/triage/read"

{  "triage": {    "actor": {      "kind": "human",      "ref": "string"    },    "archived": true,    "dismissed": true,    "last_seen_activity_at": "2019-08-24T14:15:22Z",    "read": true,    "task_id": "string",    "updated_at": "2019-08-24T14:15:22Z"  }}

Promote one network thread message into a durable task

POST/api/workspaces/{workspace_id}/network/channels/{channel}/threads/{thread_id}/promote-task

Path Parameters

workspace_id*string

Workspace id

channel*string

Network channel

thread_id*string

Public thread id

Request Body

application/json

JSON request body

TypeScript Definitions

Use the request body type in TypeScript.

description?string

metadata?unknown

origin_message_id*string

priority?string

title?string

Response Body

`application/json`

curl -X POST "https://example.com/api/workspaces/string/network/channels/string/threads/string/promote-task" \  -H "Content-Type: application/json" \  -d '{    "origin_message_id": "string"  }'

{  "origin": {    "channel": "string",    "created_at": "2019-08-24T14:15:22Z",    "digest": "string",    "origin_message_id": "string",    "source_message_ids": [      "string"    ],    "task_id": "string",    "thread_id": "string",    "updated_at": "2019-08-24T14:15:22Z",    "workspace_id": "string"  },  "task": {    "approval_policy": "none",    "approval_state": "not_required",    "auto_enqueue_on_ready": true,    "blocked_reasons": [      {        "block_id": "string",        "depends_on_task_ids": [          "string"        ],        "kind": "needs_input",        "reason": "string",        "source": "dependency"      }    ],    "closed_at": "2019-08-24T14:15:22Z",    "created_at": "2019-08-24T14:15:22Z",    "created_by": {      "kind": "human",      "ref": "string"    },    "current_run_id": "string",    "description": "string",    "draft": true,    "effective_paused": true,    "id": "string",    "identifier": "string",    "latest_event_seq": 0,    "max_attempts": 0,    "metadata": null,    "needs_attention": true,    "needs_attention_at": "2019-08-24T14:15:22Z",    "needs_attention_by": {      "kind": "human",      "ref": "string"    },    "needs_attention_reason": "string",    "origin": {      "kind": "cli",      "ref": "string"    },    "owner": {      "kind": "human",      "ref": "string"    },    "parent_task_id": "string",    "paused": true,    "paused_at": "2019-08-24T14:15:22Z",    "paused_by": "string",    "paused_by_task_id": "string",    "paused_reason": "string",    "priority": "low",    "resolved_network_participation": {      "mode": "local",      "source": "explicit_request",      "version": "network-participation/v1"    },    "scope": "global",    "status": "draft",    "title": "string",    "updated_at": "2019-08-24T14:15:22Z",    "wake_creator": true,    "workspace_id": "string"  }}

200application/json

204

401application/json

403application/json

409application/json

422application/json

500application/json

503application/json

200application/json

401application/json

403application/json

404application/json

409application/json

422application/json

500application/json

503application/json

200application/json

401application/json

403application/json

404application/json

409application/json

422application/json

500application/json

503application/json

200application/json

401application/json

403application/json

404application/json

409application/json

422application/json

500application/json

503application/json

200application/json

401application/json

403application/json

404application/json

409application/json

422application/json

500application/json

503application/json

200application/json

401application/json

403application/json

404application/json

409application/json

422application/json

500application/json

503application/json

200application/json

404application/json

422application/json

500application/json

503application/json

200application/json

400application/json

404application/json

410application/json

500application/json

503application/json

200application/json

403application/json

422application/json

429application/json

500application/json

503application/json

200application/json

403application/json

422application/json

429application/json

500application/json

503application/json

200application/json

403application/json

404application/json

409application/json

422application/json

429application/json

500application/json

503application/json

200application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`