curl -sS -X POST "https://gateway.orbit/api/v1/task-groups" \
--cacert /path/to/orbit-root-ca.pem \
-H 'Accept: application/json' \
-H 'X-Orbit-Request-Id: 9d6b1e5c-4a3f-4a1b-9f0e-6d2c3f5a7b81' \
-H 'Content-Type: application/json' \
-d '{"project_id": 4, "title": "Absorb Commander", "brief": "Persist groups. Accept when create and list work."}'{
"data": {
"id": 123,
"project_id": 123,
"project": "<string>",
"project_code": "<string>",
"taskable_type": "<string>",
"taskable_id": 123,
"title": "<string>",
"brief": "<string>",
"status": "backlog",
"reviewer_agent_thread_id": 123,
"pr_url": "<string>",
"watched_pr_url": "<string>",
"watched_pr_number": 123,
"watched_pr_state": "<string>",
"notify_coder": true,
"assistance_requested": true,
"assistance_kind": "direction",
"assistance_question": "<string>",
"assistance_reason": "<string>",
"implementer_model": "<string>",
"reviewer_model": "<string>",
"tokens": 123,
"line_diff": 123,
"lines_added": 123,
"lines_deleted": 123,
"duration_ms": 123,
"questions": 123,
"escalations": 123,
"tasks": [
{
"id": 123,
"task_group_id": 123,
"position": 123,
"title": "<string>",
"brief": "<string>",
"deliverables": [
{}
],
"topology": [
"<string>"
],
"status": "todo",
"implementer_agent_thread_id": 123,
"tokens": 123,
"line_diff": 123,
"lines_added": 123,
"lines_deleted": 123,
"duration_ms": 123,
"questions": 123,
"escalations": 123,
"type": "implementation",
"target_thread_id": "<string>",
"completion_summary": "<string>",
"check": {
"id": 123,
"kind": "baseline",
"status": "running",
"started_at": "<string>",
"finished_at": "<string>",
"exit_code": 123,
"changed_paths": [
"<string>"
],
"failed_step": "<string>",
"output": "<string>"
},
"assistance_requested": true,
"assistance_kind": "direction",
"assistance_question": "<string>",
"assistance_reason": "<string>",
"fixup_problem": "<string>"
}
],
"execution_mode": "managed",
"capacity_wait_reason": "<string>",
"vm_power": "running",
"preview": true,
"review_and_merge": {
"enabled": true,
"pr_branch": "<string>",
"merge_status": "waiting",
"merge_reason": "<string>",
"merged_sha": "<string>",
"reviewed_commits": [
{
"sha": "<string>",
"source": "orbit_push",
"review_task_id": 123,
"pushed_at": "<string>",
"github_review_id": 123,
"recorded_at": "<string>"
}
]
}
},
"meta": {
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}{
"data": {
"id": 123,
"project_id": 123,
"project": "<string>",
"project_code": "<string>",
"taskable_type": "<string>",
"taskable_id": 123,
"title": "<string>",
"brief": "<string>",
"status": "backlog",
"reviewer_agent_thread_id": 123,
"pr_url": "<string>",
"watched_pr_url": "<string>",
"watched_pr_number": 123,
"watched_pr_state": "<string>",
"notify_coder": true,
"assistance_requested": true,
"assistance_kind": "direction",
"assistance_question": "<string>",
"assistance_reason": "<string>",
"implementer_model": "<string>",
"reviewer_model": "<string>",
"tokens": 123,
"line_diff": 123,
"lines_added": 123,
"lines_deleted": 123,
"duration_ms": 123,
"questions": 123,
"escalations": 123,
"tasks": [
{
"id": 123,
"task_group_id": 123,
"position": 123,
"title": "<string>",
"brief": "<string>",
"deliverables": [
{}
],
"topology": [
"<string>"
],
"status": "todo",
"implementer_agent_thread_id": 123,
"tokens": 123,
"line_diff": 123,
"lines_added": 123,
"lines_deleted": 123,
"duration_ms": 123,
"questions": 123,
"escalations": 123,
"type": "implementation",
"target_thread_id": "<string>",
"completion_summary": "<string>",
"check": {
"id": 123,
"kind": "baseline",
"status": "running",
"started_at": "<string>",
"finished_at": "<string>",
"exit_code": 123,
"changed_paths": [
"<string>"
],
"failed_step": "<string>",
"output": "<string>"
},
"assistance_requested": true,
"assistance_kind": "direction",
"assistance_question": "<string>",
"assistance_reason": "<string>",
"fixup_problem": "<string>"
}
],
"execution_mode": "managed",
"capacity_wait_reason": "<string>",
"vm_power": "running",
"preview": true,
"review_and_merge": {
"enabled": true,
"pr_branch": "<string>",
"merge_status": "waiting",
"merge_reason": "<string>",
"merged_sha": "<string>",
"reviewed_commits": [
{
"sha": "<string>",
"source": "orbit_push",
"review_task_id": 123,
"pushed_at": "<string>",
"github_review_id": 123,
"recorded_at": "<string>"
}
]
}
},
"meta": {
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {},
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {},
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {},
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}Create a Task group
Creates a Task group for a Project with an optional ordered list of Task subtasks. Requires Gateway access. status is backlog (the default) or todo; the scheduler never claims a backlog group. A todo group needs at least one subtask (tasks.no_subtasks), each with at least one deliverable (tasks.subtask_deliverables_missing), and create then asks the scheduler to claim the oldest todo group that still fits the concurrency ceilings. Optional notify_coder or Commander notify_on_settle opts the group into the Coder settle webhook. Returns extension.disabled while the extension is off.
curl -sS -X POST "https://gateway.orbit/api/v1/task-groups" \
--cacert /path/to/orbit-root-ca.pem \
-H 'Accept: application/json' \
-H 'X-Orbit-Request-Id: 9d6b1e5c-4a3f-4a1b-9f0e-6d2c3f5a7b81' \
-H 'Content-Type: application/json' \
-d '{"project_id": 4, "title": "Absorb Commander", "brief": "Persist groups. Accept when create and list work."}'{
"data": {
"id": 123,
"project_id": 123,
"project": "<string>",
"project_code": "<string>",
"taskable_type": "<string>",
"taskable_id": 123,
"title": "<string>",
"brief": "<string>",
"status": "backlog",
"reviewer_agent_thread_id": 123,
"pr_url": "<string>",
"watched_pr_url": "<string>",
"watched_pr_number": 123,
"watched_pr_state": "<string>",
"notify_coder": true,
"assistance_requested": true,
"assistance_kind": "direction",
"assistance_question": "<string>",
"assistance_reason": "<string>",
"implementer_model": "<string>",
"reviewer_model": "<string>",
"tokens": 123,
"line_diff": 123,
"lines_added": 123,
"lines_deleted": 123,
"duration_ms": 123,
"questions": 123,
"escalations": 123,
"tasks": [
{
"id": 123,
"task_group_id": 123,
"position": 123,
"title": "<string>",
"brief": "<string>",
"deliverables": [
{}
],
"topology": [
"<string>"
],
"status": "todo",
"implementer_agent_thread_id": 123,
"tokens": 123,
"line_diff": 123,
"lines_added": 123,
"lines_deleted": 123,
"duration_ms": 123,
"questions": 123,
"escalations": 123,
"type": "implementation",
"target_thread_id": "<string>",
"completion_summary": "<string>",
"check": {
"id": 123,
"kind": "baseline",
"status": "running",
"started_at": "<string>",
"finished_at": "<string>",
"exit_code": 123,
"changed_paths": [
"<string>"
],
"failed_step": "<string>",
"output": "<string>"
},
"assistance_requested": true,
"assistance_kind": "direction",
"assistance_question": "<string>",
"assistance_reason": "<string>",
"fixup_problem": "<string>"
}
],
"execution_mode": "managed",
"capacity_wait_reason": "<string>",
"vm_power": "running",
"preview": true,
"review_and_merge": {
"enabled": true,
"pr_branch": "<string>",
"merge_status": "waiting",
"merge_reason": "<string>",
"merged_sha": "<string>",
"reviewed_commits": [
{
"sha": "<string>",
"source": "orbit_push",
"review_task_id": 123,
"pushed_at": "<string>",
"github_review_id": 123,
"recorded_at": "<string>"
}
]
}
},
"meta": {
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}{
"data": {
"id": 123,
"project_id": 123,
"project": "<string>",
"project_code": "<string>",
"taskable_type": "<string>",
"taskable_id": 123,
"title": "<string>",
"brief": "<string>",
"status": "backlog",
"reviewer_agent_thread_id": 123,
"pr_url": "<string>",
"watched_pr_url": "<string>",
"watched_pr_number": 123,
"watched_pr_state": "<string>",
"notify_coder": true,
"assistance_requested": true,
"assistance_kind": "direction",
"assistance_question": "<string>",
"assistance_reason": "<string>",
"implementer_model": "<string>",
"reviewer_model": "<string>",
"tokens": 123,
"line_diff": 123,
"lines_added": 123,
"lines_deleted": 123,
"duration_ms": 123,
"questions": 123,
"escalations": 123,
"tasks": [
{
"id": 123,
"task_group_id": 123,
"position": 123,
"title": "<string>",
"brief": "<string>",
"deliverables": [
{}
],
"topology": [
"<string>"
],
"status": "todo",
"implementer_agent_thread_id": 123,
"tokens": 123,
"line_diff": 123,
"lines_added": 123,
"lines_deleted": 123,
"duration_ms": 123,
"questions": 123,
"escalations": 123,
"type": "implementation",
"target_thread_id": "<string>",
"completion_summary": "<string>",
"check": {
"id": 123,
"kind": "baseline",
"status": "running",
"started_at": "<string>",
"finished_at": "<string>",
"exit_code": 123,
"changed_paths": [
"<string>"
],
"failed_step": "<string>",
"output": "<string>"
},
"assistance_requested": true,
"assistance_kind": "direction",
"assistance_question": "<string>",
"assistance_reason": "<string>",
"fixup_problem": "<string>"
}
],
"execution_mode": "managed",
"capacity_wait_reason": "<string>",
"vm_power": "running",
"preview": true,
"review_and_merge": {
"enabled": true,
"pr_branch": "<string>",
"merge_status": "waiting",
"merge_reason": "<string>",
"merged_sha": "<string>",
"reviewed_commits": [
{
"sha": "<string>",
"source": "orbit_push",
"review_task_id": 123,
"pushed_at": "<string>",
"github_review_id": 123,
"recorded_at": "<string>"
}
]
}
},
"meta": {
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {},
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {},
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {},
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}Body
x >= 1Short name of the feature
160Goal and acceptance
8000backlog (default) or todo
backlog, todo Keep the sandbox running during review
Post the Coder settle webhook when the group settles
50Show child attributes
Show child attributes