Skip to content

API reference

List tasks

GET/v1/tasks

Authorization

Send a personal API key or an OAuth access token as Authorization: Bearer <token>.

OAuth scopes: tasks:read

Parameters

  • status"idle" | "queued" | "running" | "awaiting_input" | "completed" | "cancelled" | "failed", query
  • projectIdstring (uuid), query
  • cursorstring, query

    Opaque cursor returned by the previous page

  • limitinteger, query

Responses

200Success
  • tasksobject[]required
  • idstringrequired
  • titlestringrequired
  • status"idle" | "queued" | "running" | "awaiting_input" | "completed" | "cancelled" | "failed"required
  • executionMode"adam" | "external"
  • projectIdstring | nullrequired
  • modelobject | nullrequired
  • slugstring | nullrequired
  • fastbooleanrequired
  • effort"low" | "medium" | "high" | "xhigh" | "max" | nullrequired
  • pendingInteractionobject | nullrequired
  • idstringrequired
  • type"question" | "approval"required
  • promptstring | nullrequired
  • createdAtstringrequired
  • updatedAtstringrequired
  • nextCursorstring | nullrequired
400Invalid request
  • errorobjectrequired
  • typestringrequired
  • messagestringrequired
  • requestIdstring
401Missing or invalid Bearer credential
  • errorobjectrequired
  • typestringrequired
  • messagestringrequired
  • requestIdstring
402Payment or subscription required
  • errorobjectrequired
  • typestringrequired
  • messagestringrequired
  • requestIdstring
403Credential is missing a required scope
  • errorobjectrequired
  • typestringrequired
  • messagestringrequired
  • requestIdstring
404Resource not found
  • errorobjectrequired
  • typestringrequired
  • messagestringrequired
  • requestIdstring
409Request conflict
  • errorobjectrequired
  • typestringrequired
  • messagestringrequired
  • requestIdstring
429Rate limit exceeded
  • errorobjectrequired
  • typestringrequired
  • messagestringrequired
  • requestIdstring
500Internal API error
  • errorobjectrequired
  • typestringrequired
  • messagestringrequired
  • requestIdstring