Tasks

Update provider session ID and harness metadata for a task

Changed on
put/api/tasks/{id}/session

Request

  • Base URL
    http://localhost:3013
  • URL
    http://localhost:3013/api/tasks/{id}/session
  • Auth
    HTTP bearer

Path parameters

idstring required

Request body

OR

Response

Session ID updated

idstring uuid required
keystring required

Non-unique asset directory namespace (for example shared/ or personal/<user-id>/drafts/). Runtime write boundaries normalize and validate the canonical form.

agentIdstring nullable required
creatorAgentIdstring
taskstring required
titlestring
status'draft' | 'backlog' | 'unassigned' | 'offered' | 'reviewing' | 'pending' | 'in_progress' | 'paused' | 'completed' | 'failed' | 'cancelled' | 'superseded' required
source'mcp' | 'slack' | 'api' | 'ui' | 'github' | 'gitlab' | 'azure-devops' | 'bitbucket' | 'agentmail' | 'system' | 'schedule' | 'workflow' | 'linear' | 'jira' | 'comb' | 'chat'
routingReason'skill' | 'continuity' | 'overflow' | 'human_pinned' | 'reroute_fault'
routingSource'declared' | 'engine_default'

Origin of the routing reason: declared by the caller or chosen by the engine. Absent for unknown historical provenance or no reason.

routingNotestring
poolWakeAtstring
taskTypestring
tagsstring[]
priorityinteger
dependsOnstring[]
offeredTostring
offeredAtstring date-time
acceptedAtstring date-time
rejectionReasonstring
createdAtstring date-time required
lastUpdatedAtstring date-time required
finishedAtstring date-time
notifiedAtstring date-time
failureReasonstring
outputstring
progressstring
slackChannelIdstring
slackThreadTsstring
slackTriggerMessageTsstring
slackUserIdstring
slackReplySentboolean
slackProgressMessageTsstring
slackTreeRootMessageTsstring
vcsProvider'github' | 'gitlab' | 'azure-devops' | 'bitbucket'
vcsRepostring
vcsEventTypestring
vcsNumberinteger
vcsCommentIdinteger
vcsAuthorstring
vcsUrlstring
vcsInstallationIdinteger
vcsNodeIdstring
agentmailInboxIdstring
agentmailMessageIdstring
agentmailThreadIdstring
mentionMessageIdstring
mentionChannelIdstring
dirstring
parentTaskIdstring
claudeSessionIdstring
modelstring
modelTier'smol' | 'regular' | 'smart' | 'ultra'
effort'off' | 'low' | 'medium' | 'high' | 'xhigh' | 'max'
resolvedModelstring
modelSourcestring
modelAliasstring
resolvedEffort'off' | 'low' | 'medium' | 'high' | 'xhigh' | 'max'
profilestring
resolvedProfilestring
scheduleIdstring
workflowRunIdstring uuid nullable
workflowRunStepIdstring uuid nullable
contextKeystring
outputSchemaobject
wasPausedboolean
deferredAtstring date-time
compactionCountinteger
peakContextPercentnumber
peakContextTokensinteger
contextWindowSizeinteger
credentialKeySuffixstring
credentialKeyTypestring
requestedByUserIdstring
swarmVersionstring
provider'claude' | 'codex' | 'pi' | 'devin' | 'claude-managed' | 'opencode' | 'acp' | 'dsh' | 'amp' | 'cursor' | 'grok' | 'fx'
providerMetaobject
harnessVariantstring
harnessVariantMetaobject
totalCostUsdnumber
routingAffinityInvalidboolean

Changes

    • warning

      added the new fx enum value to the response property for the response status

    • warning

      added the new fx enum value to the / response property for the response status

    • info

      added the new fx enum value to the request property /

    • warning

      added the new bitbucket enum value to the response property for the response status

    • warning

      added the new bitbucket enum value to the response property for the response status