curl --request GET \
--url https://api.{environment}.corti.app/v2/agentic/agents/{agentId}/.well-known/agent-card.json \
--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.card("agt.0192f4c8-2c5a-7b3e-9f1a-3c8d6e2b7a40");
using Corti;
var client = new CortiClient(
"TENANT_NAME",
CortiClientEnvironment.Eu,
new CortiClientAuth.ClientCredentials("client_id", "client_secret")
);
await client.Agentic.Agents.CardAsync("agt.0192f4c8-2c5a-7b3e-9f1a-3c8d6e2b7a40");
import requests
url = "https://api.{environment}.corti.app/v2/agentic/agents/{agentId}/.well-known/agent-card.json"
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}/.well-known/agent-card.json",
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}/.well-known/agent-card.json"
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}/.well-known/agent-card.json")
.header("Authorization", "Bearer <token>")
.header("Tenant-Name", "<api-key>")
.asString();{
"name": "coder",
"description": "Returns ICD-10 codes for a clinical encounter.",
"version": "0.1.0",
"capabilities": {
"streaming": true,
"pushNotifications": false
},
"defaultInputModes": [
"text/plain"
],
"defaultOutputModes": [
"text/plain"
],
"provider": {
"organization": "Corti",
"url": "https://corti.ai"
},
"skills": [
{
"id": "con.0192f4c8-7baf-7083-a46f-81d2bd70cf95",
"name": "coding-expert",
"description": "ICD-10 coding.",
"tags": [
"expert"
]
}
],
"supportedInterfaces": [
{
"protocolBinding": "JSONRPC",
"protocolVersion": "1.0",
"url": "https://api.eu.corti.app/v2/agentic/agents/agt.0192f4c8-2c5a-7b3e-9f1a-3c8d6e2b7a40/a2a"
},
{
"protocolBinding": "HTTP+JSON",
"protocolVersion": "1.0",
"url": "https://api.eu.corti.app/v2/agentic/agents/agt.0192f4c8-2c5a-7b3e-9f1a-3c8d6e2b7a40/a2a"
}
]
}{
"error": {
"code": "ASSIGNMENT_CONFLICT",
"message": "could not complete assignment",
"details": {
"assignment_id": "asg_99",
"expert_id": "exp_42"
}
}
}{
"error": {
"code": "ASSIGNMENT_CONFLICT",
"message": "could not complete assignment",
"details": {
"assignment_id": "asg_99",
"expert_id": "exp_42"
}
}
}Get the A2A agent card
Returns the A2A v1.0 agent card describing the agent’s capabilities,
skills, and supported protocol interfaces. Served at the standard
.well-known location for agent discovery.
curl --request GET \
--url https://api.{environment}.corti.app/v2/agentic/agents/{agentId}/.well-known/agent-card.json \
--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.card("agt.0192f4c8-2c5a-7b3e-9f1a-3c8d6e2b7a40");
using Corti;
var client = new CortiClient(
"TENANT_NAME",
CortiClientEnvironment.Eu,
new CortiClientAuth.ClientCredentials("client_id", "client_secret")
);
await client.Agentic.Agents.CardAsync("agt.0192f4c8-2c5a-7b3e-9f1a-3c8d6e2b7a40");
import requests
url = "https://api.{environment}.corti.app/v2/agentic/agents/{agentId}/.well-known/agent-card.json"
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}/.well-known/agent-card.json",
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}/.well-known/agent-card.json"
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}/.well-known/agent-card.json")
.header("Authorization", "Bearer <token>")
.header("Tenant-Name", "<api-key>")
.asString();{
"name": "coder",
"description": "Returns ICD-10 codes for a clinical encounter.",
"version": "0.1.0",
"capabilities": {
"streaming": true,
"pushNotifications": false
},
"defaultInputModes": [
"text/plain"
],
"defaultOutputModes": [
"text/plain"
],
"provider": {
"organization": "Corti",
"url": "https://corti.ai"
},
"skills": [
{
"id": "con.0192f4c8-7baf-7083-a46f-81d2bd70cf95",
"name": "coding-expert",
"description": "ICD-10 coding.",
"tags": [
"expert"
]
}
],
"supportedInterfaces": [
{
"protocolBinding": "JSONRPC",
"protocolVersion": "1.0",
"url": "https://api.eu.corti.app/v2/agentic/agents/agt.0192f4c8-2c5a-7b3e-9f1a-3c8d6e2b7a40/a2a"
},
{
"protocolBinding": "HTTP+JSON",
"protocolVersion": "1.0",
"url": "https://api.eu.corti.app/v2/agentic/agents/agt.0192f4c8-2c5a-7b3e-9f1a-3c8d6e2b7a40/a2a"
}
]
}{
"error": {
"code": "ASSIGNMENT_CONFLICT",
"message": "could not complete assignment",
"details": {
"assignment_id": "asg_99",
"expert_id": "exp_42"
}
}
}{
"error": {
"code": "ASSIGNMENT_CONFLICT",
"message": "could not complete assignment",
"details": {
"assignment_id": "asg_99",
"expert_id": "exp_42"
}
}
}Authorizations
OAuth 2.0 / OIDC bearer token.
The tenant the request operates within.
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"
Response
The agent card.
An A2A agent card describing capabilities, skills, and supported interfaces.
Agent display name.
"Corti Coding Agent"
Agent card version (SemVer).
"2.0.0"
Agent capability flags (streaming, push notifications).
Show child attributes
Show child attributes
{
"streaming": true,
"pushNotifications": false
}
A2A protocol bindings. v2 advertises protocolVersion 1.0 only.
Show child attributes
Show child attributes
[
{
"protocolBinding": "JSONRPC",
"protocolVersion": "1.0",
"url": "https://api.eu.corti.app/v2/agentic/agents/agt.0192f4c8-2c5a-7b3e-9f1a-3c8d6e2b7a40/a2a"
}
]
Agent description.
"Returns ICD-10 codes for a clinical encounter."
A URL providing additional documentation about the agent.
Optional URL to an icon for the agent.
Default input media types.
["text/plain"]
Default output media types.
["text/plain"]
Publishing organization and URL.
Show child attributes
Show child attributes
{
"organization": "Corti",
"url": "https://corti.ai"
}
Security requirements for contacting the agent.
The security scheme details used for authenticating with this agent.
JSON Web Signatures (JWS, RFC 7515) computed for this agent card.
Show child attributes
Show child attributes
Skills the agent exposes.
Show child attributes
Show child attributes
[
{
"id": "con.0192f4c8-7baf-7083-a46f-81d2bd70cf95",
"name": "coding-expert",
"description": "ICD-10 coding.",
"tags": ["expert"]
}
]
Was this page helpful?