List agents

cURL

curl --request GET \
  --url https://api.{environment}.corti.app/v2/agentic/agents \
  --header 'Authorization: Bearer <token>' \
  --header 'Tenant-Name: <api-key>'

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"
});
const pageableResponse = await client.agentic.agents.list({
    label: ["team=coding"],
    q: "coder"
});
for await (const item of pageableResponse) {
    console.log(item);
}

// Or you can manually iterate page-by-page
let page = await client.agentic.agents.list({
    label: ["team=coding"],
    q: "coder"
});
while (page.hasNextPage()) {
    page = page.getNextPage();
}

// You can also access the underlying response
const response = page.response;

using Corti.Agentic;
using Corti;

var client = new CortiClient(
    "TENANT_NAME",
    CortiClientEnvironment.Eu,
    new CortiClientAuth.ClientCredentials("client_id", "client_secret")
);
var items = await client.Agentic.Agents.ListAsync(
    new AgenticAgentsListRequest
    {
        Label = new List<string>() { "team=coding" },
        Q = "coder",
    }
);

await foreach (var item in items)
{
    // do something with item
}

import requests

url = "https://api.{environment}.corti.app/v2/agentic/agents"

headers = {
    "Authorization": "Bearer <token>",
    "Tenant-Name": "<api-key>"
}

response = requests.get(url, headers=headers)

print(response.text)

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.{environment}.corti.app/v2/agentic/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: <api-key>"
  ],
]);

$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/v2/agentic/agents"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Tenant-Name", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "agents": [
    {
      "id": "agt.0192f4c8-2c5a-7b3e-9f1a-3c8d6e2b7a40",
      "name": "coder",
      "visibility": "private",
      "lifecycle": "persistent",
      "createdAt": "2026-05-19T12:00:00Z",
      "updatedAt": "2026-05-19T12:00:00Z",
      "createdBy": "usr.0192f4c8-8bc0-7194-8570-92e3ce81d0a6",
      "connectors": []
    }
  ]
}

{
  "error": {
    "code": "ASSIGNMENT_CONFLICT",
    "message": "could not complete assignment",
    "details": {
      "assignment_id": "asg_99",
      "expert_id": "exp_42"
    }
  }
}

{
  "error": {
    "code": "ASSIGNMENT_CONFLICT",
    "message": "could not complete assignment",
    "details": {
      "assignment_id": "asg_99",
      "expert_id": "exp_42"
    }
  }
}

GET

agentic

agents

cURL

curl --request GET \
  --url https://api.{environment}.corti.app/v2/agentic/agents \
  --header 'Authorization: Bearer <token>' \
  --header 'Tenant-Name: <api-key>'

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"
});
const pageableResponse = await client.agentic.agents.list({
    label: ["team=coding"],
    q: "coder"
});
for await (const item of pageableResponse) {
    console.log(item);
}

// Or you can manually iterate page-by-page
let page = await client.agentic.agents.list({
    label: ["team=coding"],
    q: "coder"
});
while (page.hasNextPage()) {
    page = page.getNextPage();
}

// You can also access the underlying response
const response = page.response;

using Corti.Agentic;
using Corti;

var client = new CortiClient(
    "TENANT_NAME",
    CortiClientEnvironment.Eu,
    new CortiClientAuth.ClientCredentials("client_id", "client_secret")
);
var items = await client.Agentic.Agents.ListAsync(
    new AgenticAgentsListRequest
    {
        Label = new List<string>() { "team=coding" },
        Q = "coder",
    }
);

await foreach (var item in items)
{
    // do something with item
}

import requests

url = "https://api.{environment}.corti.app/v2/agentic/agents"

headers = {
    "Authorization": "Bearer <token>",
    "Tenant-Name": "<api-key>"
}

response = requests.get(url, headers=headers)

print(response.text)

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.{environment}.corti.app/v2/agentic/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: <api-key>"
  ],
]);

$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/v2/agentic/agents"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Tenant-Name", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "agents": [
    {
      "id": "agt.0192f4c8-2c5a-7b3e-9f1a-3c8d6e2b7a40",
      "name": "coder",
      "visibility": "private",
      "lifecycle": "persistent",
      "createdAt": "2026-05-19T12:00:00Z",
      "updatedAt": "2026-05-19T12:00:00Z",
      "createdBy": "usr.0192f4c8-8bc0-7194-8570-92e3ce81d0a6",
      "connectors": []
    }
  ]
}

{
  "error": {
    "code": "ASSIGNMENT_CONFLICT",
    "message": "could not complete assignment",
    "details": {
      "assignment_id": "asg_99",
      "expert_id": "exp_42"
    }
  }
}

{
  "error": {
    "code": "ASSIGNMENT_CONFLICT",
    "message": "could not complete assignment",
    "details": {
      "assignment_id": "asg_99",
      "expert_id": "exp_42"
    }
  }
}

Authorizations

Authorization

string

header

required

OAuth 2.0 / OIDC bearer token.

Tenant-Name

string

header

required

The tenant the request operates within.

Query Parameters

pageSize

integer

default:50

Maximum number of items per page.

Required range: 1 <= x <= 200

pageToken

string

Opaque cursor from a prior response's nextPageToken. Omit on the first request.

visibility

enum<string>[]

Filter by one or more visibility levels.

private — creator / service principal only.
unlisted — usable by ID, hidden from list results.
public — listed tenant-wide.

Available options:

private,

unlisted,

public

lifecycle

enum<string>

default:ephemeral

Filter by lifecycle.

ephemeral — short-lived; expired automatically.
persistent — retained until explicitly deleted.

Available options:

ephemeral,

persistent

label

string[]

Filter by label equality, repeated key=value pairs (AND-combined).

Pattern: ^[^=]+=[^=]*$

string

Free-text search over name and description.

Maximum string length: 256

Example:

"coder"

Response

A page of agents.

agents

object[]

required

Agents on the current page.

Show child attributes

Example:

[
  {
    "id": "agt.0192f4c8-2c5a-7b3e-9f1a-3c8d6e2b7a40",
    "name": "coder",
    "visibility": "private",
    "lifecycle": "persistent",
    "connectors": [],
    "createdAt": "2026-05-19T12:00:00Z",
    "updatedAt": "2026-05-19T12:00:00Z",
    "createdBy": "usr.0192f4c8-8bc0-7194-8570-92e3ce81d0a6"
  }
]

nextPageToken

string | null

Opaque cursor to request the next page, or null if there are no more pages.

totalSize

integer

Total number of items matching the query, when known. Not currently populated by the server; treat as absent.

Example:

42

Web Socket APIs

REST APIs

Agentic APIs v2 (beta)

Agentic APIs v1 (deprecated)

Admin APIs

Corti Models APIs

Errors

Authorizations

Query Parameters

Response