Chat with your Agents using the Cassidy Agents API
Use an API key to start chats with your Agents, send them messages, and read chat history from your own apps, internal tools, and backend services.
The Cassidy Agents API lets your applications chat with your Agents. Start a chat with an Agent, send it messages, read the replies, and mint tokens for secure embedded chats.
You need an API key. To create one, follow the steps in Deploy via
API.
Authenticate
An API key acts as the user who created it, with that user’s permissions. Send it as a bearer token in the Authorization header:
-H 'Authorization: Bearer YOUR_API_KEY'
Keep your API key secure. Call the API from your backend, never from browser
or mobile code, and don’t commit the key to version control.
Make your first request
Create a chat with an Agent. The Agent’s ID is shown on its Deploy via API tab:
Each endpoint has its own page in the API reference with its parameters and response format.
Download the API specification
The OpenAPI specification describes every endpoint. Use it to load the API into another tool, such as Postman or a code generator:
curl 'https://app.cassidyai.com/api/openapi.json'
API keys vs. Admin API keys
To pull organization-wide usage and activity into your own reports instead, use an Admin API key. Admin API keys act as your organization, not as a user, and can only read organization-wide data.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Cassidy","colors":{"primary":"#325ED1","light":"#547ADE","dark":"#2852BF"},"logo":{"light":"https://mintcdn.com/cassidy/wE0GgFgF7sg6yClA/logo/light.svg?fit=max\u0026auto=format\u0026n=wE0GgFgF7sg6yClA\u0026q=85\u0026s=a282ef0ea39b2568b4c0d9164c38a471","dark":"https://mintcdn.com/cassidy/wE0GgFgF7sg6yClA/logo/dark.svg?fit=max\u0026auto=format\u0026n=wE0GgFgF7sg6yClA\u0026q=85\u0026s=97b6c3e038ba04fb75c98291dce0f15e"},"favicon":"https://mintcdn.com/cassidy/OMxepbwbagSrdWXh/favicon.png?fit=max\u0026auto=format\u0026n=OMxepbwbagSrdWXh\u0026q=85\u0026s=e2b5f49115e3bdfcbf30f5793e849793","api":{"playground":{"display":"simple"}},"navbar":{"links":[{"href":"mailto:support@cassidyai.com","label":"Support"}],"primary":{"type":"button","label":"Get started","href":"https://app.cassidy.ai"}},"footer":{"socials":{"x":"https://x.com/Cassidy_AI","linkedin":"https://www.linkedin.com/company/cassidyai"}},"fonts":{"family":"Inter"},"integrations":{"intercom":{"appId":"n12guz9i"}},"contextual":{"options":["copy","download-spec"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"cassidy","hasAudioNarration":false,"actualSubdomain":"cassidy","customDomains":["docs.cassidyai.com"],"gitSource":{"type":"github","owner":"cassidyai","repo":"cassidy","deployBranch":"main","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":false},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6afca848841bac9cfe36da27","clientVersion":"0.0.4177","searchFilterCounts":[{"language":"default","tag":"Documentation","count":215},{"language":"default","tag":"Integrations","count":135},{"language":"default","tag":"Workflows","count":117},{"language":"default","tag":"Use Cases","count":112},{"language":"default","tag":"Actions","count":44},{"language":"default","tag":"Agents","count":37},{"language":"default","tag":"Sales","count":24},{"language":"default","tag":"Advanced","count":21},{"language":"default","tag":"Marketing","count":18},{"language":"default","tag":"Settings and admin","count":17}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"reference/agents-api","slug":"/reference/agents-api","pageMetadata":{"title":"Chat with your Agents using the Cassidy Agents API","description":"Use an API key to start chats with your Agents, send them messages, and read chat history from your own apps, internal tools, and backend services.","icon":"robot","href":"/reference/agents-api","hidden":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Use an API key to start chats with your Agents, send them messages, and read chat history from your own apps, internal tools, and backend services.\"\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,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,..._provideComponents(),...props.components},{CodeBlock,Heading,Info,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`The Cassidy Agents API lets your applications chat with your `,_jsx(_components.a,{href:`/agents/overview`,children:`Agents`}),`. Start a chat with an Agent, send it messages, read the replies, and mint tokens for `,_jsx(_components.a,{href:`/agents/deploy/embed#restrict-access-with-secure-tokens`,children:`secure embedded chats`}),`.`]}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[`You need an API key. To create one, follow the steps in `,_jsx(_components.a,{href:`/agents/deploy/api`,children:`Deploy via\nAPI`}),`.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`authenticate`,children:`Authenticate`}),`\n`,_jsxs(_components.p,{children:[`An API key acts as the user who created it, with that user’s permissions. Send it as a bearer token in the `,_jsx(_components.code,{children:`Authorization`}),` header:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`-H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Authorization: Bearer YOUR_API_KEY'`})]}),`\n`]})})}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`Keep your API key secure. Call the API from your backend, never from browser\nor mobile code, and don’t commit the key to version control.`})}),`\n`,_jsx(Heading,{level:`2`,id:`make-your-first-request`,children:`Make your first request`}),`\n`,_jsxs(_components.p,{children:[`Create a chat with an Agent. The Agent’s ID is shown on its `,_jsx(_components.strong,{children:`Deploy via API`}),` tab:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`4`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`4`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'https://app.cassidyai.com/api/assistants/thread/create'`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Authorization: Bearer YOUR_API_KEY'`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Content-Type: application/json'`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{\"assistant_id\": \"YOUR_AGENT_ID\"}'`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`The response contains a `,_jsx(_components.code,{children:`thread_id`}),`. Use it to send a message. The response contains the Agent’s reply:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`4`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`4`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'https://app.cassidyai.com/api/assistants/message/create'`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Authorization: Bearer YOUR_API_KEY'`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Content-Type: application/json'`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{\"thread_id\": \"YOUR_THREAD_ID\", \"message\": \"Summarize our refund policy\"}'`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`Each endpoint has its own page in the API reference with its parameters and response format.`}),`\n`,_jsx(Heading,{level:`2`,id:`download-the-api-specification`,children:`Download the API specification`}),`\n`,_jsx(_components.p,{children:`The OpenAPI specification describes every endpoint. Use it to load the API into another tool, such as Postman or a code generator:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'https://app.cassidyai.com/api/openapi.json'`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`api-keys-vs-admin-api-keys`,children:`API keys vs. Admin API keys`}),`\n`,_jsxs(_components.p,{children:[`To pull organization-wide usage and activity into your own reports instead, use an `,_jsx(_components.a,{href:`/reference/admin-api`,children:`Admin API key`}),`. Admin API keys act as your organization, not as a user, and can only read organization-wide data.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Chat with your Agents using the Cassidy Agents API","description":"Use an API key to start chats with your Agents, send them messages, and read chat history from your own apps, internal tools, and backend services.","icon":"robot","href":"/reference/agents-api","hidden":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Authenticate","slug":"authenticate","depth":2,"children":[]},{"title":"Make your first request","slug":"make-your-first-request","depth":2,"children":[]},{"title":"Download the API specification","slug":"download-the-api-specification","depth":2,"children":[]},{"title":"API keys vs. Admin API keys","slug":"api-keys-vs-admin-api-keys","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"cassidy","siteName":"Cassidy","title":"Chat with your Agents using the Cassidy Agents API - Cassidy","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-06T15:40:01.288Z","originalFileLocation":"reference/agents-api.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=\"Use an API key to start chats with your Agents, send them messages, and read chat history from your own apps, internal tools, and backend services.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Cassidy\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003cmeta data-mint-head name=\"robots\" content=\"noindex\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/cassidy/gcVXXkk00gvCM7Lb/_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/cassidy/gcVXXkk00gvCM7Lb/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/cassidy/gcVXXkk00gvCM7Lb/_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/cassidy/gcVXXkk00gvCM7Lb/_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/cassidy/gcVXXkk00gvCM7Lb/_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/cassidy/gcVXXkk00gvCM7Lb/_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/cassidy/gcVXXkk00gvCM7Lb/_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/cassidy/gcVXXkk00gvCM7Lb/_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/cassidy/gcVXXkk00gvCM7Lb/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Chat with your Agents using the Cassidy Agents API - Cassidy\">\u003cmeta data-mint-head property=\"og:description\" content=\"Use an API key to start chats with your Agents, send them messages, and read chat history from your own apps, internal tools, and backend services.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Cassidy\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.cassidyai.com/reference/agents-api\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://cassidy.mintlify.site/_mintlify/api/og/v2?division=Agents+API\u0026amp;title=Chat+with+your+Agents+using+the+Cassidy+Agents+API\u0026amp;description=Use+an+API+key+to+start+chats+with+your+Agents%2C+send+them+messages%2C+and+read+chat+history+from+your+own+apps%2C+internal+tools%2C+and+backend+services.\u0026amp;theme=fbeaa4c0b59d086bcec67451\u0026amp;signature=d56e10e77c12775afab7090ce15e43a8841478156941e8058dfe778eb465d23d\">\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=\"Chat with your Agents using the Cassidy Agents API - Cassidy\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Use an API key to start chats with your Agents, send them messages, and read chat history from your own apps, internal tools, and backend services.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://cassidy.mintlify.site/_mintlify/api/og/v2?division=Agents+API\u0026amp;title=Chat+with+your+Agents+using+the+Cassidy+Agents+API\u0026amp;description=Use+an+API+key+to+start+chats+with+your+Agents%2C+send+them+messages%2C+and+read+chat+history+from+your+own+apps%2C+internal+tools%2C+and+backend+services.\u0026amp;theme=fbeaa4c0b59d086bcec67451\u0026amp;signature=d56e10e77c12775afab7090ce15e43a8841478156941e8058dfe778eb465d23d\">\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/cassidy/gcVXXkk00gvCM7Lb/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Cassidy\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#325ED1\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.cassidyai.com/reference/agents-api\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/reference/agents-api.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.cassidyai.com/#organization\",\"name\":\"Cassidy\",\"url\":\"https://docs.cassidyai.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/cassidy/wE0GgFgF7sg6yClA/logo/light.svg?fit=max\u0026auto=format\u0026n=wE0GgFgF7sg6yClA\u0026q=85\u0026s=a282ef0ea39b2568b4c0d9164c38a471\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.cassidyai.com#website\",\"name\":\"Cassidy\",\"url\":\"https://docs.cassidyai.com\",\"publisher\":{\"@id\":\"https://docs.cassidyai.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.cassidyai.com/reference/agents-api#webpage\",\"url\":\"https://docs.cassidyai.com/reference/agents-api\",\"name\":\"Chat with your Agents using the Cassidy Agents API\",\"description\":\"Use an API key to start chats with your Agents, send them messages, and read chat history from your own apps, internal tools, and backend services.\",\"dateModified\":\"2026-11-06T15:40:01.288Z\",\"isPartOf\":{\"@id\":\"https://docs.cassidyai.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.cassidyai.com/reference/agents-api#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.cassidyai.com/reference/agents-api#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Cassidy\",\"item\":\"https://docs.cassidyai.com\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Chat with your Agents using the Cassidy Agents API\",\"item\":\"https://docs.cassidyai.com/reference/agents-api\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.cassidyai.com/reference/agents-api#article\",\"headline\":\"Chat with your Agents using the Cassidy Agents API\",\"name\":\"Chat with your Agents using the Cassidy Agents API\",\"description\":\"Use an API key to start chats with your Agents, send them messages, and read chat history from your own apps, internal tools, and backend services.\",\"url\":\"https://docs.cassidyai.com/reference/agents-api\",\"mainEntityOfPage\":{\"@id\":\"https://docs.cassidyai.com/reference/agents-api#webpage\"},\"dateModified\":\"2026-11-06T15:40:01.288Z\",\"publisher\":{\"@id\":\"https://docs.cassidyai.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.cassidyai.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Cassidy\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Cassidy\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/reference/agents-api.md","siteName":"Cassidy","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":""}]},{"tab":"Cassidy University","pages":[{"title":"Cassidy University","href":"/university"}]},{"tab":"Guides","pages":[{"title":"Guides","href":"/guides/chatting-with-an-agent"}]},{"tab":"Integrations","pages":[{"title":"Integrations","href":"/integrations/overview"}]},{"tab":"API Reference","hidden":true,"menu":[{"item":"Admin API","icon":"chart-column","description":"Pull organization-wide usage and activity.","pages":[{"title":"Admin API","href":"/reference/admin-api"}]},{"item":"Agents API","icon":"robot","description":"Chat with your Agents from your own apps.","groups":[{"group":"Agents API","pages":[{"title":"Chat with your Agents using the Cassidy Agents API","icon":"robot","href":"/reference/agents-api"},{"group":"Agents","pages":[{"title":"Creates a new chat with an assigned Agent","description":null,"deprecated":null,"version":null,"openapi":"https://app.cassidyai.com/api/openapi.json post /assistants/thread/create","href":"/api-reference/agents/creates-a-new-chat-with-an-assigned-agent"},{"title":"Sends a message to an existing chat","description":null,"deprecated":null,"version":null,"openapi":"https://app.cassidyai.com/api/openapi.json post /assistants/message/create","href":"/api-reference/agents/sends-a-message-to-an-existing-chat"},{"title":"Gets the messages in a thread","description":null,"deprecated":null,"version":null,"openapi":"https://app.cassidyai.com/api/openapi.json get /assistants/thread/get","href":"/api-reference/agents/gets-the-messages-in-a-thread"},{"title":"Gets the available threads","description":null,"deprecated":null,"version":null,"openapi":"https://app.cassidyai.com/api/openapi.json get /assistants/threads/get","href":"/api-reference/agents/gets-the-available-threads"},{"title":"Mints a short-lived token for authorizing an embedded chat session.","description":"Used for Agents with an embed deployment and secure token mode enabled. Use this endpoint from your backend after authenticating your user. Return the token to your frontend for iframe embeds or modal initialization. [Learn more here](https://docs.cassidyai.com/agents/deploy/embed#restrict-access-with-secure-tokens).","deprecated":null,"version":null,"openapi":"https://app.cassidyai.com/api/openapi.json post /assistants/embed/token/create","href":"/api-reference/agents/mints-a-short-lived-token-for-authorizing-an-embedded-chat-session"}]}]}]}]},{"tab":"Use Cases","pages":[{"title":"Use Cases","href":"/use-cases"}]}]},"basePath":"","title":"Chat with your Agents using the Cassidy Agents API - Cassidy","deploymentId":"dpl_HhUetB7eHHDAmK9T1Teip38TgFx9","buildId":"dpl_HhUetB7eHHDAmK9T1Teip38TgFx9","dynamics":[],"chunks":[]}