v68

OpenAPI 3.1.0raw.githubusercontent.com2026-08-07344691.3 MB
Tasks

List tasks with filters

Returns tasks with the full task text replaced by a bounded taskPreview and completion/integration blobs dropped by default — list views only need the preview. Pass fields=full to restore the full AgentTask. Fetch a single task in full via GET /api/tasks/{id}.

get/api/tasks

Query parameters

statusstring
agentIdstring
scheduleIdstring
keystring

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

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

keyPrefixstring

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

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

searchstring
includeHeartbeat'true' | 'false'
createdAfterstring date-time
createdBeforestring date-time
sourcestring
requestedByUserIdstring
orderBy'lastUpdatedAt' | 'createdAt'
limitinteger nullable
offsetinteger nullable
fields'full' | 'slim'

Response

Paginated task list

totalinteger required