curl --request GET \
--url https://api.{environment}.corti.app/v2/agentic/agents/{agentId}/a2a/tasks \
--header 'Authorization: Bearer <token>' \
--header 'Tenant-Name: <api-key>'import { CortiClient, CortiEnvironment } from "@corti/sdk";
const client = new CortiClient({
environment: CortiEnvironment.Eu,
auth: {
clientId: "YOUR_CLIENT_ID",
clientSecret: "YOUR_CLIENT_SECRET"
},
tenantName: "YOUR_TENANT_NAME"
});
const pageableResponse = await client.agentic.agents.tasks.list("agt.0192f4c8-2c5a-7b3e-9f1a-3c8d6e2b7a40");
for await (const item of pageableResponse) {
console.log(item);
}
// Or you can manually iterate page-by-page
let page = await client.agentic.agents.tasks.list("agt.0192f4c8-2c5a-7b3e-9f1a-3c8d6e2b7a40");
while (page.hasNextPage()) {
page = page.getNextPage();
}
// You can also access the underlying response
const response = page.response;
using Corti.Agentic.Agents;
using Corti;
var client = new CortiClient(
"TENANT_NAME",
CortiClientEnvironment.Eu,
new CortiClientAuth.ClientCredentials("client_id", "client_secret")
);
var items = await client.Agentic.Agents.Tasks.ListAsync(
"agt.0192f4c8-2c5a-7b3e-9f1a-3c8d6e2b7a40",
new AgenticAgentsTasksListRequest { A2AVersion = "1.0" }
);
await foreach (var item in items)
{
// do something with item
}
import requests
url = "https://api.{environment}.corti.app/v2/agentic/agents/{agentId}/a2a/tasks"
headers = {
"Authorization": "Bearer <token>",
"Tenant-Name": "<api-key>"
}
response = requests.get(url, headers=headers)
print(response.text)<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.{environment}.corti.app/v2/agentic/agents/{agentId}/a2a/tasks",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Tenant-Name: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.{environment}.corti.app/v2/agentic/agents/{agentId}/a2a/tasks"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Tenant-Name", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.{environment}.corti.app/v2/agentic/agents/{agentId}/a2a/tasks")
.header("Authorization", "Bearer <token>")
.header("Tenant-Name", "<api-key>")
.asString();{
"tasks": [
{
"id": "task.0192f4c8-4e7c-7d50-b13c-5eaf8a4d9c62",
"contextId": "ctx.0192f4c8-3d6b-7c4f-a02b-4d9e7f3c8b51",
"status": {
"state": "TASK_STATE_COMPLETED"
}
}
]
}{
"error": {
"code": 404,
"status": "NOT_FOUND",
"message": "Task not found.",
"details": [
{
"@type": "type.googleapis.com/google.rpc.ErrorInfo",
"reason": "TASK_NOT_FOUND",
"domain": "a2a-protocol.org",
"metadata": {
"taskId": "task.0192f4c8-4e7c-7d50-b13c-5eaf8a4d9c62"
}
}
]
}
}List tasks (A2A REST)
curl --request GET \
--url https://api.{environment}.corti.app/v2/agentic/agents/{agentId}/a2a/tasks \
--header 'Authorization: Bearer <token>' \
--header 'Tenant-Name: <api-key>'import { CortiClient, CortiEnvironment } from "@corti/sdk";
const client = new CortiClient({
environment: CortiEnvironment.Eu,
auth: {
clientId: "YOUR_CLIENT_ID",
clientSecret: "YOUR_CLIENT_SECRET"
},
tenantName: "YOUR_TENANT_NAME"
});
const pageableResponse = await client.agentic.agents.tasks.list("agt.0192f4c8-2c5a-7b3e-9f1a-3c8d6e2b7a40");
for await (const item of pageableResponse) {
console.log(item);
}
// Or you can manually iterate page-by-page
let page = await client.agentic.agents.tasks.list("agt.0192f4c8-2c5a-7b3e-9f1a-3c8d6e2b7a40");
while (page.hasNextPage()) {
page = page.getNextPage();
}
// You can also access the underlying response
const response = page.response;
using Corti.Agentic.Agents;
using Corti;
var client = new CortiClient(
"TENANT_NAME",
CortiClientEnvironment.Eu,
new CortiClientAuth.ClientCredentials("client_id", "client_secret")
);
var items = await client.Agentic.Agents.Tasks.ListAsync(
"agt.0192f4c8-2c5a-7b3e-9f1a-3c8d6e2b7a40",
new AgenticAgentsTasksListRequest { A2AVersion = "1.0" }
);
await foreach (var item in items)
{
// do something with item
}
import requests
url = "https://api.{environment}.corti.app/v2/agentic/agents/{agentId}/a2a/tasks"
headers = {
"Authorization": "Bearer <token>",
"Tenant-Name": "<api-key>"
}
response = requests.get(url, headers=headers)
print(response.text)<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.{environment}.corti.app/v2/agentic/agents/{agentId}/a2a/tasks",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Tenant-Name: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.{environment}.corti.app/v2/agentic/agents/{agentId}/a2a/tasks"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Tenant-Name", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.{environment}.corti.app/v2/agentic/agents/{agentId}/a2a/tasks")
.header("Authorization", "Bearer <token>")
.header("Tenant-Name", "<api-key>")
.asString();{
"tasks": [
{
"id": "task.0192f4c8-4e7c-7d50-b13c-5eaf8a4d9c62",
"contextId": "ctx.0192f4c8-3d6b-7c4f-a02b-4d9e7f3c8b51",
"status": {
"state": "TASK_STATE_COMPLETED"
}
}
]
}{
"error": {
"code": 404,
"status": "NOT_FOUND",
"message": "Task not found.",
"details": [
{
"@type": "type.googleapis.com/google.rpc.ErrorInfo",
"reason": "TASK_NOT_FOUND",
"domain": "a2a-protocol.org",
"metadata": {
"taskId": "task.0192f4c8-4e7c-7d50-b13c-5eaf8a4d9c62"
}
}
]
}
}Authorizations
OAuth 2.0 / OIDC bearer token.
The tenant the request operates within.
Headers
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.
^\d+\.\d+$Path Parameters
Agent identifier (prefixed UUIDv7).
Agent identifier. Accepts agt.<uuidv7> or a bare UUIDv7 on input; always returned prefixed.
^(agt\.)?[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"agt.0192f4c8-2c5a-7b3e-9f1a-3c8d6e2b7a40"
Query Parameters
Maximum number of items per page.
1 <= x <= 200Opaque cursor from a prior response's nextPageToken. Omit on the first request.
Restrict to tasks within this context.
Response
A page of tasks.
A page of tasks.
Tasks on the current page.
Show child attributes
Show child attributes
[
{
"id": "task.0192f4c8-4e7c-7d50-b13c-5eaf8a4d9c62",
"contextId": "ctx.0192f4c8-3d6b-7c4f-a02b-4d9e7f3c8b51",
"status": { "state": "TASK_STATE_COMPLETED" }
}
]
The page size used for this response.
x >= 1Opaque cursor to request the next page, or null if there are no more pages.
Total number of items matching the query, when known. Not currently populated by the server; treat as absent.
42
Was this page helpful?