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.

keyPrefixstring

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

Changes

Changed in 8 of the 104 revisions of this API.413

Sep 3, 20260f5503f5cd282See the full diff
- ○
  added subschema #1 subschema #2 to the response property anyOf list for the response status
  response-property-any-of-added
- ○
  removed subschema #1 subschema #2 from the response property anyOf list for the response status
  response-property-any-of-removed
Sep 2, 202609d5eb0300932See the full diff
- ○
  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
Aug 31, 20266f2d2fbe25992See the full diff
- ○
  added subschema #1 subschema #2 to the response property anyOf list for the response status
  response-property-any-of-added
- ○
  removed subschema #1 subschema #2 from the response property anyOf list for the response status
  response-property-any-of-removed
Aug 7, 202606cac6a7c5bc2See 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
Aug 3, 2026bd94290478fb1See the full diff
- ○
  added the new optional query request parameter requestedByUserId
  new-optional-request-parameter
Jul 11, 2026f1022d5edb0d2See the full diff
- ○
  added the new optional query request parameter key
  new-optional-request-parameter
- ○
  added the new optional query request parameter keyPrefix
  new-optional-request-parameter
Jul 9, 2026d12af41bc2552See the full diff
- ○
  added the new optional query request parameter createdBefore
  new-optional-request-parameter
- ○
  added the new optional query request parameter orderBy
  new-optional-request-parameter
Jul 2, 20260c910612f9ac4See the full diff
- ●
  deleted the query request parameter createdBefore
  request-parameter-removed
- ●
  deleted the query request parameter key
  request-parameter-removed
- ●
  deleted the query request parameter keyPrefix
  request-parameter-removed
- ●
  deleted the query request parameter orderBy
  request-parameter-removed

Full history