[ { "active_prompt_id": "<string>", "auth_mode": "authenticated", "background_audio_enabled": false, "background_audio_volume": 0.8, "category": "customer_support", "created_at": "<string>", "created_by": "user_01HZ2N…", "description": "Greets web visitors and answers product FAQs.", "faqs": [ { "category": "<string>", "content": "<string>", "id": "<string>", "name": "<string>", "summary": "<string>", "title": "<string>" } ], "greeting_message": "Hi, this is the ACME front desk — how can I help?", "greeting_mode": "interruptible", "id": "agent_01HZ2N…", "llm_model": "gpt-4o", "name": "Front Desk", "noise_suppression_enabled": true, "playbooks": [ { "category": "<string>", "description": "<string>", "display_name": "<string>", "id": "<string>", "name": "<string>", "tool_names": [ "<string>" ] } ], "ringing_enabled": true, "status": "active", "system_prompt": "You are a friendly front-desk assistant for ACME Corp.", "template_id": "tmpl_general_intake", "updated_at": "<string>", "voice_id": "v1_friendly_female", "voice_provider": "cartesia" }]
"<string>"
"<string>"
"<string>"
Agents
List agents
Returns every agent in the caller’s account, with attached playbooks and FAQs joined in. Ordered by created_at descending. There is no pagination today — every account has at most a few dozen agents in practice; if that changes we’ll add limit/offset like /api/tools and /api/playbooks.
GET
/
api
/
v1
/
agents
List agents
curl --request GET \ --url https://api.kataven.ai/v1/api/v1/agents \ --header 'Authorization: <api-key>'
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Kataven","colors":{"primary":"#2563EB","light":"#60A5FA","dark":"#1E40AF"},"logo":{"light":"https://mintcdn.com/katavenai/2uMycxhxIwk_F2eE/images/logo.png?fit=max\u0026auto=format\u0026n=2uMycxhxIwk_F2eE\u0026q=85\u0026s=6cf130449ec06609915faad2826a4c60","dark":"https://mintcdn.com/katavenai/2uMycxhxIwk_F2eE/images/logo-dark.png?fit=max\u0026auto=format\u0026n=2uMycxhxIwk_F2eE\u0026q=85\u0026s=7425881c08adee79bcc1e99cdbdf111c"},"favicon":"https://mintcdn.com/katavenai/2uMycxhxIwk_F2eE/images/favicon.png?fit=max\u0026auto=format\u0026n=2uMycxhxIwk_F2eE\u0026q=85\u0026s=dd648daf26b271ad7b55508d49d97e41","api":{"openapi":"api-spec/openapi.yaml"},"navbar":{"links":[{"href":"https://hub.kataven.ai","label":"Dashboard"}],"primary":{"type":"button","label":"Get an API key","href":"https://hub.kataven.ai/settings"}},"footer":{"socials":{"website":"https://kataven.ai"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"katavenai","hasAudioNarration":false,"actualSubdomain":"katavenai","customDomains":["docs.kataven.ai"],"gitSource":{"type":"github","owner":"kataven-ai","repo":"kataven-docs","deployBranch":"main","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a21ddfc374568b70af6c6d6","collectionId":"9d29626f-a39f-45ed-912d-f8362a80503c","schemaVersion":"v2"},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6a21ddfc374568b70af6c6d6:success","clientVersion":"0.0.4021","searchFilterCounts":[{"language":"default","tag":"API Reference","count":89},{"language":"default","tag":"Resources","count":88},{"language":"default","tag":"Documentation","count":38},{"language":"default","tag":"Resource reference","count":26},{"language":"default","tag":"MCP Server","count":18},{"language":"default","tag":"Python SDK","count":15},{"language":"default","tag":"Node SDK","count":14},{"language":"default","tag":"Agents","count":12},{"language":"default","tag":"Clients","count":12},{"language":"default","tag":"Campaigns","count":11}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"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":"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":"pause-universal-search-reconcile","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":"per-site-search-delta","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":"editor-private-page-search","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":"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":"byok-sep-25","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":"billing-updated-9-15","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":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/agents/list-agents","slug":"/api-reference/agents/list-agents","pageMetadata":{"title":"List agents","description":"Returns every agent in the caller's account, with attached playbooks and FAQs joined in. Ordered by `created_at` descending. There is no pagination today — every account has at most a few dozen agents in practice; if that changes we'll add `limit`/`offset` like /api/tools and /api/playbooks.","deprecated":null,"version":null,"openapi":"/api-spec/openapi.yaml get /api/v1/agents","href":"/api-reference/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: [\"Returns every agent in the caller’s account, with attached playbooks and FAQs joined in. Ordered by \", _jsx(_components.code, {\n children: \"created_at\"\n }), \" descending. There is no pagination today — every account has at most a few dozen agents in practice; if that changes we’ll add \", _jsx(_components.code, {\n children: \"limit\"\n }), \"/\", _jsx(_components.code, {\n children: \"offset\"\n }), \" like /api/tools and /api/playbooks.\"]\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":"Returns every agent in the caller's account, with attached playbooks and FAQs joined in. Ordered by `created_at` descending. There is no pagination today — every account has at most a few dozen agents in practice; if that changes we'll add `limit`/`offset` like /api/tools and /api/playbooks.","deprecated":null,"version":null,"openapi":"/api-spec/openapi.yaml get /api/v1/agents","href":"/api-reference/agents/list-agents","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"description":"Returns every agent in the caller's account, with attached playbooks and FAQs joined in. Ordered by `created_at` descending. There is no pagination today — every account has at most a few dozen agents in practice; if that changes we'll add `limit`/`offset` like /api/tools and /api/playbooks.","parameters":["b732f74d-713c-4543-bcef-c061da1080da"],"responses":{"200":"0b049973-517d-446e-9dc8-1aa4e1abd800","400":"100d6c37-c7a9-4429-92c3-1a889b512a4d","401":"d85c0e4c-74b2-41e5-b03c-544f992b4189","500":"cb085595-af5e-441a-bb3b-6ef70c5bfcf5"},"security":["d6cf62b8-67b8-48fc-83e1-abb982dbf4a1"],"summary":"List agents","tags":["Agents"],"operationId":"getApiV1Agents","method":"get","type":"path","servers":["2b33dff2-a1ab-4bf7-96af-68d2316e657d","8147620e-ceb3-43ba-ae06-1e0839dcc10a","55e717d4-04d9-4e93-bdda-b992b33fc560"],"path":"/api/v1/agents","baseUrlOptions":["https://api.kataven.ai/v1","https://hub.kataven.ai/hub-api/api","http://localhost:8081"],"title":"List agents","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"b732f74d-713c-4543-bcef-c061da1080da":{"description":"Tenant database (required only when using a Zitadel JWT; sk_live_ keys self-identify).","in":"header","name":"X-Account-ID","schema":{"type":"string","description":"Tenant database (required only when using a Zitadel JWT; sk_live_ keys self-identify).","uniqueKey":"","typeLabel":"string"}}},"responses":{"0b049973-517d-446e-9dc8-1aa4e1abd800":{"content":{"application/json":{"schema":{"items":{"properties":{"active_prompt_id":{"type":"string","uniqueKey":"items.[INDEX].active_prompt_id","typeLabel":"string"},"auth_mode":{"description":"AuthMode gates whether the embeddable widget allows anonymous\nvisitors. `public` accepts any visitor JWT; `authenticated` rejects\nguest tokens.","enum":["public","authenticated"],"example":"authenticated","type":"string","uniqueKey":"items.[INDEX].auth_mode","typeLabel":"enum\u003cstring>"},"background_audio_enabled":{"example":false,"type":"boolean","uniqueKey":"items.[INDEX].background_audio_enabled","typeLabel":"boolean"},"background_audio_volume":{"example":0.8,"type":"number","uniqueKey":"items.[INDEX].background_audio_volume","typeLabel":"number"},"category":{"enum":["customer_support","sales","operations","custom"],"example":"customer_support","type":"string","uniqueKey":"items.[INDEX].category","typeLabel":"enum\u003cstring>"},"created_at":{"type":"string","uniqueKey":"items.[INDEX].created_at","typeLabel":"string"},"created_by":{"example":"user_01HZ2N…","type":"string","uniqueKey":"items.[INDEX].created_by","typeLabel":"string"},"description":{"example":"Greets web visitors and answers product FAQs.","type":"string","uniqueKey":"items.[INDEX].description","typeLabel":"string"},"faqs":{"items":{"properties":{"category":{"type":"string","uniqueKey":"items.[INDEX].faqs.items.[INDEX].category","typeLabel":"string"},"content":{"type":"string","uniqueKey":"items.[INDEX].faqs.items.[INDEX].content","typeLabel":"string"},"id":{"type":"string","uniqueKey":"items.[INDEX].faqs.items.[INDEX].id","typeLabel":"string"},"name":{"type":"string","uniqueKey":"items.[INDEX].faqs.items.[INDEX].name","typeLabel":"string"},"summary":{"type":"string","uniqueKey":"items.[INDEX].faqs.items.[INDEX].summary","typeLabel":"string"},"title":{"type":"string","uniqueKey":"items.[INDEX].faqs.items.[INDEX].title","typeLabel":"string"}},"type":"object","uniqueKey":"items.[INDEX].faqs.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueItems":false,"uniqueKey":"items.[INDEX].faqs","typeLabel":"object[]"},"greeting_message":{"example":"Hi, this is the ACME front desk — how can I help?","type":"string","uniqueKey":"items.[INDEX].greeting_message","typeLabel":"string"},"greeting_mode":{"description":"GreetingMode controls whether the agent's opening line can be\nbarged-in by the caller (interruptible) or must finish (locked).","enum":["interruptible","locked"],"example":"interruptible","type":"string","uniqueKey":"items.[INDEX].greeting_mode","typeLabel":"enum\u003cstring>"},"id":{"example":"agent_01HZ2N…","type":"string","x-readonly":true,"uniqueKey":"items.[INDEX].id","typeLabel":"string"},"llm_model":{"enum":["gpt-4o","gpt-4o-mini","claude-3-5-sonnet"],"example":"gpt-4o","type":"string","uniqueKey":"items.[INDEX].llm_model","typeLabel":"enum\u003cstring>"},"name":{"example":"Front Desk","type":"string","uniqueKey":"items.[INDEX].name","typeLabel":"string"},"noise_suppression_enabled":{"example":true,"type":"boolean","uniqueKey":"items.[INDEX].noise_suppression_enabled","typeLabel":"boolean"},"playbooks":{"items":{"properties":{"category":{"type":"string","uniqueKey":"items.[INDEX].playbooks.items.[INDEX].category","typeLabel":"string"},"description":{"type":"string","uniqueKey":"items.[INDEX].playbooks.items.[INDEX].description","typeLabel":"string"},"display_name":{"type":"string","uniqueKey":"items.[INDEX].playbooks.items.[INDEX].display_name","typeLabel":"string"},"id":{"type":"string","uniqueKey":"items.[INDEX].playbooks.items.[INDEX].id","typeLabel":"string"},"name":{"type":"string","uniqueKey":"items.[INDEX].playbooks.items.[INDEX].name","typeLabel":"string"},"tool_names":{"items":{"type":"string","uniqueKey":"items.[INDEX].playbooks.items.[INDEX].tool_names.items.[INDEX]","typeLabel":"string"},"type":"array","uniqueItems":false,"uniqueKey":"items.[INDEX].playbooks.items.[INDEX].tool_names","typeLabel":"string[]"}},"type":"object","uniqueKey":"items.[INDEX].playbooks.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueItems":false,"uniqueKey":"items.[INDEX].playbooks","typeLabel":"object[]"},"ringing_enabled":{"example":true,"type":"boolean","uniqueKey":"items.[INDEX].ringing_enabled","typeLabel":"boolean"},"status":{"enum":["draft","active","archived"],"example":"active","type":"string","uniqueKey":"items.[INDEX].status","typeLabel":"enum\u003cstring>"},"system_prompt":{"example":"You are a friendly front-desk assistant for ACME Corp.","type":"string","uniqueKey":"items.[INDEX].system_prompt","typeLabel":"string"},"template_id":{"example":"tmpl_general_intake","type":"string","uniqueKey":"items.[INDEX].template_id","typeLabel":"string"},"updated_at":{"type":"string","uniqueKey":"items.[INDEX].updated_at","typeLabel":"string"},"voice_id":{"example":"v1_friendly_female","type":"string","uniqueKey":"items.[INDEX].voice_id","typeLabel":"string"},"voice_provider":{"enum":["cartesia","elevenlabs","deepgram"],"example":"cartesia","type":"string","uniqueKey":"items.[INDEX].voice_provider","typeLabel":"enum\u003cstring>"}},"type":"object","uniqueKey":"items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"","typeLabel":"object[]"},"examples":{"Example":{"title":"Example","value":[{"active_prompt_id":"\u003cstring>","auth_mode":"authenticated","background_audio_enabled":false,"background_audio_volume":0.8,"category":"customer_support","created_at":"\u003cstring>","created_by":"user_01HZ2N…","description":"Greets web visitors and answers product FAQs.","faqs":[{"category":"\u003cstring>","content":"\u003cstring>","id":"\u003cstring>","name":"\u003cstring>","summary":"\u003cstring>","title":"\u003cstring>"}],"greeting_message":"Hi, this is the ACME front desk — how can I help?","greeting_mode":"interruptible","id":"agent_01HZ2N…","llm_model":"gpt-4o","name":"Front Desk","noise_suppression_enabled":true,"playbooks":[{"category":"\u003cstring>","description":"\u003cstring>","display_name":"\u003cstring>","id":"\u003cstring>","name":"\u003cstring>","tool_names":["\u003cstring>"]}],"ringing_enabled":true,"status":"active","system_prompt":"You are a friendly front-desk assistant for ACME Corp.","template_id":"tmpl_general_intake","updated_at":"\u003cstring>","voice_id":"v1_friendly_female","voice_provider":"cartesia"}]}},"exampleType":"generated"}},"description":"Array of agents.","exampleType":"generated"},"100d6c37-c7a9-4429-92c3-1a889b512a4d":{"content":{"application/json":{"schema":{"type":"string","uniqueKey":"","typeLabel":"string"},"examples":{"Example":{"title":"Example","value":"\u003cstring>"}},"exampleType":"generated"}},"description":"Missing X-Account-ID header — caller is using a JWT but didn't supply the tenant header.","exampleType":"generated"},"d85c0e4c-74b2-41e5-b03c-544f992b4189":{"content":{"application/json":{"schema":{"type":"string","uniqueKey":"","typeLabel":"string"},"examples":{"Example":{"title":"Example","value":"\u003cstring>"}},"exampleType":"generated"}},"description":"Missing or invalid Authorization bearer token.","exampleType":"generated"},"cb085595-af5e-441a-bb3b-6ef70c5bfcf5":{"content":{"application/json":{"schema":{"type":"string","uniqueKey":"","typeLabel":"string"},"examples":{"Example":{"title":"Example","value":"\u003cstring>"}},"exampleType":"generated"}},"description":"Database error.","exampleType":"generated"}},"security":{"d6cf62b8-67b8-48fc-83e1-abb982dbf4a1":{"bearerAuth":{"in":"header","name":"Authorization","type":"apiKey","scopes":[]}}},"servers":{"2b33dff2-a1ab-4bf7-96af-68d2316e657d":{"url":"https://api.kataven.ai/v1","description":"Production (recommended for SDKs)"},"8147620e-ceb3-43ba-ae06-1e0839dcc10a":{"url":"https://hub.kataven.ai/hub-api/api","description":"Production (legacy path, kept for back-compat)"},"55e717d4-04d9-4e93-bdda-b992b33fc560":{"url":"http://localhost:8081","description":"Local development (api-server only)"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"in":"header","name":"Authorization","type":"apiKey","scopes":[]},"schema":{"title":"Authorization","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"api-spec/openapi.yaml"},"subdomain":"katavenai","siteName":"Kataven","title":"List agents - Kataven","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-05-08T20:37:27.640Z","originalFileLocation":"api-reference/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=\"Returns every agent in the caller\u0026#x27;s account, with attached playbooks and FAQs joined in. Ordered by created_at descending. There is no pagination today — every account has at most a few dozen agents in practice; if that changes we\u0026#x27;ll add limit/offset like /api/tools and /api/playbooks.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Kataven\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/katavenai/ctclNJiEvSssQ8vf/_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/katavenai/ctclNJiEvSssQ8vf/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/katavenai/ctclNJiEvSssQ8vf/_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/katavenai/ctclNJiEvSssQ8vf/_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/katavenai/ctclNJiEvSssQ8vf/_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/katavenai/ctclNJiEvSssQ8vf/_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/katavenai/ctclNJiEvSssQ8vf/_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/katavenai/ctclNJiEvSssQ8vf/_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/katavenai/ctclNJiEvSssQ8vf/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"List agents - Kataven\">\u003cmeta data-mint-head property=\"og:description\" content=\"Returns every agent in the caller\u0026#x27;s account, with attached playbooks and FAQs joined in. Ordered by created_at descending. There is no pagination today — every account has at most a few dozen agents in practice; if that changes we\u0026#x27;ll add limit/offset like /api/tools and /api/playbooks.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Kataven\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.kataven.ai/api-reference/agents/list-agents\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://katavenai.mintlify.app/_mintlify/api/og/v2?division=Agents\u0026amp;title=List+agents\u0026amp;description=Returns+every+agent+in+the+caller%27s+account%2C+with+attached+playbooks+and+FAQs+joined+in.+Ordered+by+%60created_at%60+descending.+There+is+no+pagination+today+%E2%80%94+ever\u0026amp;theme=0ed538260c0fcf374bac1c4c\u0026amp;signature=3604db1d4c8f6e9a39206a9b22921c5b9af308618211b2229bb3175b492888b1\">\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 - Kataven\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Returns every agent in the caller\u0026#x27;s account, with attached playbooks and FAQs joined in. Ordered by created_at descending. There is no pagination today — every account has at most a few dozen agents in practice; if that changes we\u0026#x27;ll add limit/offset like /api/tools and /api/playbooks.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://katavenai.mintlify.app/_mintlify/api/og/v2?division=Agents\u0026amp;title=List+agents\u0026amp;description=Returns+every+agent+in+the+caller%27s+account%2C+with+attached+playbooks+and+FAQs+joined+in.+Ordered+by+%60created_at%60+descending.+There+is+no+pagination+today+%E2%80%94+ever\u0026amp;theme=0ed538260c0fcf374bac1c4c\u0026amp;signature=3604db1d4c8f6e9a39206a9b22921c5b9af308618211b2229bb3175b492888b1\">\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/katavenai/ctclNJiEvSssQ8vf/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Kataven\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2563EB\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.kataven.ai/api-reference/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=\"/api-reference/agents/list-agents.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.kataven.ai/#organization\",\"name\":\"Kataven\",\"url\":\"https://docs.kataven.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/katavenai/2uMycxhxIwk_F2eE/images/logo.png?fit=max\u0026auto=format\u0026n=2uMycxhxIwk_F2eE\u0026q=85\u0026s=6cf130449ec06609915faad2826a4c60\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.kataven.ai#website\",\"name\":\"Kataven\",\"url\":\"https://docs.kataven.ai\",\"publisher\":{\"@id\":\"https://docs.kataven.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.kataven.ai/api-reference/agents/list-agents#webpage\",\"url\":\"https://docs.kataven.ai/api-reference/agents/list-agents\",\"name\":\"List agents\",\"description\":\"Returns every agent in the caller's account, with attached playbooks and FAQs joined in. Ordered by created_at descending. There is no pagination today — every account has at most a few dozen agents in practice; if that changes we'll add limit/offset like /api/tools and /api/playbooks.\",\"dateModified\":\"2026-05-08T20:37:27.640Z\",\"isPartOf\":{\"@id\":\"https://docs.kataven.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.kataven.ai/api-reference/agents/list-agents#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.kataven.ai/api-reference/agents/list-agents#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Resources\",\"item\":\"https://docs.kataven.ai/api-reference/agents\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Agents\",\"item\":\"https://docs.kataven.ai/api-reference/agents\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"List agents\",\"item\":\"https://docs.kataven.ai/api-reference/agents/list-agents\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.kataven.ai/api-reference/agents/list-agents#apireference\",\"headline\":\"List agents\",\"name\":\"List agents\",\"description\":\"Returns every agent in the caller's account, with attached playbooks and FAQs joined in. Ordered by created_at descending. There is no pagination today — every account has at most a few dozen agents in practice; if that changes we'll add limit/offset like /api/tools and /api/playbooks.\",\"url\":\"https://docs.kataven.ai/api-reference/agents/list-agents\",\"mainEntityOfPage\":{\"@id\":\"https://docs.kataven.ai/api-reference/agents/list-agents#webpage\"},\"dateModified\":\"2026-05-08T20:37:27.640Z\",\"publisher\":{\"@id\":\"https://docs.kataven.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.kataven.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Kataven\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Kataven","nav":{"global":null,"anchors":[{"anchor":"Documentation","icon":"book-open","pages":[{"title":"Documentation","href":"/introduction"}]},{"anchor":"API Reference","icon":"rectangle-terminal","groups":[{"group":"Get started","pages":[{"title":"Kataven Hub API Reference — voice AI REST API","sidebarTitle":"API Reference","href":"/api-reference/introduction"}]},{"group":"Resources","pages":[{"group":"Agents","pages":[{"title":"Kataven Hub API — agents endpoints","sidebarTitle":"Agents","description":"REST API reference for Kataven agents — list, get, create, update, delete, plus tool/playbook/FAQ associations.","href":"/api-reference/agents"},{"title":"List agents","deprecated":null,"version":null,"openapi":"/api-spec/openapi.yaml get /api/v1/agents","href":"/api-reference/agents/list-agents"},{"title":"Create an agent","description":"Persists a new agent in the caller's account. Required body fields: `name`. Most other fields default sensibly: `category=custom`, `status=draft`, `llm_model=gpt-4o`, `voice_provider=cartesia`, `auth_mode=authenticated`, `greeting_mode=interruptible`. Returns the inserted row, including server-set `id`, `created_at`, and `updated_at`. Attach playbooks and FAQs separately via `POST /api/agents/{id}/playbooks` and `POST /api/agents/{id}/faqs`.","deprecated":null,"version":null,"openapi":"/api-spec/openapi.yaml post /api/v1/agents","href":"/api-reference/agents/create-an-agent"},{"title":"Get an agent","deprecated":null,"version":null,"openapi":"/api-spec/openapi.yaml get /api/v1/agents/{id}","href":"/api-reference/agents/get-an-agent"},{"title":"Update an agent","deprecated":null,"version":null,"openapi":"/api-spec/openapi.yaml patch /api/v1/agents/{id}","href":"/api-reference/agents/update-an-agent"},{"title":"Delete an agent","deprecated":null,"version":null,"openapi":"/api-spec/openapi.yaml delete /api/v1/agents/{id}","href":"/api-reference/agents/delete-an-agent"},{"title":"Attach an FAQ to an agent","deprecated":null,"version":null,"openapi":"/api-spec/openapi.yaml post /api/v1/agents/{id}/faqs","href":"/api-reference/agents/attach-an-faq-to-an-agent"},{"title":"Detach an FAQ from an agent","deprecated":null,"version":null,"openapi":"/api-spec/openapi.yaml delete /api/v1/agents/{id}/faqs/{faqId}","href":"/api-reference/agents/detach-an-faq-from-an-agent"},{"title":"Attach a playbook to an agent","deprecated":null,"version":null,"openapi":"/api-spec/openapi.yaml post /api/v1/agents/{id}/playbooks","href":"/api-reference/agents/attach-a-playbook-to-an-agent"},{"title":"Detach a playbook from an agent","deprecated":null,"version":null,"openapi":"/api-spec/openapi.yaml delete /api/v1/agents/{id}/playbooks/{playbookId}","href":"/api-reference/agents/detach-a-playbook-from-an-agent"},{"title":"List tools attached to an agent","deprecated":null,"version":null,"openapi":"/api-spec/openapi.yaml get /api/v1/agents/{id}/tools","href":"/api-reference/agents/list-tools-attached-to-an-agent"},{"title":"Attach or update a tool on an agent","deprecated":null,"version":null,"openapi":"/api-spec/openapi.yaml post /api/v1/agents/{id}/tools","href":"/api-reference/agents/attach-or-update-a-tool-on-an-agent"}]},{"group":"Tools","pages":[{"title":"Kataven Hub API — tools endpoints","sidebarTitle":"Tools","href":"/api-reference/tools"},{"title":"List tools","deprecated":null,"version":null,"openapi":"/api-spec/openapi.yaml get /api/v1/tools","href":"/api-reference/tools/list-tools"},{"title":"Create a custom tool","deprecated":null,"version":null,"openapi":"/api-spec/openapi.yaml post /api/v1/tools","href":"/api-reference/tools/create-a-custom-tool"},{"title":"Get a single tool","deprecated":null,"version":null,"openapi":"/api-spec/openapi.yaml get /api/v1/tools/{id}","href":"/api-reference/tools/get-a-single-tool"},{"title":"Update a tool","deprecated":null,"version":null,"openapi":"/api-spec/openapi.yaml put /api/v1/tools/{id}","href":"/api-reference/tools/update-a-tool"},{"title":"Delete a custom tool","deprecated":null,"version":null,"openapi":"/api-spec/openapi.yaml delete /api/v1/tools/{id}","href":"/api-reference/tools/delete-a-custom-tool"}]},{"group":"Playbooks","pages":[{"title":"Kataven Hub API — playbooks endpoints","sidebarTitle":"Playbooks","href":"/api-reference/playbooks"},{"title":"List playbooks","deprecated":null,"version":null,"openapi":"/api-spec/openapi.yaml get /api/v1/playbooks","href":"/api-reference/playbooks/list-playbooks"},{"title":"Create a custom playbook","deprecated":null,"version":null,"openapi":"/api-spec/openapi.yaml post /api/v1/playbooks","href":"/api-reference/playbooks/create-a-custom-playbook"},{"title":"Get a single playbook","deprecated":null,"version":null,"openapi":"/api-spec/openapi.yaml get /api/v1/playbooks/{id}","href":"/api-reference/playbooks/get-a-single-playbook"},{"title":"Update a playbook","deprecated":null,"version":null,"openapi":"/api-spec/openapi.yaml put /api/v1/playbooks/{id}","href":"/api-reference/playbooks/update-a-playbook"},{"title":"Delete a custom playbook","deprecated":null,"version":null,"openapi":"/api-spec/openapi.yaml delete /api/v1/playbooks/{id}","href":"/api-reference/playbooks/delete-a-custom-playbook"}]},{"group":"FAQs","pages":[{"title":"Kataven Hub API — FAQs endpoints","sidebarTitle":"FAQs","href":"/api-reference/faqs"},{"title":"List FAQs","deprecated":null,"version":null,"openapi":"/api-spec/openapi.yaml get /api/v1/faqs","href":"/api-reference/faqs/list-faqs"},{"title":"Create an FAQ","deprecated":null,"version":null,"openapi":"/api-spec/openapi.yaml post /api/v1/faqs","href":"/api-reference/faqs/create-an-faq"},{"title":"Get a single FAQ","deprecated":null,"version":null,"openapi":"/api-spec/openapi.yaml get /api/v1/faqs/{id}","href":"/api-reference/faqs/get-a-single-faq"},{"title":"Update an FAQ","deprecated":null,"version":null,"openapi":"/api-spec/openapi.yaml put /api/v1/faqs/{id}","href":"/api-reference/faqs/update-an-faq"},{"title":"Delete an FAQ","deprecated":null,"version":null,"openapi":"/api-spec/openapi.yaml delete /api/v1/faqs/{id}","href":"/api-reference/faqs/delete-an-faq"}]},{"group":"Marketplace","pages":[{"title":"Kataven Hub API — marketplace endpoints","sidebarTitle":"Marketplace","href":"/api-reference/marketplace"},{"title":"List marketplace agent templates","deprecated":null,"version":null,"openapi":"/api-spec/openapi.yaml get /api/v1/marketplace/agents","href":"/api-reference/marketplace/list-marketplace-agent-templates"},{"title":"Get a marketplace agent template","deprecated":null,"version":null,"openapi":"/api-spec/openapi.yaml get /api/v1/marketplace/agents/{id}","href":"/api-reference/marketplace/get-a-marketplace-agent-template"},{"title":"Install a marketplace template as a new agent","deprecated":null,"version":null,"openapi":"/api-spec/openapi.yaml post /api/v1/marketplace/agents/{id}/install","href":"/api-reference/marketplace/install-a-marketplace-template-as-a-new-agent"},{"title":"List marketplace categories","deprecated":null,"version":null,"openapi":"/api-spec/openapi.yaml get /api/v1/marketplace/categories","href":"/api-reference/marketplace/list-marketplace-categories"}]},{"group":"Integrations","pages":[{"title":"Kataven Hub API — integrations endpoints","sidebarTitle":"Integrations","href":"/api-reference/integrations"},{"title":"List third-party integrations","deprecated":null,"version":null,"openapi":"/api-spec/openapi.yaml get /api/v1/integrations","href":"/api-reference/integrations/list-third-party-integrations"},{"title":"Get a single integration","deprecated":null,"version":null,"openapi":"/api-spec/openapi.yaml get /api/v1/integrations/{id}","href":"/api-reference/integrations/get-a-single-integration"},{"title":"Install an integration","deprecated":null,"version":null,"openapi":"/api-spec/openapi.yaml post /api/v1/integrations/{id}/install","href":"/api-reference/integrations/install-an-integration"},{"title":"Uninstall an integration","deprecated":null,"version":null,"openapi":"/api-spec/openapi.yaml post /api/v1/integrations/{id}/uninstall","href":"/api-reference/integrations/uninstall-an-integration"},{"title":"List MCP connections (stub)","deprecated":null,"version":null,"openapi":"/api-spec/openapi.yaml get /api/v1/mcp-connections","href":"/api-reference/integrations/list-mcp-connections-stub"},{"title":"List native tools (stub)","deprecated":null,"version":null,"openapi":"/api-spec/openapi.yaml get /api/v1/native-tools","href":"/api-reference/integrations/list-native-tools-stub"}]},{"group":"Telephony","pages":[{"title":"Kataven Hub API — telephony endpoints","sidebarTitle":"Telephony","href":"/api-reference/telephony"},{"title":"List phone numbers","deprecated":null,"version":null,"openapi":"/api-spec/openapi.yaml get /api/v1/telephony/numbers","href":"/api-reference/telephony/list-phone-numbers"},{"title":"Register a phone number","deprecated":null,"version":null,"openapi":"/api-spec/openapi.yaml post /api/v1/telephony/numbers","href":"/api-reference/telephony/register-a-phone-number"},{"title":"Pin or unpin a phone number to an agent","deprecated":null,"version":null,"openapi":"/api-spec/openapi.yaml patch /api/v1/telephony/numbers/{id}","href":"/api-reference/telephony/pin-or-unpin-a-phone-number-to-an-agent"},{"title":"Delete a phone number","deprecated":null,"version":null,"openapi":"/api-spec/openapi.yaml delete /api/v1/telephony/numbers/{id}","href":"/api-reference/telephony/delete-a-phone-number"},{"title":"List telephony provider credentials","deprecated":null,"version":null,"openapi":"/api-spec/openapi.yaml get /api/v1/telephony/providers","href":"/api-reference/telephony/list-telephony-provider-credentials"},{"title":"Add a telephony provider credential","deprecated":null,"version":null,"openapi":"/api-spec/openapi.yaml post /api/v1/telephony/providers","href":"/api-reference/telephony/add-a-telephony-provider-credential"},{"title":"Delete a telephony provider credential","deprecated":null,"version":null,"openapi":"/api-spec/openapi.yaml delete /api/v1/telephony/providers/{id}","href":"/api-reference/telephony/delete-a-telephony-provider-credential"}]},{"group":"Calls","pages":[{"title":"Kataven Hub API — outbound calls","sidebarTitle":"Calls","href":"/api-reference/calls"},{"title":"Originate an outbound call","deprecated":null,"version":null,"openapi":"/api-spec/openapi.yaml post /api/v1/calls/originate","href":"/api-reference/calls/originate-an-outbound-call"}]},{"group":"Recordings","pages":[{"title":"Kataven Hub API — call recordings","sidebarTitle":"Recordings","href":"/api-reference/recordings"},{"title":"Get a presigned URL for the call recording","deprecated":null,"version":null,"openapi":"/api-spec/openapi.yaml get /api/v1/sessions/{id}/recording","href":"/api-reference/recordings/get-a-presigned-url-for-the-call-recording"}]},{"group":"Call Limits","pages":[{"title":"Kataven Hub API — call limits (cost caps)","sidebarTitle":"Call Limits","href":"/api-reference/call-limits"},{"title":"Get this tenant's call limits","deprecated":null,"version":null,"openapi":"/api-spec/openapi.yaml get /api/v1/call-limits","href":"/api-reference/call-limits/get-this-tenants-call-limits"}]},{"group":"Campaigns","pages":[{"title":"Kataven Hub API — outbound campaigns","sidebarTitle":"Campaigns","href":"/api-reference/campaigns"},{"title":"List campaigns","deprecated":null,"version":null,"openapi":"/api-spec/openapi.yaml get /api/v1/campaigns","href":"/api-reference/campaigns/list-campaigns"},{"title":"Create a campaign","deprecated":null,"version":null,"openapi":"/api-spec/openapi.yaml post /api/v1/campaigns","href":"/api-reference/campaigns/create-a-campaign"},{"title":"Get a campaign","deprecated":null,"version":null,"openapi":"/api-spec/openapi.yaml get /api/v1/campaigns/{id}","href":"/api-reference/campaigns/get-a-campaign"},{"title":"Delete a campaign","deprecated":null,"version":null,"openapi":"/api-spec/openapi.yaml delete /api/v1/campaigns/{id}","href":"/api-reference/campaigns/delete-a-campaign"},{"title":"List contacts in a campaign","deprecated":null,"version":null,"openapi":"/api-spec/openapi.yaml get /api/v1/campaigns/{id}/contacts","href":"/api-reference/campaigns/list-contacts-in-a-campaign"},{"title":"Stream campaign events","deprecated":null,"version":null,"openapi":"/api-spec/openapi.yaml get /api/v1/campaigns/{id}/events","href":"/api-reference/campaigns/stream-campaign-events"},{"title":"Pause a running campaign","deprecated":null,"version":null,"openapi":"/api-spec/openapi.yaml post /api/v1/campaigns/{id}/pause","href":"/api-reference/campaigns/pause-a-running-campaign"},{"title":"Resume a paused campaign","deprecated":null,"version":null,"openapi":"/api-spec/openapi.yaml post /api/v1/campaigns/{id}/resume","href":"/api-reference/campaigns/resume-a-paused-campaign"},{"title":"Start a campaign","deprecated":null,"version":null,"openapi":"/api-spec/openapi.yaml post /api/v1/campaigns/{id}/start","href":"/api-reference/campaigns/start-a-campaign"},{"title":"Stop a campaign permanently","deprecated":null,"version":null,"openapi":"/api-spec/openapi.yaml post /api/v1/campaigns/{id}/stop","href":"/api-reference/campaigns/stop-a-campaign-permanently"}]},{"group":"API Keys","pages":[{"title":"Kataven Hub API — API keys (sk_live_)","sidebarTitle":"API Keys","href":"/api-reference/api-keys"},{"title":"List API keys","deprecated":null,"version":null,"openapi":"/api-spec/openapi.yaml get /api/v1/api-keys","href":"/api-reference/api-keys/list-api-keys"},{"title":"Create an API key (returns plaintext sk_live_ ONCE)","deprecated":null,"version":null,"openapi":"/api-spec/openapi.yaml post /api/v1/api-keys","href":"/api-reference/api-keys/create-an-api-key-returns-plaintext-sk_live_-once"},{"title":"Update or revoke an API key","deprecated":null,"version":null,"openapi":"/api-spec/openapi.yaml patch /api/v1/api-keys/{id}","href":"/api-reference/api-keys/update-or-revoke-an-api-key"},{"title":"Delete or soft-disable an API key","deprecated":null,"version":null,"openapi":"/api-spec/openapi.yaml delete /api/v1/api-keys/{id}","href":"/api-reference/api-keys/delete-or-soft-disable-an-api-key"}]},{"group":"Widget Keys","pages":[{"title":"Kataven Hub API — widget keys (pk_live_)","sidebarTitle":"Widget Keys","href":"/api-reference/widget-keys"},{"title":"List widget keys","deprecated":null,"version":null,"openapi":"/api-spec/openapi.yaml get /api/v1/widget-keys","href":"/api-reference/widget-keys/list-widget-keys"},{"title":"Create a widget key (returns plaintext pk_live_ ONCE)","deprecated":null,"version":null,"openapi":"/api-spec/openapi.yaml post /api/v1/widget-keys","href":"/api-reference/widget-keys/create-a-widget-key-returns-plaintext-pk_live_-once"},{"title":"Update or revoke a widget key","deprecated":null,"version":null,"openapi":"/api-spec/openapi.yaml patch /api/v1/widget-keys/{id}","href":"/api-reference/widget-keys/update-or-revoke-a-widget-key"},{"title":"Delete or soft-disable a widget key","deprecated":null,"version":null,"openapi":"/api-spec/openapi.yaml delete /api/v1/widget-keys/{id}","href":"/api-reference/widget-keys/delete-or-soft-disable-a-widget-key"}]},{"group":"Widget Settings","pages":[{"title":"Kataven Hub API — widget settings","sidebarTitle":"Widget Settings","href":"/api-reference/widget-admin"},{"title":"Get per-agent widget policy","deprecated":null,"version":null,"openapi":"/api-spec/openapi.yaml get /api/v1/agents/{id}/widget-settings","href":"/api-reference/widget-admin/get-per-agent-widget-policy"},{"title":"Update per-agent widget policy","deprecated":null,"version":null,"openapi":"/api-spec/openapi.yaml patch /api/v1/agents/{id}/widget-settings","href":"/api-reference/widget-admin/update-per-agent-widget-policy"},{"title":"Get account-level widget branding","deprecated":null,"version":null,"openapi":"/api-spec/openapi.yaml get /api/v1/widget-settings","href":"/api-reference/widget-admin/get-account-level-widget-branding"},{"title":"Update account-level widget branding","deprecated":null,"version":null,"openapi":"/api-spec/openapi.yaml patch /api/v1/widget-settings","href":"/api-reference/widget-admin/update-account-level-widget-branding"}]},{"group":"Widget Auth","pages":[{"title":"Kataven Hub API — widget visitor auth","sidebarTitle":"Widget Auth","href":"/api-reference/widget-auth"},{"title":"Exchange a server-minted visitor token for a widget session JWT","deprecated":null,"version":null,"openapi":"/api-spec/openapi.yaml post /api/v1/widget/auth/exchange","href":"/api-reference/widget-auth/exchange-a-server-minted-visitor-token-for-a-widget-session-jwt"},{"title":"Mint a guest visitor JWT for the embeddable widget","deprecated":null,"version":null,"openapi":"/api-spec/openapi.yaml post /api/v1/widget/auth/guest","href":"/api-reference/widget-auth/mint-a-guest-visitor-jwt-for-the-embeddable-widget"},{"title":"Refresh a widget session JWT","deprecated":null,"version":null,"openapi":"/api-spec/openapi.yaml post /api/v1/widget/auth/refresh","href":"/api-reference/widget-auth/refresh-a-widget-session-jwt"},{"title":"Mint a logged-in visitor JWT (server-to-server)","deprecated":null,"version":null,"openapi":"/api-spec/openapi.yaml post /api/v1/widget/auth/user-token","href":"/api-reference/widget-auth/mint-a-logged-in-visitor-jwt-server-to-server"},{"title":"Get the widget bootstrap config for a client_key","deprecated":null,"version":null,"openapi":"/api-spec/openapi.yaml get /api/v1/widget/config","href":"/api-reference/widget-auth/get-the-widget-bootstrap-config-for-a-client_key"}]}]}]},{"anchor":"Python SDK","icon":"python","pages":[{"title":"Python SDK","href":"/sdks/python/overview"}]},{"anchor":"Node SDK","icon":"node-js","pages":[{"title":"Node SDK","href":"/sdks/node/overview"}]}]},"title":"List agents - Kataven","buildId":"dpl_EnxDqhjaNc9a8MVa833TGULPd9uJ","deploymentId":"dpl_EnxDqhjaNc9a8MVa833TGULPd9uJ","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-26-lDe7V.js","utils-CWQmgYtH.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-4-Aw3rSD.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-C2zjXYA5.js","snippetPresets-DFmpFA7C.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-FJpQavWq.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-D_GvPF7k.js","shallow-Bs2ZB0NO.js","getApiPlaygroundDisplay-DCcqJJk-.js","CodeSnippet-DzDxawVe.js","CodeSnippets-aUr7fU-7.js","Page-CT9uE8Ip.js","getPastedJson-Y1fKsj_I.js","icon-DI4zTsDr.js","MethodPill-C0nDlmSQ.js","DuplicateIcon-NUXbx2nQ.js","createIcon-BdTHrPAi.js","DynamicMarkdown-CtpgKJwj.js","SectionHeading-B3x35tOt.js","axios-vUo_bRtp.js","Markdown-3OmurJMP.js","clsx-DMKzROTp.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-1ms6tsT-.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-Ke9xIMFx.js"]}