Get a task (A2A REST)

cURL

curl --request GET \
  --url https://api.{environment}.corti.app/v2/agentic/agents/{agentId}/a2a/tasks/{taskId} \
  --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"
});
await client.agentic.agents.tasks.get("agt.0192f4c8-2c5a-7b3e-9f1a-3c8d6e2b7a40", "task.0192f4c8-4e7c-7d50-b13c-5eaf8a4d9c62");

using Corti.Agentic.Agents;
using Corti;

var client = new CortiClient(
    "TENANT_NAME",
    CortiClientEnvironment.Eu,
    new CortiClientAuth.ClientCredentials("client_id", "client_secret")
);
await client.Agentic.Agents.Tasks.GetAsync(
    "agt.0192f4c8-2c5a-7b3e-9f1a-3c8d6e2b7a40",
    "task.0192f4c8-4e7c-7d50-b13c-5eaf8a4d9c62",
    new AgenticAgentsTasksGetRequest { A2AVersion = "1.0" }
);

import requests

url = "https://api.{environment}.corti.app/v2/agentic/agents/{agentId}/a2a/tasks/{taskId}"

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/{taskId}",
  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/{taskId}"

	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/{taskId}")
  .header("Authorization", "Bearer <token>")
  .header("Tenant-Name", "<api-key>")
  .asString();

{
  "id": "task.0192f4c8-4e7c-7d50-b13c-5eaf8a4d9c62",
  "contextId": "ctx.0192f4c8-3d6b-7c4f-a02b-4d9e7f3c8b51",
  "status": {
    "state": "TASK_STATE_COMPLETED",
    "timestamp": "2026-05-19T12:00:01Z"
  }
}

{
  "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"
        }
      }
    ]
  }
}

{
  "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"
        }
      }
    ]
  }
}

GET

agentic

agents

{agentId}

a2a

tasks

{taskId}

cURL

curl --request GET \
  --url https://api.{environment}.corti.app/v2/agentic/agents/{agentId}/a2a/tasks/{taskId} \
  --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"
});
await client.agentic.agents.tasks.get("agt.0192f4c8-2c5a-7b3e-9f1a-3c8d6e2b7a40", "task.0192f4c8-4e7c-7d50-b13c-5eaf8a4d9c62");

using Corti.Agentic.Agents;
using Corti;

var client = new CortiClient(
    "TENANT_NAME",
    CortiClientEnvironment.Eu,
    new CortiClientAuth.ClientCredentials("client_id", "client_secret")
);
await client.Agentic.Agents.Tasks.GetAsync(
    "agt.0192f4c8-2c5a-7b3e-9f1a-3c8d6e2b7a40",
    "task.0192f4c8-4e7c-7d50-b13c-5eaf8a4d9c62",
    new AgenticAgentsTasksGetRequest { A2AVersion = "1.0" }
);

import requests

url = "https://api.{environment}.corti.app/v2/agentic/agents/{agentId}/a2a/tasks/{taskId}"

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/{taskId}",
  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/{taskId}"

	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/{taskId}")
  .header("Authorization", "Bearer <token>")
  .header("Tenant-Name", "<api-key>")
  .asString();

{
  "id": "task.0192f4c8-4e7c-7d50-b13c-5eaf8a4d9c62",
  "contextId": "ctx.0192f4c8-3d6b-7c4f-a02b-4d9e7f3c8b51",
  "status": {
    "state": "TASK_STATE_COMPLETED",
    "timestamp": "2026-05-19T12:00:01Z"
  }
}

{
  "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"
        }
      }
    ]
  }
}

{
  "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

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"

taskId

string<task-id>

required

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

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

Example:

"task.0192f4c8-4e7c-7d50-b13c-5eaf8a4d9c62"

Query Parameters

historyLength

integer

Cap the number of history messages returned.

Required range: x >= 0

Response

The task.

An A2A task — a unit of agent work with status, history, and artifacts.

string<task-id>

required

Task identifier. Accepts task.<uuidv7> or a bare UUIDv7 on input; always returned prefixed.

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

Example:

"task.0192f4c8-4e7c-7d50-b13c-5eaf8a4d9c62"

contextId

string<context-id>

required

Context identifier. Accepts ctx.<uuidv7> or a bare UUIDv7 on input; always returned prefixed.

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

Example:

"ctx.0192f4c8-3d6b-7c4f-a02b-4d9e7f3c8b51"

status

object

required

A task's current state, with an optional status message and timestamp.

Show child attributes

Example:

{
  "state": "TASK_STATE_COMPLETED",
  "timestamp": "2026-05-19T12:00:00Z"
}

history

object[]

Messages exchanged during the task, oldest first.

Show child attributes

Example:

[
  {
    "messageId": "msg.0192f4c8-5f8d-7e61-924d-6fb09b5ead73",
    "role": "ROLE_AGENT",
    "parts": [{ "text": "J45.909" }]
  }
]

artifacts

object[]

Artifacts produced by the task.

Show child attributes

Example:

[
  {
    "artifactId": "art.0192f4c8-6a9e-7f72-a35e-70c1ac6fbe84",
    "name": "icd10-result",
    "parts": [{ "text": "J45.909" }]
  }
]

metadata

object

Task metadata, including $usage token/credit accounting. Not yet exposed through the REST binding (deferred); only the JSON-RPC binding populates this field.

Show child attributes

Example:

{
  "$usage": {
    "model": "corti-default",
    "inputTokens": 100,
    "outputTokens": 20,
    "totalTokens": 120,
    "credits": 1.2
  }
}

Web Socket APIs

REST APIs

Agentic APIs v2 (beta)

Agentic APIs v1 (deprecated)

Admin APIs

Corti Models APIs

Errors

Authorizations

Headers

Path Parameters

Query Parameters

Response