Skip to main content
GET
/
agents
Javascript SDK (Beta)
import { CortiEnvironment, CortiClient } 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();
[
  {
    "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>",
            "redirectUrl": "<string>"
          }
        ]
      }
    ]
  }
]

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

​
Tenant-Name
string
required

Identifies a distinct entity within Corti's multi-tenant system. Ensures correct routing and authentication of the request.

Example:

"base"

Query Parameters

​
limit
integer
default:100

The maximum number of agents to return. If not specified, all agents will be returned.

​
offset
integer
default:0

The number of agents to skip before starting to collect the result set. Default is 0.

​
ephemeral
boolean
default:false

If set to true, ephemeral agents will be included in the response. Default is false.

Response

Agents retrieved successfully.

​
id
string
required

The unique identifier of the agent.

​
name
string
required

The name of the agent.

​
description
string
required

A brief description of the agent's capabilities.

​
systemPrompt
string
required

The system prompt that defines the overall agents behavior and expectations.

​
experts
object[]