Get an agent's public A2A Agent Card (legacy path)
curl --request GET \
--url https://api.orbit.devotel.io/api/v1/agents/{id}/.well-known/agent.json \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.orbit.devotel.io/api/v1/agents/{id}/.well-known/agent.json"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.orbit.devotel.io/api/v1/agents/{id}/.well-known/agent.json', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.orbit.devotel.io/api/v1/agents/{id}/.well-known/agent.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>"
],
]);
$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.orbit.devotel.io/api/v1/agents/{id}/.well-known/agent.json"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
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.orbit.devotel.io/api/v1/agents/{id}/.well-known/agent.json")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.orbit.devotel.io/api/v1/agents/{id}/.well-known/agent.json")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"name": "Support Concierge",
"description": "Answers billing and account questions and hands off to a human when needed.",
"url": "https://api.orbit.devotel.io/agents/agent_9f2c/a2a/tasks",
"version": "0.1.0",
"protocolVersion": "0.3.0",
"skills": [
{
"id": "chat",
"name": "Chat",
"description": "Multi-turn conversation answering questions and providing support.",
"tags": [
"chat",
"support"
]
}
],
"authentication": {
"type": "api_key",
"header": "X-A2A-Signature"
},
"metadata": {
"agentId": "agent_9f2c",
"agentType": "chatbot",
"provider": {
"name": "Orbit by Devotel",
"url": "https://orbit.devotel.io"
}
}
}Agents
Get an agent's public A2A Agent Card (legacy path)
Legacy A2A v0.2 alias for Agent Card discovery, serving the identical payload as /.well-known/agent-card.json for federation peers that have not migrated to the newer filename. Resolves the tenant from the required ‘tenant’ query parameter and returns 404 unless the agent’s discovery mode is public.
GET
/
api
/
v1
/
agents
/
{id}
/
.well-known
/
agent.json
Get an agent's public A2A Agent Card (legacy path)
curl --request GET \
--url https://api.orbit.devotel.io/api/v1/agents/{id}/.well-known/agent.json \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.orbit.devotel.io/api/v1/agents/{id}/.well-known/agent.json"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.orbit.devotel.io/api/v1/agents/{id}/.well-known/agent.json', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.orbit.devotel.io/api/v1/agents/{id}/.well-known/agent.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>"
],
]);
$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.orbit.devotel.io/api/v1/agents/{id}/.well-known/agent.json"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
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.orbit.devotel.io/api/v1/agents/{id}/.well-known/agent.json")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.orbit.devotel.io/api/v1/agents/{id}/.well-known/agent.json")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"name": "Support Concierge",
"description": "Answers billing and account questions and hands off to a human when needed.",
"url": "https://api.orbit.devotel.io/agents/agent_9f2c/a2a/tasks",
"version": "0.1.0",
"protocolVersion": "0.3.0",
"skills": [
{
"id": "chat",
"name": "Chat",
"description": "Multi-turn conversation answering questions and providing support.",
"tags": [
"chat",
"support"
]
}
],
"authentication": {
"type": "api_key",
"header": "X-A2A-Signature"
},
"metadata": {
"agentId": "agent_9f2c",
"agentType": "chatbot",
"provider": {
"name": "Orbit by Devotel",
"url": "https://orbit.devotel.io"
}
}
}Authorizations
BearerApiKey
Dashboard JWT token from Clerk
Path Parameters
⌘I