curl --request GET \
--url https://api.{environment}.corti.app/agents \
--header 'Authorization: Bearer <token>' \
--header 'Tenant-Name: <tenant-name>'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.agents.list();
using Corti;
var client = new CortiClient(
"TENANT_NAME",
CortiClientEnvironment.Eu,
new CortiClientAuth.ClientCredentials("client_id", "client_secret")
);
await client.Agents.ListAsync(new AgentsListRequest());
import requests
url = "https://api.{environment}.corti.app/agents"
headers = {
"Tenant-Name": "<tenant-name>",
"Authorization": "Bearer <token>"
}
response = requests.get(url, headers=headers)
print(response.text)<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.{environment}.corti.app/agents",
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: <tenant-name>"
],
]);
$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/agents"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Tenant-Name", "<tenant-name>")
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.{environment}.corti.app/agents")
.header("Tenant-Name", "<tenant-name>")
.header("Authorization", "Bearer <token>")
.asString();[
{
"id": "<string>",
"name": "<string>",
"description": "<string>",
"systemPrompt": "<string>",
"experts": [
{
"type": "expert",
"id": "<string>",
"name": "<string>",
"description": "<string>",
"systemPrompt": "<string>",
"mcpServers": [
{
"id": "<string>",
"name": "<string>",
"transportType": "stdio",
"authorizationType": "none",
"url": "<string>",
"authorizationScope": "<string>",
"redirectUrl": "<string>"
}
]
}
],
"mcpServers": [
{
"id": "<string>",
"name": "<string>",
"transportType": "stdio",
"authorizationType": "none",
"url": "<string>",
"authorizationScope": "<string>",
"redirectUrl": "<string>"
}
]
}
]{
"code": "<string>",
"description": "<string>",
"howToFix": "<string>",
"details": {},
"cause": {}
}{
"code": "<string>",
"description": "<string>",
"howToFix": "<string>",
"details": {},
"cause": {}
}List Agents
This endpoint retrieves a list of all agents that can be called by the Corti Agent Framework.
curl --request GET \
--url https://api.{environment}.corti.app/agents \
--header 'Authorization: Bearer <token>' \
--header 'Tenant-Name: <tenant-name>'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.agents.list();
using Corti;
var client = new CortiClient(
"TENANT_NAME",
CortiClientEnvironment.Eu,
new CortiClientAuth.ClientCredentials("client_id", "client_secret")
);
await client.Agents.ListAsync(new AgentsListRequest());
import requests
url = "https://api.{environment}.corti.app/agents"
headers = {
"Tenant-Name": "<tenant-name>",
"Authorization": "Bearer <token>"
}
response = requests.get(url, headers=headers)
print(response.text)<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.{environment}.corti.app/agents",
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: <tenant-name>"
],
]);
$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/agents"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Tenant-Name", "<tenant-name>")
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.{environment}.corti.app/agents")
.header("Tenant-Name", "<tenant-name>")
.header("Authorization", "Bearer <token>")
.asString();[
{
"id": "<string>",
"name": "<string>",
"description": "<string>",
"systemPrompt": "<string>",
"experts": [
{
"type": "expert",
"id": "<string>",
"name": "<string>",
"description": "<string>",
"systemPrompt": "<string>",
"mcpServers": [
{
"id": "<string>",
"name": "<string>",
"transportType": "stdio",
"authorizationType": "none",
"url": "<string>",
"authorizationScope": "<string>",
"redirectUrl": "<string>"
}
]
}
],
"mcpServers": [
{
"id": "<string>",
"name": "<string>",
"transportType": "stdio",
"authorizationType": "none",
"url": "<string>",
"authorizationScope": "<string>",
"redirectUrl": "<string>"
}
]
}
]{
"code": "<string>",
"description": "<string>",
"howToFix": "<string>",
"details": {},
"cause": {}
}{
"code": "<string>",
"description": "<string>",
"howToFix": "<string>",
"details": {},
"cause": {}
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Headers
Identifies a distinct entity within Corti's multi-tenant system. Ensures correct routing and authentication of the request.
"base"
Query Parameters
The maximum number of agents to return. If not specified, all agents will be returned.
The number of agents to skip before starting to collect the result set. Default is 0.
If set to true, ephemeral agents will be included in the response. Default is false.
Response
Agents retrieved successfully.
- Option 1
- Option 2
The unique identifier of the agent.
The name of the agent.
A brief description of the agent's capabilities.
The system prompt that defines the overall agents behavior and expectations.
- Option 1
- Option 2
Show child attributes
Show child attributes
A list of MCP servers that the agent can call. If omitted, the agent can't call any MCP servers.
Show child attributes
Show child attributes
Was this page helpful?