Sign in
Tasks

Get task details with logs and attachments

Returns the full AgentTask row decorated with logs (capped by logsLimit) and attachments (pointer-based artifacts stored on the task, ordered by created_at).

get/api/tasks/{id}

Path parameters

idstring required

Query parameters

logsLimitinteger

Response

Task with logs and attachments

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' | 'agentmail' | 'system' | 'schedule' | 'workflow' | 'linear' | 'jira'
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'
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'
scheduleIdstring
workflowRunIdstring uuid nullable
workflowRunStepIdstring uuid nullable
contextKeystring
outputSchemaobject
wasPausedboolean
compactionCountinteger
peakContextPercentnumber
peakContextTokensinteger
contextWindowSizeinteger
credentialKeySuffixstring
credentialKeyTypestring
requestedByUserIdstring
swarmVersionstring
provider'claude' | 'codex' | 'pi' | 'devin' | 'claude-managed' | 'opencode' | 'acp'
providerMetaobject
harnessVariantstring
harnessVariantMetaobject
totalCostUsdnumber
routingAffinityInvalidboolean
isLeadTaskboolean required
supportedSteerModesstring[] required

Changes

Changed in 4 of the 104 revisions of this API.54

  • 0f5503f5cd282See the full diff
    • ●

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

      response-property-enum-value-added

    • ●

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

      response-property-enum-value-added

  • 09d5eb03009322See the full diff
    • ●

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

      response-property-enum-value-added

    • ●

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

      response-property-enum-value-added

    • ○

      added the optional property ///// to the response with the status

      response-optional-property-added

    • ○

      added the optional property //// to the response with the status

      response-optional-property-added

  • 6f2d2fbe25991See the full diff
    • ●

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

      response-property-enum-value-added

  • 06cac6a7c5bc2See the full diff
    • ○

      added the media type application/json for the response with the status

      response-media-type-added

    • ○

      added the media type application/json for the response with the status

      response-media-type-added