Sign in

v6

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-01485121699.8 KB

Release Task

Release a claimed task back to the open pool without failing it.

A cluster worker that claims a task but cannot start its agent (e.g. the workspace is not a usable git checkout, or the adapter spawn fails) must return the task to the pool so another node can pick it up, rather than stranding it in claimed with no live agent (#3018). Distinct from /fail (terminal FAILED) and /reopen (DONE -> OPEN): the task transitions CLAIMED/IN_PROGRESS -> OPEN and is immediately claimable again.

post/tasks/{task_id}/release

Path parameters

task_idstring required

Request body

reasonstring

Response

Successful Response

idstring required
titlestring required
descriptionstring required
rolestring required
tenant_idstring required
priorityinteger required
scopestring required
complexitystring required
eu_ai_act_riskstring required
approval_requiredboolean required
risk_levelstring required
estimated_minutesinteger nullable required
statusstring required
depends_onstring[] required
parent_task_idstring nullable required
depends_on_repostring nullable required
owned_filesstring[] required
assigned_agentstring nullable required
result_summarystring nullable required
cell_idstring nullable required
repostring nullable required
task_typestring required
upgrade_detailsobject nullable required
modelstring nullable required
effortstring nullable required
clistring nullable
batch_eligibleboolean
completion_signalsobject[]
slack_contextobject nullable
metadataobject
created_atnumber required
claimed_atnumber nullable
completed_atnumber nullable
closed_atnumber nullable
deadlinenumber nullable
versioninteger
parent_session_idstring nullable
retry_countinteger
max_retriesinteger
retry_delay_snumber
terminal_reasonstring nullable
max_output_tokensinteger nullable
meta_messagesstring[]
max_turnsinteger nullable