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}

Request

  • Base URL: http://127.0.0.1:8052
  • URL: http://127.0.0.1:8052/tasks/next/{role}
  • Auth: none declared

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
artifact_specobject nullable

Changes

No recorded changes to this operation across all 1 revision of this API.