Skip to main content
POST
/
agents
cURL
curl --request POST \
  --url https://api.{environment}.corti.app/agents \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Tenant-Name: <tenant-name>' \
  --data '
{
  "name": "<string>",
  "description": "<string>",
  "systemPrompt": "<string>",
  "experts": [
    {
      "name": "<string>",
      "description": "<string>",
      "systemPrompt": "<string>",
      "mcpServers": [
        {
          "name": "<string>",
          "url": "<string>",
          "description": "<string>",
          "authorizationScope": "<string>",
          "redirectUrl": "<string>",
          "token": "<string>"
        }
      ]
    }
  ],
  "mcpServers": [
    {
      "name": "<string>",
      "url": "<string>",
      "description": "<string>",
      "authorizationScope": "<string>",
      "redirectUrl": "<string>",
      "token": "<string>"
    }
  ]
}
'
{
  "id": "<string>",
  "name": "<string>",
  "description": "<string>",
  "systemPrompt": "<string>",
  "experts": [
    {
      "id": "<string>",
      "name": "<string>",
      "description": "<string>",
      "systemPrompt": "<string>",
      "mcpServers": [
        {
          "id": "<string>",
          "name": "<string>",
          "url": "<string>",
          "authorizationScope": "<string>",
          "redirectUrl": "<string>"
        }
      ]
    }
  ],
  "mcpServers": [
    {
      "id": "<string>",
      "name": "<string>",
      "url": "<string>",
      "authorizationScope": "<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

​
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.

​
agentType
enum<string>

Optional type of agent.

Available options:
expert,
orchestrator,
interviewing-expert
​
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[]
​
mcpServers
object[]

A list of MCP servers that the agent can call. If omitted, the agent can't call any MCP servers.

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[]
​
mcpServers
object[]

A list of MCP servers that the agent can call. If omitted, the agent can't call any MCP servers.