List all of the caller's tasks across every agent.

{ "success": true, "data": { "tasks": [ { "task_id": "<string>", "agent_id": "<string>", "caller_id": "<string>", "close_reason": "<string>", "metadata": {}, "created_at": "2023-11-07T05:31:56Z", "closed_at": "2023-11-07T05:31:56Z", "deadline_at": "2023-11-07T05:31:56Z" } ], "next_since": "<string>" } }

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

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

Show child attributes