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
}
Lists agents visible to the caller. private agents are visible only to
their creator/service principal; unlisted agents are omitted (fetch by
ID instead); public agents are listed tenant-wide.
The visibility, lifecycle, label, and q filter parameters are accepted but not yet honored by the server; the response is unfiltered.
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
}
Total number of items matching the query, when known. Not currently populated by the server; treat as absent.
Example:
42
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Corti API Documentation","description":"Explore product documentation, quickstart guides, tutorials, release notes, and detailed API references to build with Corti API. Leverage full stack AI to unlock workflows with speech to text, text generation, agentic framework, embedded Corti Assistant and more.","colors":{"primary":"#3F3F46","light":"#F4F4F5","dark":"#18181B"},"logo":{"light":"https://mintcdn.com/corti/en_RPjQCFb1qJpbU/logo/corti_light.svg?fit=max\u0026auto=format\u0026n=en_RPjQCFb1qJpbU\u0026q=85\u0026s=effbca890e531e034f6b66ce8e15aa6c","dark":"https://mintcdn.com/corti/en_RPjQCFb1qJpbU/logo/corti_dark.svg?fit=max\u0026auto=format\u0026n=en_RPjQCFb1qJpbU\u0026q=85\u0026s=39e1b8245783318adebc44f1548aee0d"},"favicon":"https://mintcdn.com/corti/en_RPjQCFb1qJpbU/logo/favicon-docs.svg?fit=max\u0026auto=format\u0026n=en_RPjQCFb1qJpbU\u0026q=85\u0026s=1971ff0d52cd65b9f56d059bc6457848","api":{"playground":{"display":"simple"},"examples":{"languages":["curl","javascript","csharp","python","php","go","java"]},"mdx":{"auth":{"method":"bearer"}}},"background":{"color":{"light":"#FFFFFF","dark":"#09090B"}},"navbar":{"links":[{"href":"https://help.corti.app/","label":"Support"}],"primary":{"type":"button","label":"Start Building","href":"https://console.corti.app/signup"}},"footer":{"socials":{"website":"https://www.corti.ai","x":"https://x.com/corti_ai","linkedin":"https://www.linkedin.com/company/corti","github":"https://github.com/corticph","youtube":"https://www.youtube.com/@cortiai"}},"fonts":{"heading":{"family":"Booton","weight":600},"body":{"family":"Booton","weight":400}},"icons":{"library":"lucide"},"integrations":{"gtm":{"tagId":"GTM-MR3DSSF2"},"intercom":{"appId":"y30epli4"}},"banner":{"content":"Corti Models is now available: frontier AI on sovereign infrastructure, through an OpenAI-compatible API. [Get started](/models/welcome).","dismissible":true},"errors":{"404":{"redirect":false,"title":"Page not found","description":"The page you're looking for doesn't exist or may have moved. Use the search bar above, or start from one of these pages:\n\n- [Get started](/get_started/welcome)\n- [Corti Models](/models/welcome)\n- [Agentic Framework](/agentic/overview)\n- [Speech to Text](/stt/overview)\n- [Clinical Text Generation](/textgen/overview)\n- [Medical Coding](/coding/overview)\n- [Clinical Assistant](/assistant/welcome)\n- [API Reference](/api-reference/welcome)"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"corti","hasAudioNarration":false,"actualSubdomain":"corti","customDomains":["docs.corti.ai"],"gitSource":{"type":"github","owner":"corticph","repo":"docs_corti","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae9e9a807405bf5d5962d53","collectionId":"4dcb83c2-ac0d-4dcb-81f6-3ed8cd1a3b9c","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae9e9a807405bf5d5962d53"},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae9e9a807405bf5d5962d53","clientVersion":"0.0.4074","searchFilterCounts":[{"language":"default","tag":"Healthcare","count":209},{"language":"default","tag":"API Reference","count":141},{"language":"default","tag":"Clinical Assistant","count":117},{"language":"default","tag":"Events","count":85},{"language":"default","tag":"Event Reference","count":84},{"language":"default","tag":"REST APIs","count":60},{"language":"default","tag":"Agentic Framework","count":51},{"language":"default","tag":"Home","count":49},{"language":"default","tag":"Speech to Text","count":48},{"language":"default","tag":"Clinical Text Generation","count":47}]},"assistantConfig":{"enableAskAiButton":true,"enableStarterQuestions":false,"enableAskAiSearchBar":false,"deflection":{"enabled":true,"email":"help@corti.ai"}},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"@font-face{font-family:\"Booton\";src:url(\"/fonts/booton/Booton-Regular.woff2\") format(\"woff2\");font-style:normal;font-weight:400;font-display:swap}@font-face{font-family:\"Booton\";src:url(\"/fonts/booton/Booton-Medium.woff2\") format(\"woff2\");font-style:normal;font-weight:500;font-display:swap}@font-face{font-family:\"Booton\";src:url(\"/fonts/booton/Booton-Semibold.woff2\") format(\"woff2\");font-style:normal;font-weight:600;font-display:swap}:root{--corti-font-sans: \"Booton\", \"Inter\", ui-sans-serif, system-ui, -apple-system, \"Segoe UI\", Roboto, \"Helvetica Neue\", Arial, \"Noto Sans\", sans-serif;--mintlify-slot-header-height: 7rem}html,body{font-family:var(--corti-font-sans);font-weight:400;-webkit-font-smoothing:antialiased}body :not(code):not(code *):not(pre):not(pre *):not(kbd):not(kbd *):not(samp):not(samp *){font-family:var(--corti-font-sans)}h1,h2,h3,h4,h5,h6{font-family:var(--corti-font-sans);font-weight:600!important;color:var(--tw-prose-headings, #18181b)!important}:is(html.dark,.dark) h1,:is(html.dark,.dark) h2,:is(html.dark,.dark) h3,:is(html.dark,.dark) h4,:is(html.dark,.dark) h5,:is(html.dark,.dark) h6{color:#fafafa!important}:is(html.dark,.dark) [data-component-part=\"step-title\"]{color:#fafafa!important}a[target=\"_blank\"][href=\"https://console.corti.app/signup\"].group>span.absolute.inset-0{background-color:#18181b!important}:is(html.dark,.dark) a[target=\"_blank\"][href=\"https://console.corti.app/signup\"].group>span.absolute.inset-0{background-color:#fafafa!important}:is(html.dark,.dark) a[target=\"_blank\"][href=\"https://console.corti.app/signup\"].group .z-10,:is(html.dark,.dark) a[target=\"_blank\"][href=\"https://console.corti.app/signup\"].group .z-10 *,:is(html.dark,.dark) a[target=\"_blank\"][href=\"https://console.corti.app/signup\"].group svg{color:#18181b!important}[data-component-part=\"card-content-container\"]{align-items:flex-start!important}.card [data-component-part=\"card-content\"]>.code-block:last-child{margin-bottom:0!important}[data-component-part=\"card-content-container\"]>div[class*=\"h-6\"][class*=\"w-6\"]{width:24px!important;height:24px!important;min-width:24px;min-height:24px;display:inline-flex;align-items:center;justify-content:center;margin-top:2px}[data-component-part=\"card-content-container\"]>div[class*=\"h-6\"][class*=\"w-6\"] svg,[data-component-part=\"card-content-container\"]>div[class*=\"h-6\"][class*=\"w-6\"] img{width:24px!important;height:24px!important}:is(html.dark,.dark) .card [data-component-part=\"card-title\"],:is(html.dark,.dark) .card [data-component-part=\"card-title\"] a,:is(html.dark,.dark) .card h2 a,:is(html.dark,.dark) .card h3 a,:is(html.dark,.dark) .card h4 a,:is(html.dark,.dark) .card a[href].font-semibold{color:#fafafa!important}:is(html.dark,.dark) .card [data-component-part=\"card-title\"] a:visited,:is(html.dark,.dark) .card h2 a:visited,:is(html.dark,.dark) .card h3 a:visited,:is(html.dark,.dark) .card h4 a:visited,:is(html.dark,.dark) .card a[href].font-semibold:visited{color:#fafafa!important}.nav-tag-pill-text[data-nav-tag=\"beta\"],[data-nav-tag=\"beta\"].nav-tag-pill-text{background-color:#b8f818!important;border:none!important;color:#18181b!important;text-transform:uppercase!important;font-weight:600!important}#navigation-items{padding-bottom:9rem}.accent-badge{background-color:#b8f818!important;border:none!important;color:#18181b!important;text-transform:uppercase!important;font-weight:600!important}.mdx-content li strong{font-weight:600!important}.mdx-content [class*=\"overflow-x-auto\"]{overflow-x:visible!important}.mdx-content [class*=\"w-[calc(100%+(var(--page-padding)*2))]\"]{width:100%!important}.mdx-content [class*=\"-mx-[var(--page-padding)]\"]{margin-left:0!important;margin-right:0!important}.mdx-content [class*=\"max-w-none\"]{max-width:100%!important}.mdx-content .table{display:block!important}.mdx-content table{width:100%!important;max-width:100%!important;min-width:0!important;table-layout:auto;border-collapse:collapse;box-sizing:border-box;margin:0}.mdx-content table th,.mdx-content table td{min-width:0!important;vertical-align:top}.mdx-content table th,.mdx-content table th *{white-space:normal;overflow-wrap:normal!important;word-break:normal!important;hyphens:manual}.mdx-content table th,.mdx-content table th *,.mdx-content table strong{font-weight:600!important}.mdx-content table td{white-space:normal;overflow-wrap:break-word;word-break:normal;hyphens:manual}.mdx-content table code,.mdx-content table kbd,.mdx-content table samp{white-space:nowrap;overflow-wrap:normal;word-break:keep-all}.mdx-content table td code,.mdx-content table td kbd,.mdx-content table td samp{white-space:normal;overflow-wrap:normal;word-break:normal}.mdx-content table td a{white-space:normal;overflow-wrap:break-word;word-break:normal;hyphens:manual}.mdx-content .capabilities-table table th:first-child,.mdx-content .capabilities-table table td:first-child,.mdx-content .capabilities-table table th:last-child,.mdx-content .capabilities-table table td:last-child,.mdx-content .capabilities-table table td:first-child a,.mdx-content .capabilities-table table td:last-child a{white-space:nowrap}.mdx-content table img,.mdx-content table svg{max-width:100%;height:auto;display:block}.mdx-content [data-component-part=\"code-block-root\"]{width:100%!important;max-width:100%!important;overflow-x:auto!important;-webkit-overflow-scrolling:touch}.mdx-content [data-component-part=\"code-block-root\"][class*=\"overflow-x-auto\"]{overflow-x:auto!important}.mdx-content [data-component-part=\"code-block-root\"] pre,.mdx-content [data-component-part=\"code-block-root\"] code,.mdx-content [data-component-part=\"code-block-root\"] .shiki,.mdx-content [data-component-part=\"code-block-root\"] .shiki .line,.mdx-content [data-component-part=\"code-block-root\"] .shiki .line>span{white-space:pre!important;word-break:normal!important;overflow-wrap:normal!important}.mdx-content [data-component-part=\"code-block-root\"] pre>code>span.line-diff{min-width:max-content!important}:not(pre)>code{background-color:rgba(0,0,0,0.03);border:1px solid rgba(0,0,0,0.08);border-radius:6px;padding:0.15em 0.4em;font-size:0.875em;color:inherit}:is(html.dark,.dark) :not(pre)>code{background-color:rgba(255,255,255,0.08);border:1px solid rgba(255,255,255,0.08);color:#fafafa}html:not(.dark) .mdx-content [data-component-part=\"code-block-root\"] .line-highlight,html:not(.dark) .mdx-content [data-component-part=\"code-block-root\"] .line-highlight::before{background-color:rgba(115, 115, 115, 0.16)!important}:is(html.dark,.dark) g.node.nodeNeutral span,:is(html.dark,.dark) g.node.nodeNeutral .label,:is(html.dark,.dark) g.node.nodeNeutral .label text,:is(html.dark,.dark) g.node.nodeGray span,:is(html.dark,.dark) g.node.nodeGray .label,:is(html.dark,.dark) g.node.nodeGray .label text,:is(html.dark,.dark) g.node.nodeBlue span,:is(html.dark,.dark) g.node.nodeBlue .label,:is(html.dark,.dark) g.node.nodeBlue .label text,:is(html.dark,.dark) g.node.nodeGreen span,:is(html.dark,.dark) g.node.nodeGreen .label,:is(html.dark,.dark) g.node.nodeGreen .label text,:is(html.dark,.dark) g.node.nodeYellow span,:is(html.dark,.dark) g.node.nodeYellow .label,:is(html.dark,.dark) g.node.nodeYellow .label text,:is(html.dark,.dark) g.node.nodeCyan span,:is(html.dark,.dark) g.node.nodeCyan .label,:is(html.dark,.dark) g.node.nodeCyan .label text,:is(html.dark,.dark) g.node.nodePurple span,:is(html.dark,.dark) g.node.nodePurple .label,:is(html.dark,.dark) g.node.nodePurple .label text,:is(html.dark,.dark) g.node.nodeLightPurple span,:is(html.dark,.dark) g.node.nodeLightPurple .label,:is(html.dark,.dark) g.node.nodeLightPurple .label text{color:#1a1a1a!important;fill:#1a1a1a!important}img[src$=\"embedded-assistant.svg\"]{filter:brightness(0) invert(32%)}a[aria-current=\"location\"] img[src$=\"embedded-assistant.svg\"],a:hover img[src$=\"embedded-assistant.svg\"]{filter:brightness(0) invert(15%)}:is(html.dark,.dark) img[src$=\"embedded-assistant.svg\"]{filter:brightness(0) invert(63%)}:is(html.dark,.dark) a[aria-current=\"location\"] img[src$=\"embedded-assistant.svg\"],:is(html.dark,.dark) a:hover img[src$=\"embedded-assistant.svg\"]{filter:brightness(0) invert(88%)}.errors-tabs [role=\"tablist\"] [role=\"tab\"],.errors-tabs [role=\"tablist\"] [role=\"tab\"] *,.errors-tabs [role=\"tablist\"] button,.errors-tabs [role=\"tablist\"] button *{font-weight:800!important;font-size:1.05em!important}"}],"page":{"pagePath":"agentic-v2/agents/list-agents","slug":"/agentic-v2/agents/list-agents","pageMetadata":{"title":"List agents","description":"Lists agents visible to the caller. `private` agents are visible only to\ntheir creator/service principal; `unlisted` agents are omitted (fetch by\nID instead); `public` agents are listed tenant-wide.\nThe `visibility`, `lifecycle`, `label`, and `q` filter parameters are accepted but not yet honored by the server; the response is unfiltered. ","deprecated":null,"version":null,"openapi":"/agentic/auto-generated-openapi-v2.yml get /agentic/agents","href":"/agentic-v2/agents/list-agents","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Lists agents visible to the caller. \", _jsx(_components.code, {\n children: \"private\"\n }), \" agents are visible only to\\ntheir creator/service principal; \", _jsx(_components.code, {\n children: \"unlisted\"\n }), \" agents are omitted (fetch by\\nID instead); \", _jsx(_components.code, {\n children: \"public\"\n }), \" agents are listed tenant-wide.\\nThe \", _jsx(_components.code, {\n children: \"visibility\"\n }), \", \", _jsx(_components.code, {\n children: \"lifecycle\"\n }), \", \", _jsx(_components.code, {\n children: \"label\"\n }), \", and \", _jsx(_components.code, {\n children: \"q\"\n }), \" filter parameters are accepted but not yet honored by the server; the response is unfiltered.\"]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"List agents","description":"Lists agents visible to the caller. `private` agents are visible only to\ntheir creator/service principal; `unlisted` agents are omitted (fetch by\nID instead); `public` agents are listed tenant-wide.\nThe `visibility`, `lifecycle`, `label`, and `q` filter parameters are accepted but not yet honored by the server; the response is unfiltered. ","deprecated":null,"version":null,"openapi":"/agentic/auto-generated-openapi-v2.yml get /agentic/agents","href":"/agentic-v2/agents/list-agents","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/corti/f39b9e0170d6232a/api-reference/corti.js","/_mintlify/custom/corti/8c15918c79eb9f3c/generate-events-nav.js"],"openApiReferenceData":{"operation":{"tags":["Agents"],"operationId":"AgentsList","summary":"List agents","description":"Lists agents visible to the caller. `private` agents are visible only to\ntheir creator/service principal; `unlisted` agents are omitted (fetch by\nID instead); `public` agents are listed tenant-wide.\nThe `visibility`, `lifecycle`, `label`, and `q` filter parameters are accepted but not yet honored by the server; the response is unfiltered. ","parameters":["6d7ac8f3-9dab-4452-ad8a-df10faab94e9","47a248a8-2b89-45f1-bff1-4a92fcc099ed","8b4b121b-242e-428d-a25e-6860759615f9","c3951208-1d0e-46af-be7f-bd2e1b9969ca","e110cf5c-c1fa-458d-ba07-75c0e0fb1ccc","ac07d4d3-28ce-4c02-90c4-76947291ef4d"],"responses":{"200":"dff65307-1c0f-40e0-bff2-16ab8cd87bbe","400":"a6774223-7b1f-4559-9077-0a2202e3cbed","401":"4f5a4d52-9ed9-4238-bfdf-1a613b3bd40b"},"x-codeSamples":[{"lang":"csharp","label":"C# .NET SDK","source":"using Corti.Agentic;\nusing Corti;\n\nvar client = new CortiClient(\n \"TENANT_NAME\",\n CortiClientEnvironment.Eu,\n new CortiClientAuth.ClientCredentials(\"client_id\", \"client_secret\")\n);\nvar items = await client.Agentic.Agents.ListAsync(\n new AgenticAgentsListRequest\n {\n Label = new List\u003cstring>() { \"team=coding\" },\n Q = \"coder\",\n }\n);\n\nawait foreach (var item in items)\n{\n // do something with item\n}\n"},{"lang":"javascript","label":"JavaScript SDK","source":"import { CortiClient, CortiEnvironment } from \"@corti/sdk\";\n\nconst client = new CortiClient({\n environment: CortiEnvironment.Eu,\n auth: {\n clientId: \"YOUR_CLIENT_ID\",\n clientSecret: \"YOUR_CLIENT_SECRET\"\n },\n tenantName: \"YOUR_TENANT_NAME\"\n});\nconst pageableResponse = await client.agentic.agents.list({\n label: [\"team=coding\"],\n q: \"coder\"\n});\nfor await (const item of pageableResponse) {\n console.log(item);\n}\n\n// Or you can manually iterate page-by-page\nlet page = await client.agentic.agents.list({\n label: [\"team=coding\"],\n q: \"coder\"\n});\nwhile (page.hasNextPage()) {\n page = page.getNextPage();\n}\n\n// You can also access the underlying response\nconst response = page.response;\n"}],"method":"get","type":"path","servers":["ce2bc9db-751e-40c4-9602-b295cd851c23"],"security":["f25353c6-49cd-445f-ab1b-ce71788a1457"],"path":"/agentic/agents","baseUrlOptions":["https://api.{environment}.corti.app/v2/"],"title":"List agents","codeSamples":[{"label":"C# .NET SDK","lang":"csharp","source":"using Corti.Agentic;\nusing Corti;\n\nvar client = new CortiClient(\n \"TENANT_NAME\",\n CortiClientEnvironment.Eu,\n new CortiClientAuth.ClientCredentials(\"client_id\", \"client_secret\")\n);\nvar items = await client.Agentic.Agents.ListAsync(\n new AgenticAgentsListRequest\n {\n Label = new List\u003cstring>() { \"team=coding\" },\n Q = \"coder\",\n }\n);\n\nawait foreach (var item in items)\n{\n // do something with item\n}\n"},{"label":"JavaScript SDK","lang":"javascript","source":"import { CortiClient, CortiEnvironment } from \"@corti/sdk\";\n\nconst client = new CortiClient({\n environment: CortiEnvironment.Eu,\n auth: {\n clientId: \"YOUR_CLIENT_ID\",\n clientSecret: \"YOUR_CLIENT_SECRET\"\n },\n tenantName: \"YOUR_TENANT_NAME\"\n});\nconst pageableResponse = await client.agentic.agents.list({\n label: [\"team=coding\"],\n q: \"coder\"\n});\nfor await (const item of pageableResponse) {\n console.log(item);\n}\n\n// Or you can manually iterate page-by-page\nlet page = await client.agentic.agents.list({\n label: [\"team=coding\"],\n q: \"coder\"\n});\nwhile (page.hasNextPage()) {\n page = page.getNextPage();\n}\n\n// You can also access the underlying response\nconst response = page.response;\n"}],"requestExampleLanguages":["bash","javascript","csharp","python","php","go","java"],"requiredOnlyExamples":false,"requestExampleType":"codeSamples","responseExampleType":"generated"},"dependencies":{"parameters":{"6d7ac8f3-9dab-4452-ad8a-df10faab94e9":{"name":"pageSize","in":"query","required":false,"description":"Maximum number of items per page.","schema":{"type":"integer","minimum":1,"maximum":200,"default":50,"isRequired":false,"description":"Maximum number of items per page.","uniqueKey":"","typeLabel":"integer"}},"47a248a8-2b89-45f1-bff1-4a92fcc099ed":{"name":"pageToken","in":"query","required":false,"description":"Opaque cursor from a prior response's `nextPageToken`. Omit on the first request.","schema":{"type":"string","isRequired":false,"description":"Opaque cursor from a prior response's `nextPageToken`. Omit on the first request.","uniqueKey":"","typeLabel":"string"}},"8b4b121b-242e-428d-a25e-6860759615f9":{"name":"visibility","in":"query","description":"Filter by one or more visibility levels.","required":false,"schema":{"type":"array","items":{"type":"string","description":"- `private` — creator / service principal only.\n- `unlisted` — usable by ID, hidden from list results.\n- `public` — listed tenant-wide.\n","enum":["private","unlisted","public"],"example":"private","uniqueKey":"items.[INDEX]","typeLabel":"enum\u003cstring>"},"isRequired":false,"description":"Filter by one or more visibility levels.","uniqueKey":"","typeLabel":"enum\u003cstring>[]"},"style":"form","explode":true},"c3951208-1d0e-46af-be7f-bd2e1b9969ca":{"name":"lifecycle","in":"query","description":"Filter by lifecycle.","schema":{"type":"string","description":"Filter by lifecycle.\n- `ephemeral` — short-lived; expired automatically.\n- `persistent` — retained until explicitly deleted.\n","enum":["ephemeral","persistent"],"default":"ephemeral","uniqueKey":"","typeLabel":"enum\u003cstring>"}},"e110cf5c-c1fa-458d-ba07-75c0e0fb1ccc":{"name":"label","in":"query","description":"Filter by label equality, repeated `key=value` pairs (AND-combined).","required":false,"example":["team=coding"],"schema":{"type":"array","items":{"type":"string","pattern":"^[^=]+=[^=]*$","example":"team=coding","uniqueKey":"items.[INDEX]","typeLabel":"string"},"isRequired":false,"description":"Filter by label equality, repeated `key=value` pairs (AND-combined).","uniqueKey":"","typeLabel":"string[]"},"style":"form","explode":true},"ac07d4d3-28ce-4c02-90c4-76947291ef4d":{"name":"q","in":"query","description":"Free-text search over `name` and `description`.","example":"coder","schema":{"type":"string","maxLength":256,"example":"coder","description":"Free-text search over `name` and `description`.","uniqueKey":"","typeLabel":"string"}}},"responses":{"dff65307-1c0f-40e0-bff2-16ab8cd87bbe":{"description":"A page of agents.","content":{"application/json":{"schema":{"type":"object","description":"A page of agents.","required":["agents"],"properties":{"agents":{"type":"array","items":{"type":"object","description":"A configured agent — its metadata, model, and attached connectors.","required":["id","name","visibility","lifecycle","maxLoops","connectors","createdAt","updatedAt","createdBy"],"properties":{"id":{"type":"string","format":"agent-id","description":"Agent identifier. Accepts `agt.\u003cuuidv7>` or a bare UUIDv7 on input; always returned prefixed.","pattern":"^(agt\\.)?[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$","examples":["agt.0192f4c8-2c5a-7b3e-9f1a-3c8d6e2b7a40"],"isRequired":true,"uniqueKey":"agents.items.[INDEX].id","typeLabel":"string\u003cagent-id>"},"name":{"type":"string","minLength":1,"maxLength":128,"description":"Human-readable, unique-per-tenant agent name.","isRequired":true,"uniqueKey":"agents.items.[INDEX].name","typeLabel":"string"},"maxLoops":{"type":"integer","format":"int32","minimum":1,"maximum":100,"description":"Effective cap on the orchestrator's ReAct loop iterations per run. Always present: agents created without `maxLoops` report the server default (10).","examples":[10],"isRequired":true,"uniqueKey":"agents.items.[INDEX].maxLoops","typeLabel":"integer\u003cint32>"},"visibility":{"type":"string","description":"- `private` — creator / service principal only.\n- `unlisted` — usable by ID, hidden from list results.\n- `public` — listed tenant-wide.\n","enum":["private","unlisted","public"],"example":"private","isRequired":true,"uniqueKey":"agents.items.[INDEX].visibility","typeLabel":"enum\u003cstring>"},"lifecycle":{"type":"string","description":"- `ephemeral` — short-lived; expired automatically.\n- `persistent` — retained until explicitly deleted.\n","enum":["ephemeral","persistent"],"default":"ephemeral","isRequired":true,"uniqueKey":"agents.items.[INDEX].lifecycle","typeLabel":"enum\u003cstring>"},"connectors":{"type":"array","items":{"oneOf":[{"type":"object","description":"A connector attached to an agent, discriminated by `type`.","required":["name","id","type"],"properties":{"id":{"type":"string","format":"connector-id","description":"Server-generated connector identifier (prefixed UUIDv7). Stable across PATCH\nreplacements where the underlying spec is unchanged. Used by\nobservability/HITL to reference a connector unambiguously.\n","pattern":"^(con\\.)?[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$","examples":["con.0192f4c8-7baf-7083-a46f-81d2bd70cf95"],"readOnly":true,"isRequired":true,"uniqueKey":"agents.items.[INDEX].connectors.items.[INDEX].oneOf.0.id","typeLabel":"string\u003cconnector-id>"},"type":{"type":"string","description":"Connector discriminator; always `registry`.","enum":["registry","mcp","agent","a2a","schema"],"const":"registry","isRequired":true,"uniqueKey":"agents.items.[INDEX].connectors.items.[INDEX].oneOf.0.type","typeLabel":"enum\u003cstring>"},"name":{"type":"string","description":"Registry connector name.","examples":["pubmed-expert"],"isRequired":true,"uniqueKey":"agents.items.[INDEX].connectors.items.[INDEX].oneOf.0.name","typeLabel":"string"},"enabled":{"type":"boolean","default":true,"description":"Whether the connector is active for invocations. Only `schema` connectors return this field today; `mcp`, `registry`, `agent`, and `a2a` connectors omit it (treat as enabled). ","uniqueKey":"agents.items.[INDEX].connectors.items.[INDEX].oneOf.0.enabled","typeLabel":"boolean"},"auth":{"type":"object","description":"Authentication configuration.","required":["type"],"properties":{"type":{"type":"string","enum":["none","bearer","apiKey","oauth2","inherit"],"description":"Authentication mechanism.\n`inherit` forwards the caller's bearer token to the MCP server,\nwhich is required for internal MCP gateways that expect the\nCorti platform token for auth.\n","isRequired":true,"uniqueKey":"agents.items.[INDEX].connectors.items.[INDEX].oneOf.0.auth.type","typeLabel":"enum\u003cstring>"},"scope":{"type":"string","description":"OAuth2 scope requested.","uniqueKey":"agents.items.[INDEX].connectors.items.[INDEX].oneOf.0.auth.scope","typeLabel":"string"},"tokenUrl":{"type":"string","format":"uri","description":"Token URL override for the OAuth2.0 token endpoint.","uniqueKey":"agents.items.[INDEX].connectors.items.[INDEX].oneOf.0.auth.tokenUrl","typeLabel":"string\u003curi>"},"ref":{"type":"string","description":"Reference to a server-side stored secret. Mutually exclusive with inline credentials passed at call time.","uniqueKey":"agents.items.[INDEX].connectors.items.[INDEX].oneOf.0.auth.ref","typeLabel":"string"},"requiredHeaders":{"type":"array","items":{"type":"string","uniqueKey":"agents.items.[INDEX].connectors.items.[INDEX].oneOf.0.auth.requiredHeaders.items.[INDEX]","typeLabel":"string"},"description":"Header names the MCP server requires the client to send in the authorization data part. The client must supply values for each listed name; missing headers trigger an auth-required challenge that lists them.\n","uniqueKey":"agents.items.[INDEX].connectors.items.[INDEX].oneOf.0.auth.requiredHeaders","typeLabel":"string[]"},"optionalHeaders":{"type":"array","items":{"type":"string","uniqueKey":"agents.items.[INDEX].connectors.items.[INDEX].oneOf.0.auth.optionalHeaders.items.[INDEX]","typeLabel":"string"},"description":"Header names the client may optionally send. Headers not in requiredHeaders or optionalHeaders are rejected as undeclared.\n","uniqueKey":"agents.items.[INDEX].connectors.items.[INDEX].oneOf.0.auth.optionalHeaders","typeLabel":"string[]"}},"additionalProperties":false,"examples":[{"type":"oauth2","scope":"read:policies","tokenUrl":"https://app.corti.ai/oauth/token"}],"uniqueKey":"agents.items.[INDEX].connectors.items.[INDEX].oneOf.0.auth","typeLabel":"object"},"config":{"type":"object","description":"Connector-specific configuration validated against the registry schema.","additionalProperties":true,"uniqueKey":"agents.items.[INDEX].connectors.items.[INDEX].oneOf.0.config","typeLabel":"object"}},"uniqueKey":"agents.items.[INDEX].connectors.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","description":"A connector attached to an agent, discriminated by `type`.","required":["name","url","id","type"],"properties":{"id":{"type":"string","format":"connector-id","description":"Server-generated connector identifier (prefixed UUIDv7). Stable across PATCH\nreplacements where the underlying spec is unchanged. Used by\nobservability/HITL to reference a connector unambiguously.\n","pattern":"^(con\\.)?[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$","examples":["con.0192f4c8-7baf-7083-a46f-81d2bd70cf95"],"readOnly":true,"isRequired":true,"uniqueKey":"agents.items.[INDEX].connectors.items.[INDEX].oneOf.1.id","typeLabel":"string\u003cconnector-id>"},"type":{"type":"string","description":"Connector discriminator; always `mcp`.","enum":["registry","mcp","agent","a2a","schema"],"const":"mcp","isRequired":true,"uniqueKey":"agents.items.[INDEX].connectors.items.[INDEX].oneOf.1.type","typeLabel":"enum\u003cstring>"},"name":{"type":"string","description":"Display name for the MCP connector.","isRequired":true,"uniqueKey":"agents.items.[INDEX].connectors.items.[INDEX].oneOf.1.name","typeLabel":"string"},"url":{"type":"string","description":"MCP server endpoint URL.","isRequired":true,"uniqueKey":"agents.items.[INDEX].connectors.items.[INDEX].oneOf.1.url","typeLabel":"string"},"enabled":{"type":"boolean","default":true,"description":"Whether the connector is active for invocations. Only `schema` connectors return this field today; `mcp`, `registry`, `agent`, and `a2a` connectors omit it (treat as enabled). ","uniqueKey":"agents.items.[INDEX].connectors.items.[INDEX].oneOf.1.enabled","typeLabel":"boolean"},"auth":{"type":"object","description":"Authentication configuration.","required":["type"],"properties":{"type":{"type":"string","enum":["none","bearer","apiKey","oauth2","inherit"],"description":"Authentication mechanism.\n`inherit` forwards the caller's bearer token to the MCP server,\nwhich is required for internal MCP gateways that expect the\nCorti platform token for auth.\n","isRequired":true,"uniqueKey":"agents.items.[INDEX].connectors.items.[INDEX].oneOf.1.auth.type","typeLabel":"enum\u003cstring>"},"scope":{"type":"string","description":"OAuth2 scope requested.","uniqueKey":"agents.items.[INDEX].connectors.items.[INDEX].oneOf.1.auth.scope","typeLabel":"string"},"tokenUrl":{"type":"string","format":"uri","description":"Token URL override for the OAuth2.0 token endpoint.","uniqueKey":"agents.items.[INDEX].connectors.items.[INDEX].oneOf.1.auth.tokenUrl","typeLabel":"string\u003curi>"},"ref":{"type":"string","description":"Reference to a server-side stored secret. Mutually exclusive with inline credentials passed at call time.","uniqueKey":"agents.items.[INDEX].connectors.items.[INDEX].oneOf.1.auth.ref","typeLabel":"string"},"requiredHeaders":{"type":"array","items":{"type":"string","uniqueKey":"agents.items.[INDEX].connectors.items.[INDEX].oneOf.1.auth.requiredHeaders.items.[INDEX]","typeLabel":"string"},"description":"Header names the MCP server requires the client to send in the authorization data part. The client must supply values for each listed name; missing headers trigger an auth-required challenge that lists them.\n","uniqueKey":"agents.items.[INDEX].connectors.items.[INDEX].oneOf.1.auth.requiredHeaders","typeLabel":"string[]"},"optionalHeaders":{"type":"array","items":{"type":"string","uniqueKey":"agents.items.[INDEX].connectors.items.[INDEX].oneOf.1.auth.optionalHeaders.items.[INDEX]","typeLabel":"string"},"description":"Header names the client may optionally send. Headers not in requiredHeaders or optionalHeaders are rejected as undeclared.\n","uniqueKey":"agents.items.[INDEX].connectors.items.[INDEX].oneOf.1.auth.optionalHeaders","typeLabel":"string[]"}},"additionalProperties":false,"examples":[{"type":"oauth2","scope":"read:policies","tokenUrl":"https://app.corti.ai/oauth/token"}],"uniqueKey":"agents.items.[INDEX].connectors.items.[INDEX].oneOf.1.auth","typeLabel":"object"}},"uniqueKey":"agents.items.[INDEX].connectors.items.[INDEX].oneOf.1","typeLabel":"object"},{"type":"object","description":"A connector attached to an agent, discriminated by `type`.","required":["agentId","id","type"],"properties":{"id":{"type":"string","format":"connector-id","description":"Server-generated connector identifier (prefixed UUIDv7). Stable across PATCH\nreplacements where the underlying spec is unchanged. Used by\nobservability/HITL to reference a connector unambiguously.\n","pattern":"^(con\\.)?[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$","examples":["con.0192f4c8-7baf-7083-a46f-81d2bd70cf95"],"readOnly":true,"isRequired":true,"uniqueKey":"agents.items.[INDEX].connectors.items.[INDEX].oneOf.2.id","typeLabel":"string\u003cconnector-id>"},"type":{"type":"string","description":"Connector discriminator; always `agent`.","enum":["registry","mcp","agent","a2a","schema"],"const":"agent","isRequired":true,"uniqueKey":"agents.items.[INDEX].connectors.items.[INDEX].oneOf.2.type","typeLabel":"enum\u003cstring>"},"agentId":{"type":"string","format":"agent-id","description":"Agent identifier. Accepts `agt.\u003cuuidv7>` or a bare UUIDv7 on input; always returned prefixed.","pattern":"^(agt\\.)?[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$","examples":["agt.0192f4c8-2c5a-7b3e-9f1a-3c8d6e2b7a40"],"isRequired":true,"uniqueKey":"agents.items.[INDEX].connectors.items.[INDEX].oneOf.2.agentId","typeLabel":"string\u003cagent-id>"},"enabled":{"type":"boolean","default":true,"description":"Whether the connector is active for invocations. Only `schema` connectors return this field today; `mcp`, `registry`, `agent`, and `a2a` connectors omit it (treat as enabled). ","uniqueKey":"agents.items.[INDEX].connectors.items.[INDEX].oneOf.2.enabled","typeLabel":"boolean"},"auth":{"type":"object","description":"Authentication configuration.","required":["type"],"properties":{"type":{"type":"string","enum":["none","bearer","apiKey","oauth2","inherit"],"description":"Authentication mechanism.\n`inherit` forwards the caller's bearer token to the MCP server,\nwhich is required for internal MCP gateways that expect the\nCorti platform token for auth.\n","isRequired":true,"uniqueKey":"agents.items.[INDEX].connectors.items.[INDEX].oneOf.2.auth.type","typeLabel":"enum\u003cstring>"},"scope":{"type":"string","description":"OAuth2 scope requested.","uniqueKey":"agents.items.[INDEX].connectors.items.[INDEX].oneOf.2.auth.scope","typeLabel":"string"},"tokenUrl":{"type":"string","format":"uri","description":"Token URL override for the OAuth2.0 token endpoint.","uniqueKey":"agents.items.[INDEX].connectors.items.[INDEX].oneOf.2.auth.tokenUrl","typeLabel":"string\u003curi>"},"ref":{"type":"string","description":"Reference to a server-side stored secret. Mutually exclusive with inline credentials passed at call time.","uniqueKey":"agents.items.[INDEX].connectors.items.[INDEX].oneOf.2.auth.ref","typeLabel":"string"},"requiredHeaders":{"type":"array","items":{"type":"string","uniqueKey":"agents.items.[INDEX].connectors.items.[INDEX].oneOf.2.auth.requiredHeaders.items.[INDEX]","typeLabel":"string"},"description":"Header names the MCP server requires the client to send in the authorization data part. The client must supply values for each listed name; missing headers trigger an auth-required challenge that lists them.\n","uniqueKey":"agents.items.[INDEX].connectors.items.[INDEX].oneOf.2.auth.requiredHeaders","typeLabel":"string[]"},"optionalHeaders":{"type":"array","items":{"type":"string","uniqueKey":"agents.items.[INDEX].connectors.items.[INDEX].oneOf.2.auth.optionalHeaders.items.[INDEX]","typeLabel":"string"},"description":"Header names the client may optionally send. Headers not in requiredHeaders or optionalHeaders are rejected as undeclared.\n","uniqueKey":"agents.items.[INDEX].connectors.items.[INDEX].oneOf.2.auth.optionalHeaders","typeLabel":"string[]"}},"additionalProperties":false,"examples":[{"type":"oauth2","scope":"read:policies","tokenUrl":"https://app.corti.ai/oauth/token"}],"uniqueKey":"agents.items.[INDEX].connectors.items.[INDEX].oneOf.2.auth","typeLabel":"object"}},"uniqueKey":"agents.items.[INDEX].connectors.items.[INDEX].oneOf.2","typeLabel":"object"},{"type":"object","description":"A connector attached to an agent, discriminated by `type`.","required":["url","id","type"],"properties":{"id":{"type":"string","format":"connector-id","description":"Server-generated connector identifier (prefixed UUIDv7). Stable across PATCH\nreplacements where the underlying spec is unchanged. Used by\nobservability/HITL to reference a connector unambiguously.\n","pattern":"^(con\\.)?[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$","examples":["con.0192f4c8-7baf-7083-a46f-81d2bd70cf95"],"readOnly":true,"isRequired":true,"uniqueKey":"agents.items.[INDEX].connectors.items.[INDEX].oneOf.3.id","typeLabel":"string\u003cconnector-id>"},"type":{"type":"string","description":"Connector discriminator; always `a2a`.","enum":["registry","mcp","agent","a2a","schema"],"const":"a2a","isRequired":true,"uniqueKey":"agents.items.[INDEX].connectors.items.[INDEX].oneOf.3.type","typeLabel":"enum\u003cstring>"},"url":{"type":"string","format":"uri","description":"The remote agent's A2A endpoint (typically a `.well-known/agent-card.json`).","examples":["https://marginalia.polycode.co.uk/.well-known/agent-card.json"],"isRequired":true,"uniqueKey":"agents.items.[INDEX].connectors.items.[INDEX].oneOf.3.url","typeLabel":"string\u003curi>"},"enabled":{"type":"boolean","default":true,"description":"Whether the connector is active for invocations. Only `schema` connectors return this field today; `mcp`, `registry`, `agent`, and `a2a` connectors omit it (treat as enabled). ","uniqueKey":"agents.items.[INDEX].connectors.items.[INDEX].oneOf.3.enabled","typeLabel":"boolean"},"auth":{"type":"object","description":"Authentication configuration.","required":["type"],"properties":{"type":{"type":"string","enum":["none","bearer","apiKey","oauth2","inherit"],"description":"Authentication mechanism.\n`inherit` forwards the caller's bearer token to the MCP server,\nwhich is required for internal MCP gateways that expect the\nCorti platform token for auth.\n","isRequired":true,"uniqueKey":"agents.items.[INDEX].connectors.items.[INDEX].oneOf.3.auth.type","typeLabel":"enum\u003cstring>"},"scope":{"type":"string","description":"OAuth2 scope requested.","uniqueKey":"agents.items.[INDEX].connectors.items.[INDEX].oneOf.3.auth.scope","typeLabel":"string"},"tokenUrl":{"type":"string","format":"uri","description":"Token URL override for the OAuth2.0 token endpoint.","uniqueKey":"agents.items.[INDEX].connectors.items.[INDEX].oneOf.3.auth.tokenUrl","typeLabel":"string\u003curi>"},"ref":{"type":"string","description":"Reference to a server-side stored secret. Mutually exclusive with inline credentials passed at call time.","uniqueKey":"agents.items.[INDEX].connectors.items.[INDEX].oneOf.3.auth.ref","typeLabel":"string"},"requiredHeaders":{"type":"array","items":{"type":"string","uniqueKey":"agents.items.[INDEX].connectors.items.[INDEX].oneOf.3.auth.requiredHeaders.items.[INDEX]","typeLabel":"string"},"description":"Header names the MCP server requires the client to send in the authorization data part. The client must supply values for each listed name; missing headers trigger an auth-required challenge that lists them.\n","uniqueKey":"agents.items.[INDEX].connectors.items.[INDEX].oneOf.3.auth.requiredHeaders","typeLabel":"string[]"},"optionalHeaders":{"type":"array","items":{"type":"string","uniqueKey":"agents.items.[INDEX].connectors.items.[INDEX].oneOf.3.auth.optionalHeaders.items.[INDEX]","typeLabel":"string"},"description":"Header names the client may optionally send. Headers not in requiredHeaders or optionalHeaders are rejected as undeclared.\n","uniqueKey":"agents.items.[INDEX].connectors.items.[INDEX].oneOf.3.auth.optionalHeaders","typeLabel":"string[]"}},"additionalProperties":false,"examples":[{"type":"oauth2","scope":"read:policies","tokenUrl":"https://app.corti.ai/oauth/token"}],"uniqueKey":"agents.items.[INDEX].connectors.items.[INDEX].oneOf.3.auth","typeLabel":"object"},"name":{"type":"string","description":"Optional display name for the remote A2A agent.","uniqueKey":"agents.items.[INDEX].connectors.items.[INDEX].oneOf.3.name","typeLabel":"string"}},"uniqueKey":"agents.items.[INDEX].connectors.items.[INDEX].oneOf.3","typeLabel":"object"},{"type":"object","description":"A connector attached to an agent, discriminated by `type`.","required":["name","schema","id","type"],"properties":{"id":{"type":"string","format":"connector-id","description":"Server-generated connector identifier (prefixed UUIDv7). Stable across PATCH\nreplacements where the underlying spec is unchanged. Used by\nobservability/HITL to reference a connector unambiguously.\n","pattern":"^(con\\.)?[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$","examples":["con.0192f4c8-7baf-7083-a46f-81d2bd70cf95"],"readOnly":true,"isRequired":true,"uniqueKey":"agents.items.[INDEX].connectors.items.[INDEX].oneOf.4.id","typeLabel":"string\u003cconnector-id>"},"type":{"type":"string","description":"Connector discriminator; always `schema`.","enum":["registry","mcp","agent","a2a","schema"],"const":"schema","isRequired":true,"uniqueKey":"agents.items.[INDEX].connectors.items.[INDEX].oneOf.4.type","typeLabel":"enum\u003cstring>"},"name":{"type":"string","description":"Schema connector name. Used as the tool name the LLM calls.","isRequired":true,"uniqueKey":"agents.items.[INDEX].connectors.items.[INDEX].oneOf.4.name","typeLabel":"string"},"schema":{"type":"object","description":"JSON Schema defining the tool's output shape.","additionalProperties":true,"isRequired":true,"uniqueKey":"agents.items.[INDEX].connectors.items.[INDEX].oneOf.4.schema","typeLabel":"object"},"enabled":{"type":"boolean","default":true,"description":"Whether the connector is active for invocations. Only `schema` connectors return this field today; `mcp`, `registry`, `agent`, and `a2a` connectors omit it (treat as enabled). ","uniqueKey":"agents.items.[INDEX].connectors.items.[INDEX].oneOf.4.enabled","typeLabel":"boolean"},"auth":{"type":"object","description":"Authentication configuration.","required":["type"],"properties":{"type":{"type":"string","enum":["none","bearer","apiKey","oauth2","inherit"],"description":"Authentication mechanism.\n`inherit` forwards the caller's bearer token to the MCP server,\nwhich is required for internal MCP gateways that expect the\nCorti platform token for auth.\n","isRequired":true,"uniqueKey":"agents.items.[INDEX].connectors.items.[INDEX].oneOf.4.auth.type","typeLabel":"enum\u003cstring>"},"scope":{"type":"string","description":"OAuth2 scope requested.","uniqueKey":"agents.items.[INDEX].connectors.items.[INDEX].oneOf.4.auth.scope","typeLabel":"string"},"tokenUrl":{"type":"string","format":"uri","description":"Token URL override for the OAuth2.0 token endpoint.","uniqueKey":"agents.items.[INDEX].connectors.items.[INDEX].oneOf.4.auth.tokenUrl","typeLabel":"string\u003curi>"},"ref":{"type":"string","description":"Reference to a server-side stored secret. Mutually exclusive with inline credentials passed at call time.","uniqueKey":"agents.items.[INDEX].connectors.items.[INDEX].oneOf.4.auth.ref","typeLabel":"string"},"requiredHeaders":{"type":"array","items":{"type":"string","uniqueKey":"agents.items.[INDEX].connectors.items.[INDEX].oneOf.4.auth.requiredHeaders.items.[INDEX]","typeLabel":"string"},"description":"Header names the MCP server requires the client to send in the authorization data part. The client must supply values for each listed name; missing headers trigger an auth-required challenge that lists them.\n","uniqueKey":"agents.items.[INDEX].connectors.items.[INDEX].oneOf.4.auth.requiredHeaders","typeLabel":"string[]"},"optionalHeaders":{"type":"array","items":{"type":"string","uniqueKey":"agents.items.[INDEX].connectors.items.[INDEX].oneOf.4.auth.optionalHeaders.items.[INDEX]","typeLabel":"string"},"description":"Header names the client may optionally send. Headers not in requiredHeaders or optionalHeaders are rejected as undeclared.\n","uniqueKey":"agents.items.[INDEX].connectors.items.[INDEX].oneOf.4.auth.optionalHeaders","typeLabel":"string[]"}},"additionalProperties":false,"examples":[{"type":"oauth2","scope":"read:policies","tokenUrl":"https://app.corti.ai/oauth/token"}],"uniqueKey":"agents.items.[INDEX].connectors.items.[INDEX].oneOf.4.auth","typeLabel":"object"},"description":{"type":"string","description":"What the tool does. Read by the LLM to decide when to call it.","uniqueKey":"agents.items.[INDEX].connectors.items.[INDEX].oneOf.4.description","typeLabel":"string"},"transition":{"type":"string","enum":["complete","input_required","send"],"description":"If set, `complete`/`input_required` terminate the loop in that state after validating and storing the data part (no further LLM call). `send` is non-terminal: it validates and stores the data part, delivers it to the user as a data part, and continues the loop.","uniqueKey":"agents.items.[INDEX].connectors.items.[INDEX].oneOf.4.transition","typeLabel":"enum\u003cstring>"}},"uniqueKey":"agents.items.[INDEX].connectors.items.[INDEX].oneOf.4","typeLabel":"object"}],"uniqueKey":"agents.items.[INDEX].connectors.items.[INDEX]","typeLabel":"object"},"description":"Connectors attached to the agent, discriminated by `type`.","isRequired":true,"uniqueKey":"agents.items.[INDEX].connectors","typeLabel":"object[]"},"createdAt":{"type":"string","format":"date-time","readOnly":true,"description":"When the agent was created.","isRequired":true,"uniqueKey":"agents.items.[INDEX].createdAt","typeLabel":"string\u003cdate-time>"},"updatedAt":{"type":"string","format":"date-time","readOnly":true,"description":"When the agent was last updated.","isRequired":true,"uniqueKey":"agents.items.[INDEX].updatedAt","typeLabel":"string\u003cdate-time>"},"createdBy":{"type":"string","format":"user-id","description":"Principal (user or service principal) that created the agent.","pattern":"^(usr\\.)?[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$","examples":["usr.0192f4c8-8bc0-7194-8570-92e3ce81d0a6"],"readOnly":true,"isRequired":true,"uniqueKey":"agents.items.[INDEX].createdBy","typeLabel":"string\u003cuser-id>"},"description":{"oneOf":[{"type":"string","maxLength":4096,"description":"Free-form agent description shown to users and in tooling.","uniqueKey":"agents.items.[INDEX].description.oneOf.0","typeLabel":"string"},{"type":"null","maxLength":4096,"description":"Free-form agent description shown to users and in tooling.","uniqueKey":"agents.items.[INDEX].description.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.items.[INDEX].description","typeLabel":"string | null"},"systemPrompt":{"oneOf":[{"type":"string","description":"System prompt prepended to every invocation.","uniqueKey":"agents.items.[INDEX].systemPrompt.oneOf.0","typeLabel":"string"},{"type":"null","description":"System prompt prepended to every invocation.","uniqueKey":"agents.items.[INDEX].systemPrompt.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.items.[INDEX].systemPrompt","typeLabel":"string | null"},"model":{"oneOf":[{"type":"string","description":"Model identifier. Tenant default if omitted or `null`.\n**Open question** — in the current implementation a model is configured per *expert*, not per *agent* (`Expert.modelName`), and an `Agent` has no model field at all. The desired end state is that there is **no distinction between an expert and an agent**, so `model` lives uniformly on this resource. Until that convergence lands, the precedence of an agent-level `model` over a connector/expert-level override is undecided and MUST be resolved before this field ships. ","examples":["corti-default"],"x-open-question":"expert-vs-agent-model-placement","uniqueKey":"agents.items.[INDEX].model.oneOf.0","typeLabel":"string"},{"type":"null","description":"Model identifier. Tenant default if omitted or `null`.\n**Open question** — in the current implementation a model is configured per *expert*, not per *agent* (`Expert.modelName`), and an `Agent` has no model field at all. The desired end state is that there is **no distinction between an expert and an agent**, so `model` lives uniformly on this resource. Until that convergence lands, the precedence of an agent-level `model` over a connector/expert-level override is undecided and MUST be resolved before this field ships. ","examples":["corti-default"],"x-open-question":"expert-vs-agent-model-placement","uniqueKey":"agents.items.[INDEX].model.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.items.[INDEX].model","typeLabel":"string | null"},"labels":{"type":"object","description":"Free-form `string → string` metadata for filtering and organisation. Not used for routing or auth.","additionalProperties":{"type":"string","maxLength":256,"uniqueKey":"agents.items.[INDEX].labels.additionalProperties","typeLabel":"string"},"propertyNames":{"type":"string","pattern":"^[a-zA-Z0-9._/-]{1,128}$"},"maxProperties":64,"examples":[{"team":"coding","env":"prod"}],"uniqueKey":"agents.items.[INDEX].labels","typeLabel":"object"},"expiresAt":{"oneOf":[{"type":"string","format":"date-time","readOnly":true,"description":"When the agent expires; `null` means it does not expire. Ephemeral agents get a 24h expiry at creation time; persistent agents never expire.","uniqueKey":"agents.items.[INDEX].expiresAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","readOnly":true,"description":"When the agent expires; `null` means it does not expire. Ephemeral agents get a 24h expiry at creation time; persistent agents never expire.","uniqueKey":"agents.items.[INDEX].expiresAt.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.items.[INDEX].expiresAt","typeLabel":"string\u003cdate-time> | null"}},"examples":[{"id":"agt.0192f4c8-2c5a-7b3e-9f1a-3c8d6e2b7a40","name":"coder","description":"Returns ICD-10 codes for a clinical encounter.","systemPrompt":"Respond with only the ICD-10 code.","model":"corti-default","maxLoops":10,"visibility":"private","lifecycle":"persistent","connectors":[{"id":"con.0192f4c8-7baf-7083-a46f-81d2bd70cf95","type":"registry","name":"pubmed-expert"}],"labels":{"team":"coding","env":"prod"},"createdAt":"2026-05-19T12:00:00Z","updatedAt":"2026-05-19T12:00:00Z","createdBy":"usr.0192f4c8-8bc0-7194-8570-92e3ce81d0a6","expiresAt":null}],"uniqueKey":"agents.items.[INDEX]","typeLabel":"object"},"description":"Agents on the current page.","examples":[[{"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"}]],"isRequired":true,"uniqueKey":"agents","typeLabel":"object[]"},"nextPageToken":{"oneOf":[{"type":"string","description":"Opaque cursor to request the next page, or `null` if there are no more pages.","uniqueKey":"nextPageToken.oneOf.0","typeLabel":"string"},{"type":"null","description":"Opaque cursor to request the next page, or `null` if there are no more pages.","uniqueKey":"nextPageToken.oneOf.1","typeLabel":"null"}],"uniqueKey":"nextPageToken","typeLabel":"string | null"},"totalSize":{"type":"integer","description":"Total number of items matching the query, when known. Not currently populated by the server; treat as absent.","example":42,"uniqueKey":"totalSize","typeLabel":"integer"}},"uniqueKey":"","typeLabel":"object"},"example":{"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":[]}]},"examples":{"Example":{"title":"Example","value":{"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":[]}]}}},"exampleType":"examples"}},"exampleType":"examples"},"a6774223-7b1f-4559-9077-0a2202e3cbed":{"description":"The request was malformed.","content":{"application/json":{"schema":{"type":"object","description":"Corti management-plane error envelope, used by all non-A2A endpoints.\n\n- **Standard** — when the error chain contains at least one `PublicError`,\n `code` and `message` come from the outermost `PublicError` and `details`\n is merged across the whole chain (outer values take precedence).\n- **Fallback** — when the chain contains no `PublicError`, the response is\n a generic `500` carrying a `requestId` for support reference.\n- **Validation** — a single `PublicError` whose `details.validationErrors`\n lists the offending fields.\n\nField names use camelCase on the wire (e.g. `requestId`, `howToFix`).\nThe free-form `details` object may carry arbitrary caller-defined keys.\n\nRate limiting (HTTP 429) is not yet implemented; the server does not emit a 429 response.\n","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"Stable, machine-readable, SCREAMING_SNAKE_CASE error code.","examples":["ASSIGNMENT_CONFLICT","VALIDATION_FAILED","INTERNAL_ERROR"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable explanation.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"howToFix":{"type":"string","description":"Optional guidance for the caller to resolve the error.","uniqueKey":"error.howToFix","typeLabel":"string"},"details":{"type":"object","description":"Structured context, merged from every `PublicError` in the chain\n(outer values win). Omitted on the generic fallback response.\n","additionalProperties":true,"properties":{"validationErrors":{"type":"array","description":"Present when `code` is `VALIDATION_FAILED`.","items":{"type":"object","required":["field","reason"],"properties":{"field":{"type":"string","description":"The field that failed validation.","isRequired":true,"uniqueKey":"error.details.validationErrors.items.[INDEX].field","typeLabel":"string"},"reason":{"type":"string","description":"Why the field failed validation.","isRequired":true,"uniqueKey":"error.details.validationErrors.items.[INDEX].reason","typeLabel":"string"}},"uniqueKey":"error.details.validationErrors.items.[INDEX]","typeLabel":"object"},"uniqueKey":"error.details.validationErrors","typeLabel":"object[]"}},"uniqueKey":"error.details","typeLabel":"object"},"requestId":{"type":"string","description":"Correlation ID from request middleware. Included only on the\ngeneric `500` fallback so consumers can quote it in support requests.\n","uniqueKey":"error.requestId","typeLabel":"string"}},"description":"The error object with code, message, and optional details.","isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"examples":[{"error":{"code":"ASSIGNMENT_CONFLICT","message":"could not complete assignment","details":{"assignment_id":"asg_99","expert_id":"exp_42"}}},{"error":{"code":"VALIDATION_FAILED","message":"validation failed","details":{"validationErrors":[{"field":"email","reason":"invalid format"},{"field":"name","reason":"required"}]}}},{"error":{"code":"INTERNAL_ERROR","message":"internal server error","requestId":"req_abc123"}}],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"ASSIGNMENT_CONFLICT","message":"could not complete assignment","details":{"assignment_id":"asg_99","expert_id":"exp_42"}}}}},"exampleType":"generated"}},"exampleType":"generated"},"4f5a4d52-9ed9-4238-bfdf-1a613b3bd40b":{"description":"Missing or invalid credentials.","content":{"application/json":{"schema":{"type":"object","description":"Corti management-plane error envelope, used by all non-A2A endpoints.\n\n- **Standard** — when the error chain contains at least one `PublicError`,\n `code` and `message` come from the outermost `PublicError` and `details`\n is merged across the whole chain (outer values take precedence).\n- **Fallback** — when the chain contains no `PublicError`, the response is\n a generic `500` carrying a `requestId` for support reference.\n- **Validation** — a single `PublicError` whose `details.validationErrors`\n lists the offending fields.\n\nField names use camelCase on the wire (e.g. `requestId`, `howToFix`).\nThe free-form `details` object may carry arbitrary caller-defined keys.\n\nRate limiting (HTTP 429) is not yet implemented; the server does not emit a 429 response.\n","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"Stable, machine-readable, SCREAMING_SNAKE_CASE error code.","examples":["ASSIGNMENT_CONFLICT","VALIDATION_FAILED","INTERNAL_ERROR"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable explanation.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"howToFix":{"type":"string","description":"Optional guidance for the caller to resolve the error.","uniqueKey":"error.howToFix","typeLabel":"string"},"details":{"type":"object","description":"Structured context, merged from every `PublicError` in the chain\n(outer values win). Omitted on the generic fallback response.\n","additionalProperties":true,"properties":{"validationErrors":{"type":"array","description":"Present when `code` is `VALIDATION_FAILED`.","items":{"type":"object","required":["field","reason"],"properties":{"field":{"type":"string","description":"The field that failed validation.","isRequired":true,"uniqueKey":"error.details.validationErrors.items.[INDEX].field","typeLabel":"string"},"reason":{"type":"string","description":"Why the field failed validation.","isRequired":true,"uniqueKey":"error.details.validationErrors.items.[INDEX].reason","typeLabel":"string"}},"uniqueKey":"error.details.validationErrors.items.[INDEX]","typeLabel":"object"},"uniqueKey":"error.details.validationErrors","typeLabel":"object[]"}},"uniqueKey":"error.details","typeLabel":"object"},"requestId":{"type":"string","description":"Correlation ID from request middleware. Included only on the\ngeneric `500` fallback so consumers can quote it in support requests.\n","uniqueKey":"error.requestId","typeLabel":"string"}},"description":"The error object with code, message, and optional details.","isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"examples":[{"error":{"code":"ASSIGNMENT_CONFLICT","message":"could not complete assignment","details":{"assignment_id":"asg_99","expert_id":"exp_42"}}},{"error":{"code":"VALIDATION_FAILED","message":"validation failed","details":{"validationErrors":[{"field":"email","reason":"invalid format"},{"field":"name","reason":"required"}]}}},{"error":{"code":"INTERNAL_ERROR","message":"internal server error","requestId":"req_abc123"}}],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"ASSIGNMENT_CONFLICT","message":"could not complete assignment","details":{"assignment_id":"asg_99","expert_id":"exp_42"}}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"f25353c6-49cd-445f-ab1b-ce71788a1457":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"OAuth 2.0 / OIDC bearer token.","scopes":[],"schemeName":"bearerAuth"},"tenantHeader":{"type":"apiKey","in":"header","name":"Tenant-Name","description":"The tenant the request operates within.","scopes":[],"schemeName":"tenantHeader"}}},"servers":{"ce2bc9db-751e-40c4-9602-b295cd851c23":{"url":"https://api.{environment}.corti.app/v2/","description":"Corti regional API gateway","variables":{"environment":{"default":"eu","enum":["eu","us"],"description":"Deployment region."}}}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"OAuth 2.0 / OIDC bearer token.","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"OAuth 2.0 / OIDC bearer token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"},{"scheme":{"type":"apiKey","in":"header","name":"Tenant-Name","description":"The tenant the request operates within.","scopes":[],"schemeName":"tenantHeader"},"schema":{"title":"Tenant-Name","type":"string","description":"The tenant the request operates within.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"tenantHeader","name":"Tenant-Name"}],"title":"bearerAuth \u0026 tenantHeader"}]},"originalFileLocation":"agentic/auto-generated-openapi-v2.yml"},"subdomain":"corti","siteName":"Corti API Documentation","title":"List agents - Corti API Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-29T15:15:01.971Z","originalFileLocation":"agentic-v2/agents/list-agents.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Lists agents visible to the caller. private agents are visible only to their creator/service principal; unlisted agents are omitted (fetch by ID instead); public agents are listed tenant-wide. The visibility, lifecycle, label, and q filter parameters are accepted but not yet honored by the server; the response is unfiltered.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Corti API Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/corti/gI_ok5T7zaR8y4z1/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/corti/gI_ok5T7zaR8y4z1/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/corti/gI_ok5T7zaR8y4z1/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/corti/gI_ok5T7zaR8y4z1/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/corti/gI_ok5T7zaR8y4z1/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/corti/gI_ok5T7zaR8y4z1/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/corti/gI_ok5T7zaR8y4z1/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/corti/gI_ok5T7zaR8y4z1/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/corti/gI_ok5T7zaR8y4z1/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"List agents - Corti API Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Lists agents visible to the caller. private agents are visible only to their creator/service principal; unlisted agents are omitted (fetch by ID instead); public agents are listed tenant-wide. The visibility, lifecycle, label, and q filter parameters are accepted but not yet honored by the server; the response is unfiltered.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Corti API Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.corti.ai/agentic-v2/agents/list-agents\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://corti.mintlify.site/_mintlify/api/og/v2?division=Agents\u0026amp;title=List+agents\u0026amp;description=Lists+agents+visible+to+the+caller.+%60private%60+agents+are+visible+only+to%0Atheir+creator%2Fservice+principal%3B+%60unlisted%60+agents+are+omitted+%28fetch+by%0AID+instead%29%3B+%60\u0026amp;theme=34b80329efcd2beff359af85\u0026amp;signature=a123f3f57f173b28f15861c9022089219b33e00fb09b2eec3fe4e4e31dd1510b\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"List agents - Corti API Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Lists agents visible to the caller. private agents are visible only to their creator/service principal; unlisted agents are omitted (fetch by ID instead); public agents are listed tenant-wide. The visibility, lifecycle, label, and q filter parameters are accepted but not yet honored by the server; the response is unfiltered.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://corti.mintlify.site/_mintlify/api/og/v2?division=Agents\u0026amp;title=List+agents\u0026amp;description=Lists+agents+visible+to+the+caller.+%60private%60+agents+are+visible+only+to%0Atheir+creator%2Fservice+principal%3B+%60unlisted%60+agents+are+omitted+%28fetch+by%0AID+instead%29%3B+%60\u0026amp;theme=34b80329efcd2beff359af85\u0026amp;signature=a123f3f57f173b28f15861c9022089219b33e00fb09b2eec3fe4e4e31dd1510b\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/corti/gI_ok5T7zaR8y4z1/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Corti API Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#3F3F46\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.corti.ai/agentic-v2/agents/list-agents\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/agentic-v2/agents/list-agents.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.corti.ai/#organization\",\"name\":\"Corti API Documentation\",\"url\":\"https://docs.corti.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/corti/en_RPjQCFb1qJpbU/logo/corti_light.svg?fit=max\u0026auto=format\u0026n=en_RPjQCFb1qJpbU\u0026q=85\u0026s=effbca890e531e034f6b66ce8e15aa6c\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.corti.ai#website\",\"name\":\"Corti API Documentation\",\"url\":\"https://docs.corti.ai\",\"publisher\":{\"@id\":\"https://docs.corti.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.corti.ai/agentic-v2/agents/list-agents#webpage\",\"url\":\"https://docs.corti.ai/agentic-v2/agents/list-agents\",\"name\":\"List agents\",\"description\":\"Lists agents visible to the caller. private agents are visible only to their creator/service principal; unlisted agents are omitted (fetch by ID instead); public agents are listed tenant-wide. The visibility, lifecycle, label, and q filter parameters are accepted but not yet honored by the server; the response is unfiltered.\",\"dateModified\":\"2026-10-29T15:15:01.971Z\",\"isPartOf\":{\"@id\":\"https://docs.corti.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.corti.ai/agentic-v2/agents/list-agents#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.corti.ai/agentic-v2/agents/list-agents#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Corti API Documentation\",\"item\":\"https://docs.corti.ai\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"List agents\",\"item\":\"https://docs.corti.ai/agentic-v2/agents/list-agents\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.corti.ai/agentic-v2/agents/list-agents#apireference\",\"headline\":\"List agents\",\"name\":\"List agents\",\"description\":\"Lists agents visible to the caller. private agents are visible only to their creator/service principal; unlisted agents are omitted (fetch by ID instead); public agents are listed tenant-wide. The visibility, lifecycle, label, and q filter parameters are accepted but not yet honored by the server; the response is unfiltered.\",\"url\":\"https://docs.corti.ai/agentic-v2/agents/list-agents\",\"mainEntityOfPage\":{\"@id\":\"https://docs.corti.ai/agentic-v2/agents/list-agents#webpage\"},\"dateModified\":\"2026-10-29T15:15:01.971Z\",\"publisher\":{\"@id\":\"https://docs.corti.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.corti.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Corti API Documentation\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Corti API Documentation","nav":{"global":null,"tabs":[{"tab":"Home","icon":"house","pages":[{"title":"Home","href":"/get_started/welcome"}]},{"tab":"Corti Models","icon":"microchip","pages":[{"title":"Corti Models","href":"/models/welcome"}]},{"tab":"Agentic Framework","icon":"layers","pages":[{"title":"Agentic Framework","href":"/agentic/overview"}]},{"tab":"Speech to Text","icon":"audio-lines","pages":[{"title":"Speech to Text","href":"/stt/overview"}]},{"tab":"Healthcare","icon":"heart-pulse","pages":[{"title":"Healthcare","href":"/healthcare"}]},{"tab":"API Reference","icon":"square-code","pages":[{"title":"Welcome to the Corti API Reference","sidebarTitle":"Welcome","mode":"wide","href":"/api-reference/welcome"},{"group":"Corti Models APIs","icon":"microchip","pages":[{"group":"Models","pages":[{"title":"List available models","deprecated":null,"version":null,"openapi":"/api-reference/corti-models/corti-models-openapi.yml get /v1/models","href":"/api-reference/corti-models/models/list-available-models"}]},{"group":"Chat","pages":[{"title":"Create chat completion","deprecated":null,"version":null,"openapi":"/api-reference/corti-models/corti-models-openapi.yml post /v1/chat/completions","href":"/api-reference/corti-models/chat/create-chat-completion"}]},{"group":"Completions","pages":[{"title":"Create completion","deprecated":null,"version":null,"openapi":"/api-reference/corti-models/corti-models-openapi.yml post /v1/completions","href":"/api-reference/corti-models/completions/create-completion"}]},{"group":"Responses","pages":[{"title":"Create response","deprecated":null,"version":null,"openapi":"/api-reference/corti-models/corti-models-openapi.yml post /v1/responses","href":"/api-reference/corti-models/responses/create-response"}]},{"group":"Anthropic","pages":[{"title":"Create message (Anthropic)","deprecated":null,"version":null,"openapi":"/api-reference/corti-models/corti-models-openapi.yml post /anthropic/v1/messages","href":"/api-reference/corti-models/anthropic/create-message-anthropic"}]},{"group":"Embeddings","pages":[{"title":"Create embeddings","description":"Creates embeddings for the given input text.\n","deprecated":null,"version":null,"openapi":"/api-reference/corti-models/corti-models-openapi.yml post /v1/embeddings","href":"/api-reference/corti-models/embeddings/create-embeddings"}]}]},{"group":"Agentic APIs","icon":"layers","pages":[{"group":"Agents","pages":[{"title":"List agents","deprecated":null,"version":null,"openapi":"/agentic/auto-generated-openapi-v2.yml get /agentic/agents","href":"/agentic-v2/agents/list-agents"},{"title":"Create an agent","description":"Creates a new agent. The server assigns the UUIDv7 `id`.","deprecated":null,"version":null,"openapi":"/agentic/auto-generated-openapi-v2.yml post /agentic/agents","href":"/agentic-v2/agents/create-an-agent"},{"title":"Get an agent","deprecated":null,"version":null,"openapi":"/agentic/auto-generated-openapi-v2.yml get /agentic/agents/{agentId}","href":"/agentic-v2/agents/get-an-agent"},{"title":"Delete an agent","deprecated":null,"version":null,"openapi":"/agentic/auto-generated-openapi-v2.yml delete /agentic/agents/{agentId}","href":"/agentic-v2/agents/delete-an-agent"},{"title":"Update an agent (partial)","deprecated":null,"version":null,"openapi":"/agentic/auto-generated-openapi-v2.yml patch /agentic/agents/{agentId}","href":"/agentic-v2/agents/update-an-agent-partial"}]},{"group":"Agent Card","pages":[{"title":"Get the A2A agent card","deprecated":null,"version":null,"openapi":"/agentic/auto-generated-openapi-v2.yml get /agentic/agents/{agentId}/.well-known/agent-card.json","href":"/agentic-v2/agent-card/get-the-a2a-agent-card"}]},{"group":"A2A","pages":[{"title":"A2A JSON-RPC binding","deprecated":null,"version":null,"openapi":"/agentic/auto-generated-openapi-v2.yml post /agentic/agents/{agentId}/a2a","href":"/agentic-v2/a2a/a2a-json-rpc-binding"},{"title":"Send a message (A2A REST)","deprecated":null,"version":null,"openapi":"/agentic/auto-generated-openapi-v2.yml post /agentic/agents/{agentId}/a2a/message:send","href":"/agentic-v2/a2a/send-a-message-a2a-rest"},{"title":"Stream a message (A2A REST)","deprecated":null,"version":null,"openapi":"/agentic/auto-generated-openapi-v2.yml post /agentic/agents/{agentId}/a2a/message:stream","href":"/agentic-v2/a2a/stream-a-message-a2a-rest"},{"title":"List tasks (A2A REST)","deprecated":null,"version":null,"openapi":"/agentic/auto-generated-openapi-v2.yml get /agentic/agents/{agentId}/a2a/tasks","href":"/agentic-v2/a2a/list-tasks-a2a-rest"},{"title":"Get a task (A2A REST)","deprecated":null,"version":null,"openapi":"/agentic/auto-generated-openapi-v2.yml get /agentic/agents/{agentId}/a2a/tasks/{taskId}","href":"/agentic-v2/a2a/get-a-task-a2a-rest"},{"title":"Cancel a task (A2A REST)","deprecated":null,"version":null,"openapi":"/agentic/auto-generated-openapi-v2.yml post /agentic/agents/{agentId}/a2a/tasks/{taskId}:cancel","href":"/agentic-v2/a2a/cancel-a-task-a2a-rest"},{"title":"Subscribe to task events (A2A REST)","deprecated":null,"version":null,"openapi":"/agentic/auto-generated-openapi-v2.yml post /agentic/agents/{agentId}/a2a/tasks/{taskId}:subscribe","href":"/agentic-v2/a2a/subscribe-to-task-events-a2a-rest"}]},{"group":"Usage","pages":[{"title":"Get an agent's usage","deprecated":null,"version":null,"openapi":"/agentic/auto-generated-openapi-v2.yml get /agentic/agents/{agentId}/usage","href":"/agentic-v2/usage/get-an-agents-usage"}]},{"group":"Connectors","pages":[{"title":"List an agent's connectors","deprecated":null,"version":null,"openapi":"/agentic/auto-generated-openapi-v2.yml get /agentic/agents/{agentId}/connectors","href":"/agentic-v2/connectors/list-an-agents-connectors"},{"title":"Attach a connector","deprecated":null,"version":null,"openapi":"/agentic/auto-generated-openapi-v2.yml post /agentic/agents/{agentId}/connectors","href":"/agentic-v2/connectors/attach-a-connector"},{"title":"Get an agent-scoped connector","deprecated":null,"version":null,"openapi":"/agentic/auto-generated-openapi-v2.yml get /agentic/agents/{agentId}/connectors/{agentConnectorId}","href":"/agentic-v2/connectors/get-an-agent-scoped-connector"},{"title":"Remove a connector","deprecated":null,"version":null,"openapi":"/agentic/auto-generated-openapi-v2.yml delete /agentic/agents/{agentId}/connectors/{agentConnectorId}","href":"/agentic-v2/connectors/remove-a-connector"},{"title":"Update an agent-scoped connector (partial)","deprecated":null,"version":null,"openapi":"/agentic/auto-generated-openapi-v2.yml patch /agentic/agents/{agentId}/connectors/{agentConnectorId}","href":"/agentic-v2/connectors/update-an-agent-scoped-connector-partial"}]},{"group":"Contexts","pages":[{"title":"List contexts","deprecated":null,"version":null,"openapi":"/agentic/auto-generated-openapi-v2.yml get /agentic/contexts","href":"/agentic-v2/contexts/list-contexts"},{"title":"Get a context","deprecated":null,"version":null,"openapi":"/agentic/auto-generated-openapi-v2.yml get /agentic/contexts/{contextId}","href":"/agentic-v2/contexts/get-a-context"},{"title":"Delete or expire a context","deprecated":null,"version":null,"openapi":"/agentic/auto-generated-openapi-v2.yml delete /agentic/contexts/{contextId}","href":"/agentic-v2/contexts/delete-or-expire-a-context"},{"title":"Export the observability trace for a context","deprecated":null,"version":null,"openapi":"/agentic/auto-generated-openapi-v2.yml get /agentic/contexts/{contextId}/trace","href":"/agentic-v2/contexts/export-the-observability-trace-for-a-context"},{"title":"List tasks within a context","deprecated":null,"version":null,"openapi":"/agentic/auto-generated-openapi-v2.yml get /agentic/contexts/{contextId}/tasks","href":"/agentic-v2/contexts/list-tasks-within-a-context"},{"title":"Get a task within a context","deprecated":null,"version":null,"openapi":"/agentic/auto-generated-openapi-v2.yml get /agentic/contexts/{contextId}/tasks/{taskId}","href":"/agentic-v2/contexts/get-a-task-within-a-context"}]},{"group":"Artifacts","pages":[{"title":"Get an artifact","deprecated":null,"version":null,"openapi":"/agentic/auto-generated-openapi-v2.yml get /agentic/contexts/{contextId}/tasks/{taskId}/artifacts/{artifactId}","href":"/agentic-v2/artifacts/get-an-artifact"}]},{"group":"Registry","pages":[{"title":"List available registry connectors","deprecated":null,"version":null,"openapi":"/agentic/auto-generated-openapi-v2.yml get /agentic/registry/connectors","href":"/agentic-v2/registry/list-available-registry-connectors"},{"title":"Get registry connector details and configuration schema","deprecated":null,"version":null,"openapi":"/agentic/auto-generated-openapi-v2.yml get /agentic/registry/connectors/{connectorId}","href":"/agentic-v2/registry/get-registry-connector-details-and-configuration-schema"}]},{"group":"Feedback","pages":[{"title":"List feedback for a task","deprecated":null,"version":null,"openapi":"/agentic/auto-generated-openapi-v2.yml get /agentic/contexts/{contextId}/tasks/{taskId}/feedback","href":"/agentic-v2/feedback/list-feedback-for-a-task"},{"title":"Submit feedback for a task","deprecated":null,"version":null,"openapi":"/agentic/auto-generated-openapi-v2.yml post /agentic/contexts/{contextId}/tasks/{taskId}/feedback","href":"/agentic-v2/feedback/submit-feedback-for-a-task"},{"title":"Delete a feedback resource","deprecated":null,"version":null,"openapi":"/agentic/auto-generated-openapi-v2.yml delete /agentic/contexts/{contextId}/tasks/{taskId}/feedback/{feedbackId}","href":"/agentic-v2/feedback/delete-a-feedback-resource"}]}]},{"group":"Web Socket APIs","icon":"handshake","pages":[{"group":"Transcribe","pages":[{"title":"Real-time stateless dictation","sidebarTitle":"Stateless dictation","tag":"WSS","href":"/api-reference/transcribe"}]},{"group":"Streams","pages":[{"title":"Real-time conversational transcript generation and fact extraction (FactsR™)","sidebarTitle":"Conversational fact extraction","tag":"WSS","href":"/api-reference/streams"}]}]},{"group":"REST APIs","icon":"arrow-up-down","pages":[{"group":"Interactions","pages":[{"title":"List All Interactions","deprecated":null,"version":null,"openapi":"/api-reference/auto-generated-openapi.yml get /interactions/","href":"/api-reference/interactions/list-all-interactions"},{"title":"Create Interaction","deprecated":null,"version":null,"openapi":"/api-reference/auto-generated-openapi.yml post /interactions/","href":"/api-reference/interactions/create-interaction"},{"title":"Get Existing Interaction","deprecated":null,"version":null,"openapi":"/api-reference/auto-generated-openapi.yml get /interactions/{id}","href":"/api-reference/interactions/get-existing-interaction"},{"title":"Delete Interaction","deprecated":null,"version":null,"openapi":"/api-reference/auto-generated-openapi.yml delete /interactions/{id}","href":"/api-reference/interactions/delete-interaction"},{"title":"Update Interaction","deprecated":null,"version":null,"openapi":"/api-reference/auto-generated-openapi.yml patch /interactions/{id}","href":"/api-reference/interactions/update-interaction"},{"title":"Update Interaction Retention Policy","deprecated":null,"version":null,"openapi":"/api-reference/auto-generated-openapi.yml put /interactions/{id}/retention-policy","href":"/api-reference/interactions/update-interaction-retention-policy"}]},{"group":"Recordings","pages":[{"title":"List Recordings","deprecated":null,"version":null,"openapi":"/api-reference/auto-generated-openapi.yml get /interactions/{id}/recordings/","href":"/api-reference/recordings/list-recordings"},{"title":"Upload Recording","deprecated":null,"version":null,"openapi":"/api-reference/auto-generated-openapi.yml post /interactions/{id}/recordings/","href":"/api-reference/recordings/upload-recording"},{"title":"Get Recording","deprecated":null,"version":null,"openapi":"/api-reference/auto-generated-openapi.yml get /interactions/{id}/recordings/{recordingId}","href":"/api-reference/recordings/get-recording"},{"title":"Delete Recording","deprecated":null,"version":null,"openapi":"/api-reference/auto-generated-openapi.yml delete /interactions/{id}/recordings/{recordingId}","href":"/api-reference/recordings/delete-recording"}]},{"group":"Transcripts","pages":[{"title":"List Transcripts","deprecated":null,"version":null,"openapi":"/api-reference/auto-generated-openapi.yml get /interactions/{id}/transcripts/","href":"/api-reference/transcripts/list-transcripts"},{"title":"Create Transcript","deprecated":null,"version":null,"openapi":"/api-reference/auto-generated-openapi.yml post /interactions/{id}/transcripts/","href":"/api-reference/transcripts/create-transcript"},{"title":"Get Transcript","deprecated":null,"version":null,"openapi":"/api-reference/auto-generated-openapi.yml get /interactions/{id}/transcripts/{transcriptId}","href":"/api-reference/transcripts/get-transcript"},{"title":"Delete Transcript","deprecated":null,"version":null,"openapi":"/api-reference/auto-generated-openapi.yml delete /interactions/{id}/transcripts/{transcriptId}","href":"/api-reference/transcripts/delete-transcript"},{"title":"Get Transcript Status","deprecated":null,"version":null,"openapi":"/api-reference/auto-generated-openapi.yml get /interactions/{id}/transcripts/{transcriptId}/status","href":"/api-reference/transcripts/get-transcript-status"}]},{"group":"Facts","pages":[{"title":"List Fact Groups","deprecated":null,"version":null,"openapi":"/api-reference/auto-generated-openapi.yml get /factgroups/","href":"/api-reference/facts/list-fact-groups"},{"title":"List Facts","deprecated":null,"version":null,"openapi":"/api-reference/auto-generated-openapi.yml get /interactions/{id}/facts/","href":"/api-reference/facts/list-facts"},{"title":"Add Facts","deprecated":null,"version":null,"openapi":"/api-reference/auto-generated-openapi.yml post /interactions/{id}/facts/","href":"/api-reference/facts/add-facts"},{"title":"Update Facts","deprecated":null,"version":null,"openapi":"/api-reference/auto-generated-openapi.yml patch /interactions/{id}/facts/","href":"/api-reference/facts/update-facts"},{"title":"Update Fact","deprecated":null,"version":null,"openapi":"/api-reference/auto-generated-openapi.yml patch /interactions/{id}/facts/{factId}","href":"/api-reference/facts/update-fact"},{"title":"Extract Facts","deprecated":null,"version":null,"openapi":"/api-reference/auto-generated-openapi.yml post /tools/extract-facts","href":"/api-reference/facts/extract-facts"}]},{"group":"Documents (Classic)","pages":[{"title":"List Documents","deprecated":true,"version":null,"openapi":"/api-reference/auto-generated-openapi.yml get /interactions/{id}/documents/","href":"/api-reference/documents-classic/list-documents"},{"title":"Generate Document","deprecated":true,"version":null,"openapi":"/api-reference/auto-generated-openapi.yml post /interactions/{id}/documents/","href":"/api-reference/documents-classic/generate-document"},{"title":"Get Document","deprecated":true,"version":null,"openapi":"/api-reference/auto-generated-openapi.yml get /interactions/{id}/documents/{documentId}","href":"/api-reference/documents-classic/get-document"},{"title":"Delete Document","deprecated":true,"version":null,"openapi":"/api-reference/auto-generated-openapi.yml delete /interactions/{id}/documents/{documentId}","href":"/api-reference/documents-classic/delete-document"},{"title":"Update Document","deprecated":true,"version":null,"openapi":"/api-reference/auto-generated-openapi.yml patch /interactions/{id}/documents/{documentId}","href":"/api-reference/documents-classic/update-document"}]},{"group":"Templates (Classic)","pages":[{"title":"List Template Sections","deprecated":true,"version":null,"openapi":"/api-reference/auto-generated-openapi.yml get /templateSections/","href":"/api-reference/templates-classic/list-template-sections"},{"title":"List Templates","deprecated":true,"version":null,"openapi":"/api-reference/auto-generated-openapi.yml get /templates/","href":"/api-reference/templates-classic/list-templates"},{"title":"Get Template","deprecated":true,"version":null,"openapi":"/api-reference/auto-generated-openapi.yml get /templates/{key}","href":"/api-reference/templates-classic/get-template"}]},{"group":"Codes (Legacy)","pages":[{"title":"List Codes","deprecated":null,"version":null,"openapi":"/api-reference/auto-generated-openapi.yml get /interactions/{id}/codes/","href":"/api-reference/codes-legacy/list-codes"},{"title":"Select Codes","deprecated":null,"version":null,"openapi":"/api-reference/auto-generated-openapi.yml put /interactions/{id}/codes/","href":"/api-reference/codes-legacy/select-codes"},{"title":"Generate Codes","deprecated":null,"version":null,"openapi":"/api-reference/auto-generated-openapi.yml post /interactions/{id}/codes/","href":"/api-reference/codes-legacy/generate-codes"}]},{"group":"Codes","pages":[{"title":"Predict Codes","deprecated":null,"version":null,"openapi":"/api-reference/auto-generated-openapi.yml post /tools/coding/","href":"/api-reference/codes/predict-codes"}]},{"group":"Guided Templates","pages":[{"title":"List templates","deprecated":null,"version":null,"openapi":"/api-reference/auto-generated-openapi.yml get /documents/templates/","href":"/api-reference/guided-templates/list-templates"},{"title":"Create template","deprecated":null,"version":null,"openapi":"/api-reference/auto-generated-openapi.yml post /documents/templates/","href":"/api-reference/guided-templates/create-template"},{"title":"Get template","deprecated":null,"version":null,"openapi":"/api-reference/auto-generated-openapi.yml get /documents/templates/{templateID}","href":"/api-reference/guided-templates/get-template"},{"title":"Delete template","deprecated":null,"version":null,"openapi":"/api-reference/auto-generated-openapi.yml delete /documents/templates/{templateID}","href":"/api-reference/guided-templates/delete-template"},{"title":"Update template metadata","deprecated":null,"version":null,"openapi":"/api-reference/auto-generated-openapi.yml patch /documents/templates/{templateID}","href":"/api-reference/guided-templates/update-template-metadata"},{"title":"List template versions","deprecated":null,"version":null,"openapi":"/api-reference/auto-generated-openapi.yml get /documents/templates/{templateID}/versions/","href":"/api-reference/guided-templates/list-template-versions"},{"title":"Create template version","deprecated":null,"version":null,"openapi":"/api-reference/auto-generated-openapi.yml post /documents/templates/{templateID}/versions/","href":"/api-reference/guided-templates/create-template-version"},{"title":"Get template version","deprecated":null,"version":null,"openapi":"/api-reference/auto-generated-openapi.yml get /documents/templates/{templateID}/versions/{versionID}","href":"/api-reference/guided-templates/get-template-version"},{"title":"Delete template version","deprecated":null,"version":null,"openapi":"/api-reference/auto-generated-openapi.yml delete /documents/templates/{templateID}/versions/{versionID}","href":"/api-reference/guided-templates/delete-template-version"},{"title":"Publish template version","deprecated":null,"version":null,"openapi":"/api-reference/auto-generated-openapi.yml post /documents/templates/{templateID}/versions/{versionID}/publish","href":"/api-reference/guided-templates/publish-template-version"}]},{"group":"Guided Sections","pages":[{"title":"List sections","deprecated":null,"version":null,"openapi":"/api-reference/auto-generated-openapi.yml get /documents/sections/","href":"/api-reference/guided-sections/list-sections"},{"title":"Create section","deprecated":null,"version":null,"openapi":"/api-reference/auto-generated-openapi.yml post /documents/sections/","href":"/api-reference/guided-sections/create-section"},{"title":"Get section","deprecated":null,"version":null,"openapi":"/api-reference/auto-generated-openapi.yml get /documents/sections/{sectionID}","href":"/api-reference/guided-sections/get-section"},{"title":"Delete section","deprecated":null,"version":null,"openapi":"/api-reference/auto-generated-openapi.yml delete /documents/sections/{sectionID}","href":"/api-reference/guided-sections/delete-section"},{"title":"Update section metadata","deprecated":null,"version":null,"openapi":"/api-reference/auto-generated-openapi.yml patch /documents/sections/{sectionID}","href":"/api-reference/guided-sections/update-section-metadata"},{"title":"List section versions","deprecated":null,"version":null,"openapi":"/api-reference/auto-generated-openapi.yml get /documents/sections/{sectionID}/versions/","href":"/api-reference/guided-sections/list-section-versions"},{"title":"Create section version","deprecated":null,"version":null,"openapi":"/api-reference/auto-generated-openapi.yml post /documents/sections/{sectionID}/versions/","href":"/api-reference/guided-sections/create-section-version"},{"title":"Get section version","deprecated":null,"version":null,"openapi":"/api-reference/auto-generated-openapi.yml get /documents/sections/{sectionID}/versions/{versionID}","href":"/api-reference/guided-sections/get-section-version"},{"title":"Delete section version","deprecated":null,"version":null,"openapi":"/api-reference/auto-generated-openapi.yml delete /documents/sections/{sectionID}/versions/{versionID}","href":"/api-reference/guided-sections/delete-section-version"},{"title":"Publish section version","deprecated":null,"version":null,"openapi":"/api-reference/auto-generated-openapi.yml post /documents/sections/{sectionID}/versions/{versionID}/publish","href":"/api-reference/guided-sections/publish-section-version"},{"title":"Get section impact","deprecated":null,"version":null,"openapi":"/api-reference/auto-generated-openapi.yml get /documents/sections/{sectionID}/impact","href":"/api-reference/guided-sections/get-section-impact"}]},{"group":"Guided Documents","pages":[{"title":"List documents","deprecated":null,"version":null,"openapi":"/api-reference/auto-generated-openapi.yml get /documents/","href":"/api-reference/guided-documents/list-documents"},{"title":"Generate a structured document","deprecated":null,"version":null,"openapi":"/api-reference/auto-generated-openapi.yml post /documents/","href":"/api-reference/guided-documents/generate-a-structured-document"},{"title":"Get document","deprecated":null,"version":null,"openapi":"/api-reference/auto-generated-openapi.yml get /documents/{documentID}","href":"/api-reference/guided-documents/get-document"},{"title":"Delete document","deprecated":null,"version":null,"openapi":"/api-reference/auto-generated-openapi.yml delete /documents/{documentID}","href":"/api-reference/guided-documents/delete-document"},{"title":"Update document","deprecated":null,"version":null,"openapi":"/api-reference/auto-generated-openapi.yml patch /documents/{documentID}","href":"/api-reference/guided-documents/update-document"}]},{"group":"Languages","pages":[{"title":"List Languages","deprecated":null,"version":null,"openapi":"/api-reference/auto-generated-openapi.yml get /languages/","href":"/api-reference/languages/list-languages"}]}]},{"group":"Admin APIs","icon":"shield-check","pages":[{"group":"Auth","pages":[{"title":"Authenticate user and get access token","deprecated":null,"version":null,"openapi":"/api-reference/admin/admin-openapi.yml post /auth/token","href":"/api-reference/admin/auth/authenticate-user-and-get-access-token"}]},{"group":"Customers","pages":[{"title":"List customers for a project","deprecated":null,"version":null,"openapi":"/api-reference/admin/admin-openapi.yml get /projects/{projectId}/customers","href":"/api-reference/admin/customers/list-customers-for-a-project"},{"title":"Create a new customer","deprecated":null,"version":null,"openapi":"/api-reference/admin/admin-openapi.yml post /projects/{projectId}/customers","href":"/api-reference/admin/customers/create-a-new-customer"},{"title":"Delete a customer","deprecated":null,"version":null,"openapi":"/api-reference/admin/admin-openapi.yml delete /projects/{projectId}/customers/{customerId}","href":"/api-reference/admin/customers/delete-a-customer"},{"title":"Update a customer","deprecated":null,"version":null,"openapi":"/api-reference/admin/admin-openapi.yml patch /projects/{projectId}/customers/{customerId}","href":"/api-reference/admin/customers/update-a-customer"},{"title":"Get quotas for a customer","deprecated":null,"version":null,"openapi":"/api-reference/admin/admin-openapi.yml get /projects/{projectId}/customers/{customerId}/quotas","href":"/api-reference/admin/customers/get-quotas-for-a-customer"}]},{"group":"Projects","pages":[{"title":"Get quotas for all tenants within a project","deprecated":null,"version":null,"openapi":"/api-reference/admin/admin-openapi.yml get /projects/{projectId}/quotas","href":"/api-reference/admin/projects/get-quotas-for-all-tenants-within-a-project"}]},{"group":"Users","pages":[{"title":"List users for a customer","deprecated":null,"version":null,"openapi":"/api-reference/admin/admin-openapi.yml get /projects/{projectId}/customers/{customerId}/users","href":"/api-reference/admin/users/list-users-for-a-customer"},{"title":"Create a new user and add it to the customer","deprecated":null,"version":null,"openapi":"/api-reference/admin/admin-openapi.yml post /projects/{projectId}/customers/{customerId}/users","href":"/api-reference/admin/users/create-a-new-user-and-add-it-to-the-customer"},{"title":"Get a user by ID","deprecated":null,"version":null,"openapi":"/api-reference/admin/admin-openapi.yml get /projects/{projectId}/customers/{customerId}/users/{userId}","href":"/api-reference/admin/users/get-a-user-by-id"},{"title":"Update a user","deprecated":null,"version":null,"openapi":"/api-reference/admin/admin-openapi.yml patch /projects/{projectId}/customers/{customerId}/users/{userId}","href":"/api-reference/admin/users/update-a-user"},{"title":"Get usage consumption for a user within a time window","deprecated":null,"version":null,"openapi":"/api-reference/admin/admin-openapi.yml get /projects/{projectId}/customers/{customerId}/users/{userId}/consumption","href":"/api-reference/admin/users/get-usage-consumption-for-a-user-within-a-time-window"},{"title":"Delete a user","deprecated":null,"version":null,"openapi":"/api-reference/admin/admin-openapi.yml delete /projects/{projectId}/customers/{customerId}/users/{userId}/consumption","href":"/api-reference/admin/users/delete-a-user"}]}]},{"group":"Errors","icon":"triangle-alert","pages":[{"title":"Errors","href":"/api-reference/errors"}]},{"group":"Agentic APIs v1 (deprecated)","icon":"layers","pages":[{"group":"Agents","pages":[{"title":"List Agents","deprecated":null,"version":null,"openapi":"/agentic/auto-generated-openapi.yml get /agents","href":"/agentic/agents/list-agents"},{"title":"Create Agent","deprecated":null,"version":null,"openapi":"/agentic/auto-generated-openapi.yml post /agents","href":"/agentic/agents/create-agent"},{"title":"Get Agent by ID","deprecated":null,"version":null,"openapi":"/agentic/auto-generated-openapi.yml get /agents/{id}","href":"/agentic/agents/get-agent-by-id"},{"title":"Delete Agent by ID","deprecated":null,"version":null,"openapi":"/agentic/auto-generated-openapi.yml delete /agents/{id}","href":"/agentic/agents/delete-agent-by-id"},{"title":"Update Agent by ID","deprecated":null,"version":null,"openapi":"/agentic/auto-generated-openapi.yml patch /agents/{id}","href":"/agentic/agents/update-agent-by-id"},{"title":"Get Agent Card","deprecated":null,"version":null,"openapi":"/agentic/auto-generated-openapi.yml get /agents/{id}/agent-card.json","href":"/agentic/agents/get-agent-card"},{"title":"Send Message to Agent","deprecated":null,"version":null,"openapi":"/agentic/auto-generated-openapi.yml post /agents/{id}/v1/message:send","href":"/agentic/agents/send-message-to-agent"},{"title":"Get Task by ID","deprecated":null,"version":null,"openapi":"/agentic/auto-generated-openapi.yml get /agents/{id}/v1/tasks/{taskId}","href":"/agentic/agents/get-task-by-id"},{"title":"Get Context by ID","deprecated":null,"version":null,"openapi":"/agentic/auto-generated-openapi.yml get /agents/{id}/v1/contexts/{contextId}","href":"/agentic/agents/get-context-by-id"},{"title":"Delete Context by ID","deprecated":null,"version":null,"openapi":"/agentic/auto-generated-openapi.yml delete /agents/{id}/v1/contexts/{contextId}","href":"/agentic/agents/delete-context-by-id"},{"title":"List Registry Experts","deprecated":null,"version":null,"openapi":"/agentic/auto-generated-openapi.yml get /agents/registry/experts","href":"/agentic/agents/list-registry-experts"}]}]}]}]},"basePath":"","title":"List agents - Corti API Documentation","buildId":"dpl_BLQvU86QFwq3AhPofSTw6q8dGWKm","deploymentId":"dpl_BLQvU86QFwq3AhPofSTw6q8dGWKm","dynamics":["10e4515597","c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["BannerMarkdown-DcUtcwZ_.js","dist-CJ9Oly2E.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","clsx-C5EfhVm0.js","html-void-elements-mCSPHezU.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","OpenApiReferenceProvider-Myd8dsju.js","utils-C2HkQgW0.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-8rSppmTv.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-B6MjiCFm.js","snippetPresets-DwrSAONL.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-1-a5UQKQ.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C541m7wZ.js","shallow-CWELCZ77.js","getApiPlaygroundDisplay-CTo5Zn03.js","CodeSnippet-D--dzvnl.js","CodeSnippets-DM3cXEDh.js","Page-CxAy5y67.js","getPastedJson-C-VECgcL.js","icon-BPq2-Mg3.js","MethodPill-D9J5cUHd.js","DuplicateIcon-BqHaxUnD.js","createIcon-CIbcZHp9.js","DynamicMarkdown-BKiHAm_d.js","SectionHeading-DstQXt3H.js","axios-vUo_bRtp.js","Markdown-CpxgzsKA.js","AssistantPageLink-Mk6P3qvh.js"]}