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"
});
await client.agentic.agents.usage("agt.0192f4c8-2c5a-7b3e-9f1a-3c8d6e2b7a40", {
from: new Date("2026-05-19T00:00:00.000Z"),
to: new Date("2026-05-20T00:00:00.000Z")
});
using Corti.Agentic;
using Corti;
var client = new CortiClient(
"TENANT_NAME",
CortiClientEnvironment.Eu,
new CortiClientAuth.ClientCredentials("client_id", "client_secret")
);
await client.Agentic.Agents.UsageAsync(
"agt.0192f4c8-2c5a-7b3e-9f1a-3c8d6e2b7a40",
new AgenticAgentsUsageRequest
{
From = new DateTime(2026, 05, 19, 00, 00, 00, 000),
To = new DateTime(2026, 05, 20, 00, 00, 00, 000),
}
);
Returns invocation metrics for the agent over the half-open [from, to)
time range (UTC), bucketed at the requested granularity. The response
echoes the resolved range and granularity, a totals summary across the
whole range, and one buckets entry per period that had activity (the
array is empty when there was none). When from/to are omitted, the
range defaults to the last 30 days.
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"
});
await client.agentic.agents.usage("agt.0192f4c8-2c5a-7b3e-9f1a-3c8d6e2b7a40", {
from: new Date("2026-05-19T00:00:00.000Z"),
to: new Date("2026-05-20T00:00:00.000Z")
});
using Corti.Agentic;
using Corti;
var client = new CortiClient(
"TENANT_NAME",
CortiClientEnvironment.Eu,
new CortiClientAuth.ClientCredentials("client_id", "client_secret")
);
await client.Agentic.Agents.UsageAsync(
"agt.0192f4c8-2c5a-7b3e-9f1a-3c8d6e2b7a40",
new AgenticAgentsUsageRequest
{
From = new DateTime(2026, 05, 19, 00, 00, 00, 000),
To = new DateTime(2026, 05, 20, 00, 00, 00, 000),
}
);
Size of each reporting bucket. Defaults to day.
The size of each usage reporting bucket. Only day is currently honored; minute, hour, and week are accepted but produce daily buckets (the server always returns day).
Available options:
minute,
hour,
day,
week
Response
The agent's bucketed usage over the requested range.
An agent's bucketed usage over a date range, with range-wide totals.
The size of each usage reporting bucket. Only day is currently honored; minute, hour, and week are accepted but produce daily buckets (the server always returns day).
One entry per period with activity, ordered oldest first.
Show child attributes
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.4076","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":[],"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/usage/get-an-agents-usage","slug":"/agentic-v2/usage/get-an-agents-usage","pageMetadata":{"title":"Get an agent's usage","description":"Returns invocation metrics for the agent over the half-open `[from, to)`\ntime range (UTC), bucketed at the requested `granularity`. The response\nechoes the resolved range and granularity, a `totals` summary across the\nwhole range, and one `buckets` entry per period that had activity (the\narray is empty when there was none). When `from`/`to` are omitted, the\nrange defaults to the last 30 days.\n","deprecated":null,"version":null,"openapi":"/agentic/auto-generated-openapi-v2.yml get /agentic/agents/{agentId}/usage","href":"/agentic-v2/usage/get-an-agents-usage","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: [\"Returns invocation metrics for the agent over the half-open \", _jsx(_components.code, {\n children: \"[from, to)\"\n }), \"\\ntime range (UTC), bucketed at the requested \", _jsx(_components.code, {\n children: \"granularity\"\n }), \". The response\\nechoes the resolved range and granularity, a \", _jsx(_components.code, {\n children: \"totals\"\n }), \" summary across the\\nwhole range, and one \", _jsx(_components.code, {\n children: \"buckets\"\n }), \" entry per period that had activity (the\\narray is empty when there was none). When \", _jsx(_components.code, {\n children: \"from\"\n }), \"/\", _jsx(_components.code, {\n children: \"to\"\n }), \" are omitted, the\\nrange defaults to the last 30 days.\"]\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":"Get an agent's usage","description":"Returns invocation metrics for the agent over the half-open `[from, to)`\ntime range (UTC), bucketed at the requested `granularity`. The response\nechoes the resolved range and granularity, a `totals` summary across the\nwhole range, and one `buckets` entry per period that had activity (the\narray is empty when there was none). When `from`/`to` are omitted, the\nrange defaults to the last 30 days.\n","deprecated":null,"version":null,"openapi":"/agentic/auto-generated-openapi-v2.yml get /agentic/agents/{agentId}/usage","href":"/agentic-v2/usage/get-an-agents-usage","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":["Usage"],"operationId":"UsageGet","summary":"Get an agent's usage","description":"Returns invocation metrics for the agent over the half-open `[from, to)`\ntime range (UTC), bucketed at the requested `granularity`. The response\nechoes the resolved range and granularity, a `totals` summary across the\nwhole range, and one `buckets` entry per period that had activity (the\narray is empty when there was none). When `from`/`to` are omitted, the\nrange defaults to the last 30 days.\n","parameters":["22ad6205-fe47-4ad0-a29f-101fbb040ae5","9bc82d73-3f4e-4333-9f72-19526c382877","fc54d2c6-b02c-4793-ac26-67a42d2f8cb9"],"responses":{"200":"11bbb0d3-fdae-4bd6-b685-7c76441b119e","400":"fb3733b3-b427-4254-bf9a-5835c5e05404","401":"44509737-8be7-45e2-bf14-17211e35230a","404":"75278534-6976-4e12-8425-c8770d57eb8f"},"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);\nawait client.Agentic.Agents.UsageAsync(\n \"agt.0192f4c8-2c5a-7b3e-9f1a-3c8d6e2b7a40\",\n new AgenticAgentsUsageRequest\n {\n From = new DateTime(2026, 05, 19, 00, 00, 00, 000),\n To = new DateTime(2026, 05, 20, 00, 00, 00, 000),\n }\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});\nawait client.agentic.agents.usage(\"agt.0192f4c8-2c5a-7b3e-9f1a-3c8d6e2b7a40\", {\n from: new Date(\"2026-05-19T00:00:00.000Z\"),\n to: new Date(\"2026-05-20T00:00:00.000Z\")\n});\n"}],"method":"get","type":"path","servers":["ce2bc9db-751e-40c4-9602-b295cd851c23"],"security":["f25353c6-49cd-445f-ab1b-ce71788a1457"],"path":"/agentic/agents/{agentId}/usage","baseUrlOptions":["https://api.{environment}.corti.app/v2/"],"title":"Get an agent's usage","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);\nawait client.Agentic.Agents.UsageAsync(\n \"agt.0192f4c8-2c5a-7b3e-9f1a-3c8d6e2b7a40\",\n new AgenticAgentsUsageRequest\n {\n From = new DateTime(2026, 05, 19, 00, 00, 00, 000),\n To = new DateTime(2026, 05, 20, 00, 00, 00, 000),\n }\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});\nawait client.agentic.agents.usage(\"agt.0192f4c8-2c5a-7b3e-9f1a-3c8d6e2b7a40\", {\n from: new Date(\"2026-05-19T00:00:00.000Z\"),\n to: new Date(\"2026-05-20T00:00:00.000Z\")\n});\n"}],"requestExampleLanguages":["bash","javascript","csharp","python","php","go","java"],"requiredOnlyExamples":false,"requestExampleType":"codeSamples","responseExampleType":"generated"},"dependencies":{"parameters":{"22ad6205-fe47-4ad0-a29f-101fbb040ae5":{"name":"from","in":"query","description":"Inclusive start of the range, as an RFC 3339 timestamp (UTC).\nDefaults to 30 days before `to`. Must not be after `to`.\n","schema":{"type":"string","format":"date-time","description":"Inclusive start of the range, as an RFC 3339 timestamp (UTC).\nDefaults to 30 days before `to`. Must not be after `to`.\n","uniqueKey":"","typeLabel":"string\u003cdate-time>"},"example":"2026-05-19T00:00:00Z"},"9bc82d73-3f4e-4333-9f72-19526c382877":{"name":"to","in":"query","description":"Exclusive end of the range, as an RFC 3339 timestamp (UTC).\nDefaults to the current time.\n","schema":{"type":"string","format":"date-time","description":"Exclusive end of the range, as an RFC 3339 timestamp (UTC).\nDefaults to the current time.\n","uniqueKey":"","typeLabel":"string\u003cdate-time>"},"example":"2026-05-20T00:00:00Z"},"fc54d2c6-b02c-4793-ac26-67a42d2f8cb9":{"name":"granularity","in":"query","description":"Size of each reporting bucket. Defaults to `day`.","schema":{"type":"string","description":"Size of each reporting bucket. Defaults to `day`.\nThe size of each usage reporting bucket. Only `day` is currently honored; `minute`, `hour`, and `week` are accepted but produce daily buckets (the server always returns `day`). ","enum":["minute","hour","day","week"],"default":"day","uniqueKey":"","typeLabel":"enum\u003cstring>"},"example":"day"},"ab91a8f9-5854-4d16-9912-acfcbc29a6be":{"name":"agentId","in":"path","required":true,"description":"Agent identifier (prefixed UUIDv7).","schema":{"type":"string","format":"agent-id","description":"Agent identifier (prefixed UUIDv7).\nAgent 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":"","typeLabel":"string\u003cagent-id>"}}},"responses":{"11bbb0d3-fdae-4bd6-b685-7c76441b119e":{"description":"The agent's bucketed usage over the requested range.","content":{"application/json":{"schema":{"type":"object","description":"An agent's bucketed usage over a date range, with range-wide totals.","required":["granularity","from","to","totals","buckets"],"properties":{"granularity":{"type":"string","description":"The size of each usage reporting bucket. Only `day` is currently honored; `minute`, `hour`, and `week` are accepted but produce daily buckets (the server always returns `day`). ","enum":["minute","hour","day","week"],"default":"day","isRequired":true,"uniqueKey":"granularity","typeLabel":"enum\u003cstring>"},"from":{"type":"string","format":"date-time","description":"Resolved inclusive start of the range (UTC).","examples":["2026-05-19T00:00:00Z"],"isRequired":true,"uniqueKey":"from","typeLabel":"string\u003cdate-time>"},"to":{"type":"string","format":"date-time","description":"Resolved exclusive end of the range (UTC).","examples":["2026-05-21T00:00:00Z"],"isRequired":true,"uniqueKey":"to","typeLabel":"string\u003cdate-time>"},"totals":{"type":"object","description":"Aggregate metrics across the whole range.","required":["invocations","uniqueContexts"],"properties":{"invocations":{"type":"integer","format":"int64","minimum":0,"description":"Number of agent invocations in the period.","examples":[12],"isRequired":true,"uniqueKey":"totals.invocations","typeLabel":"integer\u003cint64>"},"uniqueContexts":{"type":"integer","format":"int64","minimum":0,"description":"Number of distinct contexts invoked in the period.","examples":[5],"isRequired":true,"uniqueKey":"totals.uniqueContexts","typeLabel":"integer\u003cint64>"}},"isRequired":true,"uniqueKey":"totals","typeLabel":"object"},"buckets":{"type":"array","description":"One entry per period with activity, ordered oldest first.","items":{"type":"object","description":"Usage metrics for a single time bucket.","required":["invocations","uniqueContexts","periodStart","periodEnd"],"properties":{"periodStart":{"type":"string","format":"date-time","description":"Inclusive start of the bucket (UTC).","examples":["2026-05-19T00:00:00Z"],"isRequired":true,"uniqueKey":"buckets.items.[INDEX].periodStart","typeLabel":"string\u003cdate-time>"},"periodEnd":{"type":"string","format":"date-time","description":"Exclusive end of the bucket (UTC).","examples":["2026-05-20T00:00:00Z"],"isRequired":true,"uniqueKey":"buckets.items.[INDEX].periodEnd","typeLabel":"string\u003cdate-time>"},"invocations":{"type":"integer","format":"int64","minimum":0,"description":"Number of agent invocations in the period.","examples":[12],"isRequired":true,"uniqueKey":"buckets.items.[INDEX].invocations","typeLabel":"integer\u003cint64>"},"uniqueContexts":{"type":"integer","format":"int64","minimum":0,"description":"Number of distinct contexts invoked in the period.","examples":[5],"isRequired":true,"uniqueKey":"buckets.items.[INDEX].uniqueContexts","typeLabel":"integer\u003cint64>"}},"uniqueKey":"buckets.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"buckets","typeLabel":"object[]"}},"examples":[{"granularity":"day","from":"2026-05-19T00:00:00Z","to":"2026-05-21T00:00:00Z","totals":{"invocations":15,"uniqueContexts":6},"buckets":[{"periodStart":"2026-05-19T00:00:00Z","periodEnd":"2026-05-20T00:00:00Z","invocations":12,"uniqueContexts":5},{"periodStart":"2026-05-20T00:00:00Z","periodEnd":"2026-05-21T00:00:00Z","invocations":3,"uniqueContexts":2}]}],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"granularity":"day","from":"2026-05-19T00:00:00Z","to":"2026-05-21T00:00:00Z","totals":{"invocations":15,"uniqueContexts":6},"buckets":[{"periodStart":"2026-05-19T00:00:00Z","periodEnd":"2026-05-20T00:00:00Z","invocations":12,"uniqueContexts":5},{"periodStart":"2026-05-20T00:00:00Z","periodEnd":"2026-05-21T00:00:00Z","invocations":3,"uniqueContexts":2}]}}},"exampleType":"generated"}},"exampleType":"generated"},"fb3733b3-b427-4254-bf9a-5835c5e05404":{"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"},"44509737-8be7-45e2-bf14-17211e35230a":{"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"},"75278534-6976-4e12-8425-c8770d57eb8f":{"description":"The resource does not exist or is not visible to the caller.","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":"Get an agent's usage - Corti API Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-29T15:15:02.123Z","originalFileLocation":"agentic-v2/usage/get-an-agents-usage.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=\"Returns invocation metrics for the agent over the half-open [from, to) time range (UTC), bucketed at the requested granularity. The response echoes the resolved range and granularity, a totals summary across the whole range, and one buckets entry per period that had activity (the array is empty when there was none). When from/to are omitted, the range defaults to the last 30 days.\">\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=\"Get an agent\u0026#x27;s usage - Corti API Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Returns invocation metrics for the agent over the half-open [from, to) time range (UTC), bucketed at the requested granularity. The response echoes the resolved range and granularity, a totals summary across the whole range, and one buckets entry per period that had activity (the array is empty when there was none). When from/to are omitted, the range defaults to the last 30 days.\">\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/usage/get-an-agents-usage\">\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=Usage\u0026amp;title=Get+an+agent%27s+usage\u0026amp;description=Returns+invocation+metrics+for+the+agent+over+the+half-open+%60%5Bfrom%2C+to%29%60%0Atime+range+%28UTC%29%2C+bucketed+at+the+requested+%60granularity%60.+The+response%0Aechoes+the+reso\u0026amp;theme=34b80329efcd2beff359af85\u0026amp;signature=255f6cb6597a120725dbe94ba5a5ed56b43ec0f59e9c5427a41da4564c02f7dd\">\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=\"Get an agent\u0026#x27;s usage - Corti API Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Returns invocation metrics for the agent over the half-open [from, to) time range (UTC), bucketed at the requested granularity. The response echoes the resolved range and granularity, a totals summary across the whole range, and one buckets entry per period that had activity (the array is empty when there was none). When from/to are omitted, the range defaults to the last 30 days.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://corti.mintlify.site/_mintlify/api/og/v2?division=Usage\u0026amp;title=Get+an+agent%27s+usage\u0026amp;description=Returns+invocation+metrics+for+the+agent+over+the+half-open+%60%5Bfrom%2C+to%29%60%0Atime+range+%28UTC%29%2C+bucketed+at+the+requested+%60granularity%60.+The+response%0Aechoes+the+reso\u0026amp;theme=34b80329efcd2beff359af85\u0026amp;signature=255f6cb6597a120725dbe94ba5a5ed56b43ec0f59e9c5427a41da4564c02f7dd\">\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/usage/get-an-agents-usage\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/agentic-v2/usage/get-an-agents-usage.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/usage/get-an-agents-usage#webpage\",\"url\":\"https://docs.corti.ai/agentic-v2/usage/get-an-agents-usage\",\"name\":\"Get an agent's usage\",\"description\":\"Returns invocation metrics for the agent over the half-open [from, to) time range (UTC), bucketed at the requested granularity. The response echoes the resolved range and granularity, a totals summary across the whole range, and one buckets entry per period that had activity (the array is empty when there was none). When from/to are omitted, the range defaults to the last 30 days.\",\"dateModified\":\"2026-10-29T15:15:02.123Z\",\"isPartOf\":{\"@id\":\"https://docs.corti.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.corti.ai/agentic-v2/usage/get-an-agents-usage#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.corti.ai/agentic-v2/usage/get-an-agents-usage#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Agentic APIs\",\"item\":\"https://docs.corti.ai/agentic-v2/agents/list-agents\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Get an agent's usage\",\"item\":\"https://docs.corti.ai/agentic-v2/usage/get-an-agents-usage\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.corti.ai/agentic-v2/usage/get-an-agents-usage#apireference\",\"headline\":\"Get an agent's usage\",\"name\":\"Get an agent's usage\",\"description\":\"Returns invocation metrics for the agent over the half-open [from, to) time range (UTC), bucketed at the requested granularity. The response echoes the resolved range and granularity, a totals summary across the whole range, and one buckets entry per period that had activity (the array is empty when there was none). When from/to are omitted, the range defaults to the last 30 days.\",\"url\":\"https://docs.corti.ai/agentic-v2/usage/get-an-agents-usage\",\"mainEntityOfPage\":{\"@id\":\"https://docs.corti.ai/agentic-v2/usage/get-an-agents-usage#webpage\"},\"dateModified\":\"2026-10-29T15:15:02.123Z\",\"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","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","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)","description":"Resubscribe to an in-flight task's event stream over SSE.","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","description":null,"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":"Get an agent's usage - Corti API Documentation","buildId":"dpl_8LJbrAiZvr1K98WQNZXCyY5AvT34","deploymentId":"dpl_8LJbrAiZvr1K98WQNZXCyY5AvT34","dynamics":["10e4515597","c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["BannerMarkdown-BcDCEkh6.js","dist-CwjSCXIK.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","clsx-eKJ4rcii.js","html-void-elements-mCSPHezU.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","OpenApiReferenceProvider-i2a3QZ8E.js","utils-ChLwp8m0.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DRktVTDc.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-CA2pEs4T.js","snippetPresets-ClQ6XrKD.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-Ct_Lv36y.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-Cn2PYw9e.js","shallow-rkyymjXQ.js","getApiPlaygroundDisplay-BB9vkXtE.js","CodeSnippet-Bm5RU7m1.js","CodeSnippets-BgU9Deuz.js","Page-BUDYNlhG.js","getPastedJson-BD-6NNum.js","icon-8Z6tud2e.js","MethodPill-Tuzr4g3V.js","DuplicateIcon-0ceWFYhN.js","createIcon-FBXow_ST.js","DynamicMarkdown-CD8713Yy.js","SectionHeading-7zgzQbH-.js","axios-vUo_bRtp.js","Markdown-D7Ofw1oz.js","AssistantPageLink-9EK5IAXV.js"]}