Skip to main content
POST
/
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.create({
    name: "name",
    description: "description"
});
{
  "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>"
        }
      ]
    }
  ]
}

Headers

Tenant-Name
string
required

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

Example:

"copiloteu"

Query Parameters

ephemeral
boolean
default:false

If set to true, the agent will be created as ephemeral, it won't be listed in the agents_list but can still be fetched by ID. Ephemeral agents will be deleted periodically.

Body

application/json
name
string
required

The name of the agent.

description
string
required

A brief description of the agent's capabilities.

systemPrompt
string

The system prompt that defines the overall agents behavior and expectations. This field is optional as there is a default system orchestrator.

experts
object[]
  • Option 1
  • Option 2

Response

Agent created 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[]
  • Option 1
  • Option 2