v68

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-07344691.3 MB
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'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'
providerMetaobject
harnessVariantstring
harnessVariantMetaobject
totalCostUsdnumber
isLeadTaskboolean required
supportedSteerModesstring[] required