v6

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

Next Task

Claim the next available task for role.

Pass claimed_by_session as a query param to record which parent orchestrator session owns the claim.

Pass parent_session_id to restrict claiming to tasks that were created under that coordinator session. Workers belonging to a coordinator should always pass their coordinator's session ID here to avoid stealing tasks from other namespaces.

get/tasks/next/{role}

Path parameters

rolestring required

Query parameters

claimed_by_sessionstring nullable

parent_session_idstring nullable

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