Skip to main content
GET
List all of the caller's tasks across every agent.

Authorizations

Authorization
string
header
required

Pass a user JWT or a oag_ User API Key on the Authorization: Bearer <token> header. Both are validated by openapi-gateway against the Auth service.

Both credential types are user-scoped: every key (and every JWT) is bound to exactly one owner, and every route grants the caller full access to that owner's own resources. Cross-tenant access is denied by owner-ACL inside the handlers — there is no per-route scope vocabulary on this API.

Removed in v1.1.0: the legacy agents:* / tasks:* / files:* / instances:* scope set has been dropped together with the 403 insufficient_scope error. Existing oag_ keys automatically gain full owner-level access and do not need to be re-issued. SDK calls that previously passed scopes to createAPIKey should drop the argument. See the changelog at the bottom of this spec for the full migration note.

Query Parameters

agent_id
string

Narrow the result to a single agent. Equivalent to calling GET /agents/{agentId}/tasks directly; kept on this endpoint so callers can collapse their pagination logic across the "all agents" and "single agent" paths.

Maximum string length: 128
instance_id
string

Narrow the result to tasks running on a specific instance (across any agent on that instance). Combine with state=open to answer "is this instance currently running a task?" — a non-empty result means busy. Device control commands (computer / mobile) are NOT counted here.

Maximum string length: 128
state
enum<string>
default:active

Filter by channel state. active is the legacy wire alias for v2's open; all returns both. Default: active.

Available options:
active,
open,
closed,
all
since
string

Opaque pagination cursor from the previous page's next_since.

limit
integer<int32>
default:50
Required range: 1 <= x <= 100

Response

Paged list of tasks across all agents.

success
boolean
required
data
object
required