Skip to main content
GET
List tasks (A2A REST)

Authorizations

Authorization
string
header
required

OAuth 2.0 / OIDC bearer token.

Tenant-Name
string
header
required

The tenant the request operates within.

Headers

A2A-Version
string
default:1.0

A2A protocol version in Major.Minor form (A2A §3.6). Optional; defaults to 1.0 when absent. This surface implements 1.0 only. Patch versions MUST NOT be sent and are not considered during negotiation.

Pattern: ^\d+\.\d+$

Path Parameters

agentId
string<agent-id>
required

Agent identifier (prefixed UUIDv7). Agent identifier. Accepts agt.<uuidv7> or a bare UUIDv7 on input; always returned prefixed.

Pattern: ^(agt\.)?[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
Example:

"agt.0192f4c8-2c5a-7b3e-9f1a-3c8d6e2b7a40"

Query Parameters

pageSize
integer
default:50

Maximum number of items per page.

Required range: 1 <= x <= 200
pageToken
string

Opaque cursor from a prior response's nextPageToken. Omit on the first request.

contextId
string

Restrict to tasks within this context.

Response

A page of tasks.

A page of tasks.

tasks
object[]
required

Tasks on the current page.

Example:
pageSize
integer

The page size used for this response.

Required range: x >= 1
nextPageToken
string | null

Opaque cursor to request the next page, or null if there are no more pages.

totalSize
integer

Total number of items matching the query, when known. Not currently populated by the server; treat as absent.

Example:

42