post_api_tasks_id_rerun
const url = 'https://example.com/api/tasks/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/rerun';const options = { method: 'POST', headers: { cookie: 'supacloud_session=<supacloud_session>', 'Content-Type': 'application/json' }, body: '{"agent_profile_id":"2489E9AD-2EE2-8E00-8EC9-32D5F69181C0","agent_type":"example","attachments":["example"],"effort":"example","git_workflow":"example","link_issue_id":"example","link_issue_url":"example","mode":"example","model":"example","prompt":"example","provider":"example","subagents":"example","title":"example"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://example.com/api/tasks/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/rerun \ --header 'Content-Type: application/json' \ --cookie supacloud_session=<supacloud_session> \ --data '{ "agent_profile_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "agent_type": "example", "attachments": [ "example" ], "effort": "example", "git_workflow": "example", "link_issue_id": "example", "link_issue_url": "example", "mode": "example", "model": "example", "prompt": "example", "provider": "example", "subagents": "example", "title": "example" }'Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”Source task ID (a TERMINAL task)
Request Bodyrequired
Section titled “Request Bodyrequired”object
Optional agent-profile re-route. Some(Some(id)) sets it, Some(None)
clears it, an absent field preserves the current profile. Serde treats an
absent key as None and an explicit null as Some(None).
Axis 2 (mig 272) — the harness-native MODE (build|plan). A provided value is
merged onto config.mode for the restarted run (empty clears it); an absent field
preserves the existing mode. The FE Edit-&-restart panel sends this when changed.
Axis 1 (mig 272) — the decoupled subagent toggle (on|off). A provided value is
merged onto config.subagents (empty clears it); an absent field preserves it.
Examplegenerated
{ "agent_profile_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "agent_type": "example", "attachments": [ "example" ], "effort": "example", "git_workflow": "example", "link_issue_id": "example", "link_issue_url": "example", "mode": "example", "model": "example", "prompt": "example", "provider": "example", "subagents": "example", "title": "example"}Responses
Section titled “Responses”Forked a fresh task — returns its id
#708 R2 — the rerun response: the FRESH task id the fork launched (distinct from the
source, whose runs/events/outcome stay intact).
object
Examplegenerated
{ "task_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"}Structured client error
The canonical JSON body of every error response — the single source of truth
the frontend binds to. Every AppError serializes as this exact shape, and
the generated OpenAPI component ApiErrorBody (with its ErrorCode enum) is
what the frontend error schema is generated from, so there is no hand-written
error schema on either end.
object
Machine-readable, stable error code.
Present only on a quota-exceeded 403 — the inline upgrade-CTA payload.
object
The entitlement feature key that was hit, e.g. apps.max_count.
The plan’s limit for this key.
Where to send the user to upgrade.
Current usage (count or bytes, per the key).
Human-readable message (the server’s English text; the client may localize
by code).
Example
{ "code": "not_found"}Authentication required
The canonical JSON body of every error response — the single source of truth
the frontend binds to. Every AppError serializes as this exact shape, and
the generated OpenAPI component ApiErrorBody (with its ErrorCode enum) is
what the frontend error schema is generated from, so there is no hand-written
error schema on either end.
object
Machine-readable, stable error code.
Present only on a quota-exceeded 403 — the inline upgrade-CTA payload.
object
The entitlement feature key that was hit, e.g. apps.max_count.
The plan’s limit for this key.
Where to send the user to upgrade.
Current usage (count or bytes, per the key).
Human-readable message (the server’s English text; the client may localize
by code).
Example
{ "code": "not_found"}Permission denied
The canonical JSON body of every error response — the single source of truth
the frontend binds to. Every AppError serializes as this exact shape, and
the generated OpenAPI component ApiErrorBody (with its ErrorCode enum) is
what the frontend error schema is generated from, so there is no hand-written
error schema on either end.
object
Machine-readable, stable error code.
Present only on a quota-exceeded 403 — the inline upgrade-CTA payload.
object
The entitlement feature key that was hit, e.g. apps.max_count.
The plan’s limit for this key.
Where to send the user to upgrade.
Current usage (count or bytes, per the key).
Human-readable message (the server’s English text; the client may localize
by code).
Example
{ "code": "not_found"}Structured server error
The canonical JSON body of every error response — the single source of truth
the frontend binds to. Every AppError serializes as this exact shape, and
the generated OpenAPI component ApiErrorBody (with its ErrorCode enum) is
what the frontend error schema is generated from, so there is no hand-written
error schema on either end.
object
Machine-readable, stable error code.
Present only on a quota-exceeded 403 — the inline upgrade-CTA payload.
object
The entitlement feature key that was hit, e.g. apps.max_count.
The plan’s limit for this key.
Where to send the user to upgrade.
Current usage (count or bytes, per the key).
Human-readable message (the server’s English text; the client may localize
by code).
Example
{ "code": "not_found"}