Written as the principal. The server records the channel and the credential in origin. Ask an assistant with directedAssistantId, a mention, or a reply to its message; the runs it starts come back in invocations.
An API key from your Devic console, sent as Authorization: Bearer <key>. An embedded front end sends a tenant-session token instead, so no API key reaches the browser, and an OAuth integration sends its access token. Missing, invalid or expired credentials get a 401. See Authentication.
Headers
X-Devic-User
string
Only with an API key: the userUID or email of a person of the key's account to act as, with that person's permissions. Without it, an API key acts as the account integration ("API"), which sees shared workspaces only. A person's token cannot name someone else.
devic-api-source
enum<string>
The client sending it; recorded as the message origin.channel (api otherwise).
Available options:
cli,
sdk
Path Parameters
wid
string
required
Workspace id
tid
string
required
Thread id
Body
application/json
text
string
required
Maximum string length: 32000
directedAssistantId
string
Ask this assistant of the workspace.
mentions
object[]
Typed mentions; each @label must appear in text. { kind: "everyone", id: "everyone", label: "everybody" } is @everybody: it notifies everyone who can read the thread and never asks an assistant. Not for guests from another account (403 EVERYONE_MENTION_NOT_ALLOWED); once every 10 minutes per author and thread (429 EVERYONE_MENTION_COOLDOWN, the message is not posted).
Show child attributes
replyToMessageId
string
attachmentIds
string[]
Maximum array length: 20
clientMessageId
string
Idempotency key: the same id and body return the same message; a different body is 409 CLIENT_MESSAGE_ID_REUSED. Generated when omitted.
Response
Success — wrapped as { success: true, data }
success
boolean
Example:
true
data
object
Show child attributes
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Devic Documentation","description":"Turn your SaaS AI-native with Devic. Build, deploy, and operate agents, assistants, MCP tools, RAG, and AI workflows from one platform.","colors":{"primary":"#4764E6","light":"#6F8EFF","dark":"#2C3A8C"},"logo":{"light":"https://mintcdn.com/devic/gabzi_FqrplBFOjV/logo/devic-light.svg?fit=max\u0026auto=format\u0026n=gabzi_FqrplBFOjV\u0026q=85\u0026s=ec3c30fed45bb07177168ad49854c2c5","dark":"https://mintcdn.com/devic/gabzi_FqrplBFOjV/logo/devic-dark.svg?fit=max\u0026auto=format\u0026n=gabzi_FqrplBFOjV\u0026q=85\u0026s=2b637f4060c2001b87f21305b19a4b9c","href":"https://app.devic.ai/"},"favicon":{"light":"https://mintcdn.com/devic/gabzi_FqrplBFOjV/favicon.svg?fit=max\u0026auto=format\u0026n=gabzi_FqrplBFOjV\u0026q=85\u0026s=78aacd249630ae953a05222ef3ca5b69","dark":"https://mintcdn.com/devic/gabzi_FqrplBFOjV/favicon.svg?fit=max\u0026auto=format\u0026n=gabzi_FqrplBFOjV\u0026q=85\u0026s=78aacd249630ae953a05222ef3ca5b69"},"navbar":{"links":[{"href":"mailto:info@devic.ai","label":"Support"}],"primary":{"type":"button","label":"Login","href":"https://app.devic.ai/"}},"footer":{"socials":{"x":"https://x.com/devic_ai","github":"https://github.com/devicai","linkedin":"https://www.linkedin.com/company/devicai"}},"integrations":{"ga4":{"measurementId":"G-8K836ZN854"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"thumbnails":{"background":"https://mintcdn.com/devic/w7qYRbVpXOedcE7E/images/5e60580e-c9b6-41ae-a6e5-984cf4648873.png?fit=max\u0026auto=format\u0026n=w7qYRbVpXOedcE7E\u0026q=85\u0026s=4f2220729f821080ee1ca120071a72a7"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"devic","hasAudioNarration":false,"actualSubdomain":"devic","customDomains":["docs.devic.ai"],"gitSource":{"type":"github","owner":"devicai","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6afdd4c7afe2907216368db3","clientVersion":"0.0.4177","searchFilterCounts":[{"language":"default","tag":"API reference","count":241},{"language":"default","tag":"Devic","count":92},{"language":"default","tag":"Agents","count":48},{"language":"default","tag":"Assistants","count":32},{"language":"default","tag":"Knowledge","count":25},{"language":"default","tag":"Environments","count":20},{"language":"default","tag":"Workspace Configuration","count":16},{"language":"default","tag":"Integrations","count":15},{"language":"default","tag":"Tool Servers","count":14},{"language":"default","tag":"MCPs","count":13}]},"assistantConfig":{"enableStarterQuestions":false},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"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},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/endpoint/post-api-v1-workspaces-wid-threads-tid-messages","slug":"/api-reference/endpoint/post-api-v1-workspaces-wid-threads-tid-messages","pageMetadata":{"title":"Write a message","openapi":"POST /v1/workspaces/{wid}/threads/{tid}/messages","description":"Written as the principal. The server records the channel and the credential in `origin`. Ask an assistant with `directedAssistantId`, a mention, or a reply to its message; the runs it starts come back in `invocations`.","href":"/api-reference/endpoint/post-api-v1-workspaces-wid-threads-tid-messages"},"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: [\"Written as the principal. The server records the channel and the credential in \", _jsx(_components.code, {\n children: \"origin\"\n }), \". Ask an assistant with \", _jsx(_components.code, {\n children: \"directedAssistantId\"\n }), \", a mention, or a reply to its message; the runs it starts come back in \", _jsx(_components.code, {\n children: \"invocations\"\n }), \".\"]\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":"Write a message","openapi":"POST /v1/workspaces/{wid}/threads/{tid}/messages","description":"Written as the principal. The server records the channel and the credential in `origin`. Ask an assistant with `directedAssistantId`, a mention, or a reply to its message; the runs it starts come back in `invocations`.","href":"/api-reference/endpoint/post-api-v1-workspaces-wid-threads-tid-messages"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Workspace Threads"],"summary":"Write a message","operationId":"sendWorkspaceMessage","description":"Written as the principal. The server records the channel and the credential in `origin`. Ask an assistant with `directedAssistantId`, a mention, or a reply to its message; the runs it starts come back in `invocations`.","security":["e75a816c-e744-4d97-9b54-cadc279704ac"],"parameters":["8cce5a88-aaa4-4ad8-ba9f-7d4ab2b63c7c","dc718136-ae86-4abf-be93-e62865490e87","cabc49a9-973e-4d71-943d-cac4c3a3d819","ec94ff82-ac6d-41ce-bc66-ad1f97fdc3df"],"responses":{"201":"1e17eec7-2654-4380-bf25-99ba441862d0","400":"65231bdf-c2b9-4442-8f84-c6d6e172879c","401":"ef7e4bb4-04ed-43a4-88f9-889486cb5842","403":"46d4c6ed-2925-4f07-b9ff-091a455d6970","404":"1f0a4ed5-30de-4894-b200-c5e6b19bb568","409":"496a921f-b88c-4dbb-b50b-d901f8aa607b","429":"d7bc4859-c419-40e3-aedf-99562609fb72","503":"1b154b35-aa9f-4a38-9dfa-60feb4c4f7ac"},"requestBody":"fa3f728b-c69c-4c58-ba5a-3f3a5c8f6e81","method":"post","type":"path","servers":["57a86d33-ca28-4e27-8fd3-9f5fecf53d62","fb6b3acb-9756-4a13-9b6d-a8f4976db7f0"],"path":"/v1/workspaces/{wid}/threads/{tid}/messages","baseUrlOptions":["https://api.devic.ai","https://staging-api.devic.ai"],"title":"Write a message","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"8cce5a88-aaa4-4ad8-ba9f-7d4ab2b63c7c":{"name":"X-Devic-User","in":"header","required":false,"schema":{"type":"string","isRequired":false,"description":"Only with an **API key**: the userUID or email of a person of the key's account to act as, with that person's permissions. Without it, an API key acts as the account integration (\"API\"), which sees shared workspaces only. A person's token cannot name someone else.","uniqueKey":"","typeLabel":"string"},"description":"Only with an **API key**: the userUID or email of a person of the key's account to act as, with that person's permissions. Without it, an API key acts as the account integration (\"API\"), which sees shared workspaces only. A person's token cannot name someone else."},"dc718136-ae86-4abf-be93-e62865490e87":{"name":"wid","in":"path","required":true,"description":"Workspace id","schema":{"type":"string","isRequired":true,"description":"Workspace id","uniqueKey":"","typeLabel":"string"}},"cabc49a9-973e-4d71-943d-cac4c3a3d819":{"name":"tid","in":"path","required":true,"description":"Thread id","schema":{"type":"string","isRequired":true,"description":"Thread id","uniqueKey":"","typeLabel":"string"}},"ec94ff82-ac6d-41ce-bc66-ad1f97fdc3df":{"name":"devic-api-source","in":"header","required":false,"schema":{"type":"string","enum":["cli","sdk"],"isRequired":false,"description":"The client sending it; recorded as the message `origin.channel` (`api` otherwise).","uniqueKey":"","typeLabel":"enum\u003cstring>"},"description":"The client sending it; recorded as the message `origin.channel` (`api` otherwise)."}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["text"],"properties":{"text":{"type":"string","maxLength":32000,"isRequired":true,"uniqueKey":"text","typeLabel":"string"},"directedAssistantId":{"type":"string","description":"Ask this assistant of the workspace.","uniqueKey":"directedAssistantId","typeLabel":"string"},"mentions":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string","enum":["user","assistant","everyone"],"uniqueKey":"mentions.items.[INDEX].kind","typeLabel":"enum\u003cstring>"},"id":{"type":"string","uniqueKey":"mentions.items.[INDEX].id","typeLabel":"string"},"label":{"type":"string","uniqueKey":"mentions.items.[INDEX].label","typeLabel":"string"}},"uniqueKey":"mentions.items.[INDEX]","typeLabel":"object"},"description":"Typed mentions; each `@label` must appear in `text`. `{ kind: \"everyone\", id: \"everyone\", label: \"everybody\" }` is `@everybody`: it notifies everyone who can read the thread and never asks an assistant. Not for guests from another account (`403 EVERYONE_MENTION_NOT_ALLOWED`); once every 10 minutes per author and thread (`429 EVERYONE_MENTION_COOLDOWN`, the message is not posted).","uniqueKey":"mentions","typeLabel":"object[]"},"replyToMessageId":{"type":"string","uniqueKey":"replyToMessageId","typeLabel":"string"},"attachmentIds":{"type":"array","items":{"type":"string","uniqueKey":"attachmentIds.items.[INDEX]","typeLabel":"string"},"maxItems":20,"uniqueKey":"attachmentIds","typeLabel":"string[]"},"clientMessageId":{"type":"string","description":"Idempotency key: the same id and body return the same message; a different body is `409 CLIENT_MESSAGE_ID_REUSED`. Generated when omitted.","uniqueKey":"clientMessageId","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"text":"\u003cstring>","directedAssistantId":"\u003cstring>","mentions":[{"id":"\u003cstring>","label":"\u003cstring>"}],"replyToMessageId":"\u003cstring>","attachmentIds":["\u003cstring>"],"clientMessageId":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"1e17eec7-2654-4380-bf25-99ba441862d0":{"description":"Success — wrapped as `{ success: true, data }`","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true,"uniqueKey":"success","typeLabel":"boolean"},"data":{"type":"object","properties":{"message":{"type":"object","properties":{"id":{"type":"string","uniqueKey":"data.message.id","typeLabel":"string"},"seq":{"type":"integer","uniqueKey":"data.message.seq","typeLabel":"integer"},"role":{"type":"string","enum":["user","assistant","system"],"uniqueKey":"data.message.role","typeLabel":"enum\u003cstring>"},"authorId":{"type":"string","description":"userUID, assistant id, or `api-key:\u003cid>` for the account integration.","uniqueKey":"data.message.authorId","typeLabel":"string"},"authorName":{"type":"string","uniqueKey":"data.message.authorName","typeLabel":"string"},"text":{"type":"string","uniqueKey":"data.message.text","typeLabel":"string"},"createdAt":{"type":"string","format":"date-time","uniqueKey":"data.message.createdAt","typeLabel":"string\u003cdate-time>"},"mentions":{"type":"array","items":{"type":"object","additionalProperties":true,"uniqueKey":"data.message.mentions.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.message.mentions","typeLabel":"object[]"},"replyToMessageId":{"type":"string","uniqueKey":"data.message.replyToMessageId","typeLabel":"string"},"directedAssistantId":{"type":"string","uniqueKey":"data.message.directedAssistantId","typeLabel":"string"},"attachmentIds":{"type":"array","items":{"type":"string","uniqueKey":"data.message.attachmentIds.items.[INDEX]","typeLabel":"string"},"uniqueKey":"data.message.attachmentIds","typeLabel":"string[]"},"origin":{"type":"object","description":"Set by the server on messages written through the public API, the CLI or the SDK. Absent on messages written in the apps. Cannot be set by the client.","properties":{"channel":{"type":"string","enum":["api","cli","sdk"],"uniqueKey":"data.message.origin.channel","typeLabel":"enum\u003cstring>"},"credential":{"type":"string","enum":["api_key","oauth","session"],"uniqueKey":"data.message.origin.credential","typeLabel":"enum\u003cstring>"},"apiKeyId":{"type":"string","uniqueKey":"data.message.origin.apiKeyId","typeLabel":"string"},"oauthClientId":{"type":"string","uniqueKey":"data.message.origin.oauthClientId","typeLabel":"string"},"onBehalfOf":{"type":"boolean","description":"An API key wrote it naming the author with `X-Devic-User`.","uniqueKey":"data.message.origin.onBehalfOf","typeLabel":"boolean"}},"uniqueKey":"data.message.origin","typeLabel":"object"}},"uniqueKey":"data.message","typeLabel":"object"},"invocations":{"type":"array","items":{"type":"object","description":"A run of an assistant answering a message.","properties":{"id":{"type":"string","uniqueKey":"data.invocations.items.[INDEX].id","typeLabel":"string"},"assistantId":{"type":"string","uniqueKey":"data.invocations.items.[INDEX].assistantId","typeLabel":"string"},"replyToMessageId":{"type":"string","uniqueKey":"data.invocations.items.[INDEX].replyToMessageId","typeLabel":"string"},"status":{"type":"string","enum":["queued","running","paused","waiting_connection","waiting_approval","waiting_input","awaiting_publication","completed","failed","cancelled","outcome_unknown"],"uniqueKey":"data.invocations.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"revision":{"type":"integer","description":"Send it back with `answer` and `approve`.","uniqueKey":"data.invocations.items.[INDEX].revision","typeLabel":"integer"},"requestedInput":{"type":"object","description":"Questions the run is waiting on (`waiting_input`): `{ id, title, questions: [{ id, question, type: single|multiple, options: [{ value, label }], allowOther, required }] }`.","additionalProperties":true,"uniqueKey":"data.invocations.items.[INDEX].requestedInput","typeLabel":"object"},"requestedAction":{"type":"object","description":"The tool call waiting for approval (`waiting_approval`). Its `id` is the `actionId` to approve.","additionalProperties":true,"uniqueKey":"data.invocations.items.[INDEX].requestedAction","typeLabel":"object"},"error":{"type":"string","uniqueKey":"data.invocations.items.[INDEX].error","typeLabel":"string"}},"uniqueKey":"data.invocations.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.invocations","typeLabel":"object[]"}},"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":true,"data":{"message":{"id":"\u003cstring>","seq":123,"role":"user","authorId":"\u003cstring>","authorName":"\u003cstring>","text":"\u003cstring>","createdAt":"2023-11-07T05:31:56Z","mentions":[{}],"replyToMessageId":"\u003cstring>","directedAssistantId":"\u003cstring>","attachmentIds":["\u003cstring>"],"origin":{"channel":"api","credential":"api_key","apiKeyId":"\u003cstring>","oauthClientId":"\u003cstring>","onBehalfOf":true}},"invocations":[{"id":"\u003cstring>","assistantId":"\u003cstring>","replyToMessageId":"\u003cstring>","status":"queued","revision":123,"requestedInput":{},"requestedAction":{},"error":"\u003cstring>"}]}}}},"exampleType":"generated"}},"exampleType":"generated"},"65231bdf-c2b9-4442-8f84-c6d6e172879c":{"description":"Bad request — invalid or inconsistent payload","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"ef7e4bb4-04ed-43a4-88f9-889486cb5842":{"description":"Unauthorized — missing or invalid credential","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"46d4c6ed-2925-4f07-b9ff-091a455d6970":{"description":"Forbidden — not a member, not enough workspace permission, or acting for someone the credential cannot act for","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"1f0a4ed5-30de-4894-b200-c5e6b19bb568":{"description":"Not found","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"496a921f-b88c-4dbb-b50b-d901f8aa607b":{"description":"Conflict — `clientMessageId` reused with a different body","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"d7bc4859-c419-40e3-aedf-99562609fb72":{"description":"Too many requests — `EVERYONE_MENTION_COOLDOWN`: `@everybody` was used in this thread by this author less than 10 minutes ago","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"1b154b35-aa9f-4a38-9dfa-60feb4c4f7ac":{"description":"`DIRECT_MESSAGE_MIGRATING` — this private conversation is being moved; retry in a few seconds","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}}},"security":{"e75a816c-e744-4d97-9b54-cadc279704ac":{"bearerAuth":{"type":"http","scheme":"bearer","description":"An API key from your Devic console, sent as `Authorization: Bearer \u003ckey>`. An embedded front end sends a tenant-session token instead, so no API key reaches the browser, and an OAuth integration sends its access token. Missing, invalid or expired credentials get a `401`. See [Authentication](/api-reference/introduction#authentication).","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"57a86d33-ca28-4e27-8fd3-9f5fecf53d62":{"url":"https://api.devic.ai","description":"Production server"},"fb6b3acb-9756-4a13-9b6d-a8f4976db7f0":{"url":"https://staging-api.devic.ai","description":"Staging server"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"An API key from your Devic console, sent as `Authorization: Bearer \u003ckey>`. An embedded front end sends a tenant-session token instead, so no API key reaches the browser, and an OAuth integration sends its access token. Missing, invalid or expired credentials get a `401`. See [Authentication](/api-reference/introduction#authentication).","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"An API key from your Devic console, sent as `Authorization: Bearer \u003ckey>`. An embedded front end sends a tenant-session token instead, so no API key reaches the browser, and an OAuth integration sends its access token. Missing, invalid or expired credentials get a `401`. See [Authentication](/api-reference/introduction#authentication).","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"devic","siteName":"Devic Documentation","title":"Write a message - Devic Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-18T14:26:00.488Z","originalFileLocation":"api-reference/endpoint/post-api-v1-workspaces-wid-threads-tid-messages.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=\"Written as the principal. The server records the channel and the credential in origin. Ask an assistant with directedAssistantId, a mention, or a reply to its message; the runs it starts come back in invocations.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Devic 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/devic/oZEAyyhd9yq0DCvd/_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/devic/oZEAyyhd9yq0DCvd/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/devic/oZEAyyhd9yq0DCvd/_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/devic/oZEAyyhd9yq0DCvd/_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/devic/oZEAyyhd9yq0DCvd/_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/devic/oZEAyyhd9yq0DCvd/_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/devic/oZEAyyhd9yq0DCvd/_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/devic/oZEAyyhd9yq0DCvd/_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/devic/oZEAyyhd9yq0DCvd/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Write a message - Devic Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Written as the principal. The server records the channel and the credential in origin. Ask an assistant with directedAssistantId, a mention, or a reply to its message; the runs it starts come back in invocations.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Devic Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.devic.ai/api-reference/endpoint/post-api-v1-workspaces-wid-threads-tid-messages\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://devic.mintlify.site/_mintlify/api/og/v2?division=Workspace+Threads\u0026amp;title=Write+a+message\u0026amp;description=Written+as+the+principal.+The+server+records+the+channel+and+the+credential+in+%60origin%60.+Ask+an+assistant+with+%60directedAssistantId%60%2C+a+mention%2C+or+a+reply+to+i\u0026amp;theme=95b260005b3b0c5cfb2d00ae\u0026amp;signature=c081f5cc86e9f9c8888b32b0fa6df78e1ac619c8ecaed2cef1e373f9b364e18a\">\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=\"Write a message - Devic Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Written as the principal. The server records the channel and the credential in origin. Ask an assistant with directedAssistantId, a mention, or a reply to its message; the runs it starts come back in invocations.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://devic.mintlify.site/_mintlify/api/og/v2?division=Workspace+Threads\u0026amp;title=Write+a+message\u0026amp;description=Written+as+the+principal.+The+server+records+the+channel+and+the+credential+in+%60origin%60.+Ask+an+assistant+with+%60directedAssistantId%60%2C+a+mention%2C+or+a+reply+to+i\u0026amp;theme=95b260005b3b0c5cfb2d00ae\u0026amp;signature=c081f5cc86e9f9c8888b32b0fa6df78e1ac619c8ecaed2cef1e373f9b364e18a\">\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/devic/oZEAyyhd9yq0DCvd/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Devic Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#4764E6\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.devic.ai/api-reference/endpoint/post-api-v1-workspaces-wid-threads-tid-messages\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/endpoint/post-api-v1-workspaces-wid-threads-tid-messages.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.devic.ai/#organization\",\"name\":\"Devic Documentation\",\"url\":\"https://docs.devic.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/devic/gabzi_FqrplBFOjV/logo/devic-light.svg?fit=max\u0026auto=format\u0026n=gabzi_FqrplBFOjV\u0026q=85\u0026s=ec3c30fed45bb07177168ad49854c2c5\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.devic.ai#website\",\"name\":\"Devic Documentation\",\"url\":\"https://docs.devic.ai\",\"publisher\":{\"@id\":\"https://docs.devic.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.devic.ai/api-reference/endpoint/post-api-v1-workspaces-wid-threads-tid-messages#webpage\",\"url\":\"https://docs.devic.ai/api-reference/endpoint/post-api-v1-workspaces-wid-threads-tid-messages\",\"name\":\"Write a message\",\"description\":\"Written as the principal. The server records the channel and the credential in origin. Ask an assistant with directedAssistantId, a mention, or a reply to its message; the runs it starts come back in invocations.\",\"dateModified\":\"2026-11-18T14:26:00.488Z\",\"isPartOf\":{\"@id\":\"https://docs.devic.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.devic.ai/api-reference/endpoint/post-api-v1-workspaces-wid-threads-tid-messages#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.devic.ai/api-reference/endpoint/post-api-v1-workspaces-wid-threads-tid-messages#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Workspace Threads\",\"item\":\"https://docs.devic.ai/api-reference/endpoint/get-api-v1-workspaces-threads\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Write a message\",\"item\":\"https://docs.devic.ai/api-reference/endpoint/post-api-v1-workspaces-wid-threads-tid-messages\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.devic.ai/api-reference/endpoint/post-api-v1-workspaces-wid-threads-tid-messages#apireference\",\"headline\":\"Write a message\",\"name\":\"Write a message\",\"description\":\"Written as the principal. The server records the channel and the credential in origin. Ask an assistant with directedAssistantId, a mention, or a reply to its message; the runs it starts come back in invocations.\",\"url\":\"https://docs.devic.ai/api-reference/endpoint/post-api-v1-workspaces-wid-threads-tid-messages\",\"mainEntityOfPage\":{\"@id\":\"https://docs.devic.ai/api-reference/endpoint/post-api-v1-workspaces-wid-threads-tid-messages#webpage\"},\"dateModified\":\"2026-11-18T14:26:00.488Z\",\"publisher\":{\"@id\":\"https://docs.devic.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.devic.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Devic Documentation\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Devic Documentation\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/endpoint/post-api-v1-workspaces-wid-threads-tid-messages.md","siteName":"Devic Documentation","nav":{"global":null,"tabs":[{"tab":"Devic","pages":[{"title":"Devic","href":"/devic/introduction"}]},{"tab":"API reference","groups":[{"group":"Introduction","pages":[{"title":"Introduction","href":"/api-reference/introduction"}]},{"group":"Models","pages":[{"title":"List models and reasoning efforts","openapi":"GET /v1/models","href":"/api-reference/endpoint/get-api-v1-models"}]},{"group":"Agents","pages":[{"title":"List all agents","openapi":"GET /v1/agents","href":"/api-reference/endpoint/get-api-v1-agents"},{"title":"Create a new agent","openapi":"POST /v1/agents","href":"/api-reference/endpoint/post-api-v1-agents"},{"title":"Get agent by ID","openapi":"GET /v1/agents/{agentId}","href":"/api-reference/endpoint/get-api-v1-agents-agentid"},{"title":"Update an agent","openapi":"PATCH /v1/agents/{agentId}","href":"/api-reference/endpoint/patch-api-v1-agents-agentid"},{"title":"Delete an agent","openapi":"DELETE /v1/agents/{agentId}","href":"/api-reference/endpoint/delete-api-v1-agents-agentid"},{"title":"Get unique tags from all agent threads","openapi":"GET /v1/agents/threads/tags","href":"/api-reference/endpoint/get-api-v1-agents-threads-tags"},{"title":"Get a specific thread by ID","openapi":"GET /v1/agents/threads/{threadId}","href":"/api-reference/endpoint/get-api-v1-agents-threads-threadid"},{"title":"Update a thread","openapi":"PATCH /v1/agents/threads/{threadId}","href":"/api-reference/endpoint/patch-api-v1-agents-threads-threadid"},{"title":"Get threads for an agent","openapi":"GET /v1/agents/{agentId}/threads","href":"/api-reference/endpoint/get-api-v1-agents-agentid-threads"},{"title":"Create a new thread for an agent","openapi":"POST /v1/agents/{agentId}/threads","href":"/api-reference/endpoint/post-api-v1-agents-agentid-threads"},{"title":"Get agent evaluation configuration","openapi":"GET /v1/agents/agents/{agentId}/evaluation-config","href":"/api-reference/endpoint/get-api-v1-agents-agents-agentid-evaluation-config"},{"title":"Update agent evaluation configuration","openapi":"PUT /v1/agents/agents/{agentId}/evaluation-config","href":"/api-reference/endpoint/put-api-v1-agents-agents-agentid-evaluation-config"},{"title":"Handle thread approval request","openapi":"POST /v1/agents/threads/{threadId}/approval","href":"/api-reference/endpoint/post-api-v1-agents-threads-threadid-approval"},{"title":"Complete a thread","openapi":"POST /v1/agents/threads/{threadId}/complete","href":"/api-reference/endpoint/post-api-v1-agents-threads-threadid-complete"},{"title":"Evaluate a thread","openapi":"POST /v1/agents/threads/{threadId}/evaluate","href":"/api-reference/endpoint/post-api-v1-agents-threads-threadid-evaluate"},{"title":"Get thread evaluation","openapi":"GET /v1/agents/threads/{threadId}/evaluation","href":"/api-reference/endpoint/get-api-v1-agents-threads-threadid-evaluation"},{"title":"Get all thread evaluations","openapi":"GET /v1/agents/threads/{threadId}/evaluations","href":"/api-reference/endpoint/get-api-v1-agents-threads-threadid-evaluations"},{"title":"Get feedback for a thread","openapi":"GET /v1/agents/threads/{threadId}/feedback","href":"/api-reference/endpoint/get-api-v1-agents-threads-threadid-feedback"},{"title":"Submit feedback for a thread message","openapi":"POST /v1/agents/threads/{threadId}/feedback","href":"/api-reference/endpoint/post-api-v1-agents-threads-threadid-feedback"},{"title":"Continue a thread with a user message","openapi":"POST /v1/agents/threads/{threadId}/messages","href":"/api-reference/endpoint/post-api-v1-agents-threads-threadid-messages"},{"title":"Pause a thread","openapi":"POST /v1/agents/threads/{threadId}/pause","href":"/api-reference/endpoint/post-api-v1-agents-threads-threadid-pause"},{"title":"Resume a thread","openapi":"POST /v1/agents/threads/{threadId}/resume","href":"/api-reference/endpoint/post-api-v1-agents-threads-threadid-resume"},{"title":"Search messages within a thread","openapi":"GET /v1/agents/threads/{threadId}/search","href":"/api-reference/endpoint/get-api-v1-agents-threads-threadid-search"},{"title":"Get daily costs for an agent","openapi":"GET /v1/agents/agents/{agentId}/costs/daily","href":"/api-reference/endpoint/get-api-v1-agents-agents-agentid-costs-daily"},{"title":"Get monthly costs for an agent","openapi":"GET /v1/agents/agents/{agentId}/costs/monthly","href":"/api-reference/endpoint/get-api-v1-agents-agents-agentid-costs-monthly"},{"title":"Get cost summary for an agent","openapi":"GET /v1/agents/agents/{agentId}/costs/summary","href":"/api-reference/endpoint/get-api-v1-agents-agents-agentid-costs-summary"},{"title":"Get unique tags from agent threads","openapi":"GET /v1/agents/agents/{agentId}/threads/tags","href":"/api-reference/endpoint/get-api-v1-agents-agents-agentid-threads-tags"},{"title":"Get specific thread evaluation by ID","openapi":"GET /v1/agents/threads/{threadId}/evaluations/{evaluationId}","href":"/api-reference/endpoint/get-api-v1-agents-threads-threadid-evaluations-evaluationid"}]},{"group":"Assistants","pages":[{"title":"Get all available assistant specializations","openapi":"GET /v1/assistants","href":"/api-reference/endpoint/get-api-v1-assistants"},{"title":"Create a new assistant","openapi":"POST /v1/assistants","href":"/api-reference/endpoint/post-api-v1-assistants"},{"title":"Get all chat histories with filters","openapi":"POST /v1/assistants/chats","href":"/api-reference/endpoint/post-api-v1-assistants-chats"},{"title":"Get unique tags from chat histories","openapi":"GET /v1/assistants/tags","href":"/api-reference/endpoint/get-api-v1-assistants-tags"},{"title":"Get a specific assistant specialization","openapi":"GET /v1/assistants/{identifier}","href":"/api-reference/endpoint/get-api-v1-assistants-identifier"},{"title":"Update an assistant","openapi":"PATCH /v1/assistants/{identifier}","href":"/api-reference/endpoint/patch-api-v1-assistants-identifier"},{"title":"Delete an assistant","openapi":"DELETE /v1/assistants/{identifier}","href":"/api-reference/endpoint/delete-api-v1-assistants-identifier"},{"title":"Get chat histories for an assistant","openapi":"GET /v1/assistants/{identifier}/chats","href":"/api-reference/endpoint/get-api-v1-assistants-identifier-chats"},{"title":"Process a message with an assistant","openapi":"POST /v1/assistants/{identifier}/messages","href":"/api-reference/endpoint/post-api-v1-assistants-identifier-messages"},{"title":"Get chat history for a conversation","openapi":"GET /v1/assistants/{identifier}/chats/{chatUid}","href":"/api-reference/endpoint/get-api-v1-assistants-identifier-chats-chatuid"},{"title":"Get feedback for a chat","openapi":"GET /v1/assistants/{identifier}/chats/{chatUid}/feedback","href":"/api-reference/endpoint/get-api-v1-assistants-identifier-chats-chatuid-feedback"},{"title":"Submit feedback for a chat message","openapi":"POST /v1/assistants/{identifier}/chats/{chatUid}/feedback","href":"/api-reference/endpoint/post-api-v1-assistants-identifier-chats-chatuid-feedback"},{"title":"Search messages within a chat","openapi":"GET /v1/assistants/{identifier}/chats/{chatUid}/search","href":"/api-reference/endpoint/get-api-v1-assistants-identifier-chats-chatuid-search"},{"title":"Stop an in-progress async chat","openapi":"POST /v1/assistants/{identifier}/chats/{chatUid}/stop","href":"/api-reference/endpoint/post-api-v1-assistants-identifier-chats-chatuid-stop"},{"title":"Submit tool responses (Model Interface Protocol)","openapi":"POST /v1/assistants/{identifier}/chats/{chatUid}/tool-response","href":"/api-reference/endpoint/post-api-v1-assistants-identifier-chats-chatuid-tool-response"},{"title":"Get real-time chat history","openapi":"GET /v1/assistants/{identifier}/chats/{chatUid}/realtime","href":"/api-reference/endpoint/get-api-v1-assistants-identifier-chats-chatuid-realtime"},{"title":"Follow real-time chat history (SSE)","openapi":"GET /v1/assistants/{identifier}/chats/{chatUid}/stream","href":"/api-reference/endpoint/get-api-v1-assistants-identifier-chats-chatuid-stream"}]},{"group":"Memory","pages":[{"title":"Core memory entries of the assistant’s bucket","openapi":"GET /v1/memory/assistants/{identifier}/core","href":"/api-reference/endpoint/get-api-v1-memory-assistants-identifier-core"},{"title":"Add a core memory entry","openapi":"POST /v1/memory/assistants/{identifier}/core","href":"/api-reference/endpoint/post-api-v1-memory-assistants-identifier-core"},{"title":"Edit a core memory entry","openapi":"PATCH /v1/memory/assistants/{identifier}/core/{entryId}","href":"/api-reference/endpoint/patch-api-v1-memory-assistants-identifier-core-entryid"},{"title":"Remove a core memory entry","openapi":"DELETE /v1/memory/assistants/{identifier}/core/{entryId}","href":"/api-reference/endpoint/delete-api-v1-memory-assistants-identifier-core-entryid"}]},{"group":"Workspaces","pages":[{"title":"Who this credential acts as","openapi":"GET /v1/workspaces/me","href":"/api-reference/endpoint/get-api-v1-workspaces-me"},{"title":"List workspaces","openapi":"GET /v1/workspaces","href":"/api-reference/endpoint/get-api-v1-workspaces"},{"title":"Create a workspace","openapi":"POST /v1/workspaces","href":"/api-reference/endpoint/post-api-v1-workspaces"},{"title":"Configuration catalog","openapi":"GET /v1/workspaces/catalog","href":"/api-reference/endpoint/get-api-v1-workspaces-catalog"},{"title":"Get a workspace","openapi":"GET /v1/workspaces/{wid}","href":"/api-reference/endpoint/get-api-v1-workspaces-wid"},{"title":"Update workspace settings","openapi":"PATCH /v1/workspaces/{wid}","href":"/api-reference/endpoint/patch-api-v1-workspaces-wid"}]},{"group":"Workspace Threads","pages":[{"title":"Search threads across workspaces","openapi":"GET /v1/workspaces/threads","href":"/api-reference/endpoint/get-api-v1-workspaces-threads"},{"title":"List direct messages","openapi":"GET /v1/workspaces/direct-messages","href":"/api-reference/endpoint/get-api-v1-workspaces-direct-messages"},{"title":"Open a direct message","openapi":"POST /v1/workspaces/direct-messages","href":"/api-reference/endpoint/post-api-v1-workspaces-direct-messages"},{"title":"List the threads of a workspace","openapi":"GET /v1/workspaces/{wid}/threads","href":"/api-reference/endpoint/get-api-v1-workspaces-wid-threads"},{"title":"Create a thread","openapi":"POST /v1/workspaces/{wid}/threads","href":"/api-reference/endpoint/post-api-v1-workspaces-wid-threads"},{"title":"Read a thread","openapi":"GET /v1/workspaces/{wid}/threads/{tid}","href":"/api-reference/endpoint/get-api-v1-workspaces-wid-threads-tid"},{"title":"Rename or archive a thread","openapi":"PATCH /v1/workspaces/{wid}/threads/{tid}","href":"/api-reference/endpoint/patch-api-v1-workspaces-wid-threads-tid"},{"title":"Page the messages of a thread","openapi":"GET /v1/workspaces/{wid}/threads/{tid}/messages","description":"By `seq`: `before` for older pages, `after` for only what is newer (not both).","href":"/api-reference/endpoint/get-api-v1-workspaces-wid-threads-tid-messages"},{"title":"Write a message","openapi":"POST /v1/workspaces/{wid}/threads/{tid}/messages","href":"/api-reference/endpoint/post-api-v1-workspaces-wid-threads-tid-messages"},{"title":"Mark a thread read","openapi":"POST /v1/workspaces/{wid}/threads/{tid}/read","description":"`{ throughSeq? }` — everything when omitted.","href":"/api-reference/endpoint/post-api-v1-workspaces-wid-threads-tid-read"},{"title":"Mark a thread unread","openapi":"POST /v1/workspaces/{wid}/threads/{tid}/unread","href":"/api-reference/endpoint/post-api-v1-workspaces-wid-threads-tid-unread"},{"title":"Answer, approve, cancel or retry a run","openapi":"POST /v1/workspaces/{wid}/threads/{tid}/invocations/{runId}/{action}","href":"/api-reference/endpoint/post-api-v1-workspaces-wid-threads-tid-invocations-runid-action"}]},{"group":"Workspace Files","pages":[{"title":"List the documents of a workspace","openapi":"GET /v1/workspaces/{wid}/documents","href":"/api-reference/endpoint/get-api-v1-workspaces-wid-documents"},{"title":"List the files of a thread","openapi":"GET /v1/workspaces/{wid}/threads/{tid}/files","href":"/api-reference/endpoint/get-api-v1-workspaces-wid-threads-tid-files"},{"title":"Download a file","openapi":"GET /v1/workspaces/{wid}/threads/{tid}/files/{fileId}/download","href":"/api-reference/endpoint/get-api-v1-workspaces-wid-threads-tid-files-fileid-download"}]},{"group":"Workspace Configuration","pages":[{"title":"Add a member or change their role","openapi":"PUT /v1/workspaces/{wid}/members/{userUID}","href":"/api-reference/endpoint/put-api-v1-workspaces-wid-members-useruid"},{"title":"Remove a member","openapi":"DELETE /v1/workspaces/{wid}/members/{userUID}","href":"/api-reference/endpoint/delete-api-v1-workspaces-wid-members-useruid"},{"title":"List the assistants of a workspace","openapi":"GET /v1/workspaces/{wid}/assistants","href":"/api-reference/endpoint/get-api-v1-workspaces-wid-assistants"},{"title":"Add an assistant","openapi":"POST /v1/workspaces/{wid}/assistants","href":"/api-reference/endpoint/post-api-v1-workspaces-wid-assistants"},{"title":"Get an assistant","openapi":"GET /v1/workspaces/{wid}/assistants/{aid}","href":"/api-reference/endpoint/get-api-v1-workspaces-wid-assistants-aid"},{"title":"Edit an assistant","openapi":"PATCH /v1/workspaces/{wid}/assistants/{aid}","href":"/api-reference/endpoint/patch-api-v1-workspaces-wid-assistants-aid"},{"title":"Remove an assistant","openapi":"DELETE /v1/workspaces/{wid}/assistants/{aid}","href":"/api-reference/endpoint/delete-api-v1-workspaces-wid-assistants-aid"},{"title":"Get knowledge, skills and environment","openapi":"GET /v1/workspaces/{wid}/resources","href":"/api-reference/endpoint/get-api-v1-workspaces-wid-resources"},{"title":"Set knowledge, skills and environment","openapi":"PUT /v1/workspaces/{wid}/resources","href":"/api-reference/endpoint/put-api-v1-workspaces-wid-resources"},{"title":"Knowledge you can attach","openapi":"GET /v1/workspaces/{wid}/knowledge/catalog","href":"/api-reference/endpoint/get-api-v1-workspaces-wid-knowledge-catalog"},{"title":"Skills you can attach","openapi":"GET /v1/workspaces/{wid}/skills/catalog","href":"/api-reference/endpoint/get-api-v1-workspaces-wid-skills-catalog"},{"title":"Get the workspace rules","openapi":"GET /v1/workspaces/{wid}/rules","href":"/api-reference/endpoint/get-api-v1-workspaces-wid-rules"},{"title":"Set the workspace rules","openapi":"PUT /v1/workspaces/{wid}/rules","href":"/api-reference/endpoint/put-api-v1-workspaces-wid-rules"},{"title":"Earlier versions of the rules","openapi":"GET /v1/workspaces/{wid}/rules/history","href":"/api-reference/endpoint/get-api-v1-workspaces-wid-rules-history"},{"title":"Get the rules of a thread","openapi":"GET /v1/workspaces/{wid}/threads/{tid}/rules","href":"/api-reference/endpoint/get-api-v1-workspaces-wid-threads-tid-rules"},{"title":"Set the rules of a thread","openapi":"PUT /v1/workspaces/{wid}/threads/{tid}/rules","href":"/api-reference/endpoint/put-api-v1-workspaces-wid-threads-tid-rules"}]},{"group":"Workspace Memory","pages":[{"title":"Read core memory","openapi":"GET /v1/workspaces/{wid}/assistants/{aid}/memory/core","href":"/api-reference/endpoint/get-api-v1-workspaces-wid-assistants-aid-memory-core"},{"title":"Add a memory entry","openapi":"POST /v1/workspaces/{wid}/assistants/{aid}/memory/core","href":"/api-reference/endpoint/post-api-v1-workspaces-wid-assistants-aid-memory-core"},{"title":"Edit a memory entry","openapi":"PATCH /v1/workspaces/{wid}/assistants/{aid}/memory/core/{entryId}","href":"/api-reference/endpoint/patch-api-v1-workspaces-wid-assistants-aid-memory-core-entryid"},{"title":"Delete a memory entry","openapi":"DELETE /v1/workspaces/{wid}/assistants/{aid}/memory/core/{entryId}","href":"/api-reference/endpoint/delete-api-v1-workspaces-wid-assistants-aid-memory-core-entryid"}]},{"group":"Workspace Automations","pages":[{"title":"List automations","openapi":"GET /v1/workspaces/{wid}/automations","href":"/api-reference/endpoint/get-api-v1-workspaces-wid-automations"},{"title":"Create an automation","openapi":"POST /v1/workspaces/{wid}/automations","href":"/api-reference/endpoint/post-api-v1-workspaces-wid-automations"},{"title":"Preview a schedule","openapi":"POST /v1/workspaces/{wid}/automations/schedule-preview","href":"/api-reference/endpoint/post-api-v1-workspaces-wid-automations-schedule-preview"},{"title":"Automation capabilities","openapi":"GET /v1/workspaces/{wid}/automations/capabilities","href":"/api-reference/endpoint/get-api-v1-workspaces-wid-automations-capabilities"},{"title":"List automation destinations","openapi":"GET /v1/workspaces/{wid}/automations/destinations","href":"/api-reference/endpoint/get-api-v1-workspaces-wid-automations-destinations"},{"title":"List destination assistants","openapi":"GET /v1/workspaces/{wid}/automations/destinations/{target}/assistants","href":"/api-reference/endpoint/get-api-v1-workspaces-wid-automations-destinations-target-assistants"},{"title":"Find destination threads","openapi":"GET /v1/workspaces/{wid}/automations/destinations/{target}/threads","href":"/api-reference/endpoint/get-api-v1-workspaces-wid-automations-destinations-target-threads"},{"title":"Read a destination thread","openapi":"GET /v1/workspaces/{wid}/automations/destinations/{target}/threads/{tid}","href":"/api-reference/endpoint/get-api-v1-workspaces-wid-automations-destinations-target-threads-tid"},{"title":"List automation connections","openapi":"GET /v1/workspaces/{wid}/automations/connections","href":"/api-reference/endpoint/get-api-v1-workspaces-wid-automations-connections"},{"title":"Get api v1 workspaces wid automations connections cid tools","href":"/api-reference/endpoint/get-api-v1-workspaces-wid-automations-connections-cid-tools"},{"title":"Search app event triggers","openapi":"GET /v1/workspaces/{wid}/automations/triggers","href":"/api-reference/endpoint/get-api-v1-workspaces-wid-automations-triggers"},{"title":"Get an event trigger","openapi":"GET /v1/workspaces/{wid}/automations/triggers/{slug}","href":"/api-reference/endpoint/get-api-v1-workspaces-wid-automations-triggers-slug"},{"title":"Save an automation draft","openapi":"PUT /v1/workspaces/{wid}/automations/{automationId}/draft","href":"/api-reference/endpoint/put-api-v1-workspaces-wid-automations-automationid-draft"},{"title":"Get an automation","openapi":"GET /v1/workspaces/{wid}/automations/{automationId}","href":"/api-reference/endpoint/get-api-v1-workspaces-wid-automations-automationid"},{"title":"Delete an automation","openapi":"DELETE /v1/workspaces/{wid}/automations/{automationId}","href":"/api-reference/endpoint/delete-api-v1-workspaces-wid-automations-automationid"},{"title":"Edit an automation","openapi":"PATCH /v1/workspaces/{wid}/automations/{automationId}/settings","href":"/api-reference/endpoint/patch-api-v1-workspaces-wid-automations-automationid-settings"},{"title":"Activate, pause, invoke or test","openapi":"POST /v1/workspaces/{wid}/automations/{automationId}/{action}","href":"/api-reference/endpoint/post-api-v1-workspaces-wid-automations-automationid-action"},{"title":"List automation runs","openapi":"GET /v1/workspaces/{wid}/automation-runs","href":"/api-reference/endpoint/get-api-v1-workspaces-wid-automation-runs"},{"title":"Get an automation run","openapi":"GET /v1/workspaces/{wid}/automation-runs/{runId}","href":"/api-reference/endpoint/get-api-v1-workspaces-wid-automation-runs-runid"},{"title":"Summary of an automation run","openapi":"GET /v1/workspaces/{wid}/automation-runs/{runId}/summary","href":"/api-reference/endpoint/get-api-v1-workspaces-wid-automation-runs-runid-summary"},{"title":"Run it again","openapi":"POST /v1/workspaces/{wid}/automation-runs/{runId}/rerun","href":"/api-reference/endpoint/post-api-v1-workspaces-wid-automation-runs-runid-rerun"}]},{"group":"Workspace Integrations","pages":[{"title":"Search connectable apps","openapi":"GET /v1/workspaces/{wid}/integrations/catalog","href":"/api-reference/endpoint/get-api-v1-workspaces-wid-integrations-catalog"},{"title":"List connections","openapi":"GET /v1/workspaces/{wid}/connections","href":"/api-reference/endpoint/get-api-v1-workspaces-wid-connections"},{"title":"Connect an app","openapi":"POST /v1/workspaces/{wid}/connections","href":"/api-reference/endpoint/post-api-v1-workspaces-wid-connections"},{"title":"Reconnect an app","openapi":"POST /v1/workspaces/{wid}/connections/{cid}/reconnect","href":"/api-reference/endpoint/post-api-v1-workspaces-wid-connections-cid-reconnect"},{"title":"Enable my account here","openapi":"POST /v1/workspaces/{wid}/connections/{cid}/grant","href":"/api-reference/endpoint/post-api-v1-workspaces-wid-connections-cid-grant"},{"title":"Disable my account here","openapi":"DELETE /v1/workspaces/{wid}/connections/{cid}/grant","href":"/api-reference/endpoint/delete-api-v1-workspaces-wid-connections-cid-grant"}]},{"group":"Tool Servers","pages":[{"title":"List all tool servers","openapi":"GET /v1/tool-servers","href":"/api-reference/endpoint/get-api-v1-tool-servers"},{"title":"Create a new tool server","openapi":"POST /v1/tool-servers","href":"/api-reference/endpoint/post-api-v1-tool-servers"},{"title":"Get tool server by ID","openapi":"GET /v1/tool-servers/{toolServerId}","href":"/api-reference/endpoint/get-api-v1-tool-servers-toolserverid"},{"title":"Update tool server","openapi":"PATCH /v1/tool-servers/{toolServerId}","href":"/api-reference/endpoint/patch-api-v1-tool-servers-toolserverid"},{"title":"Delete tool server","openapi":"DELETE /v1/tool-servers/{toolServerId}","href":"/api-reference/endpoint/delete-api-v1-tool-servers-toolserverid"},{"title":"Clone a tool server","openapi":"POST /v1/tool-servers/{toolServerId}/clone","href":"/api-reference/endpoint/post-api-v1-tool-servers-toolserverid-clone"},{"title":"Get tool server definition","openapi":"GET /v1/tool-servers/{toolServerId}/definition","href":"/api-reference/endpoint/get-api-v1-tool-servers-toolserverid-definition"},{"title":"Update tool server definition","openapi":"PATCH /v1/tool-servers/{toolServerId}/definition","href":"/api-reference/endpoint/patch-api-v1-tool-servers-toolserverid-definition"},{"title":"Get all tools in a tool server","openapi":"GET /v1/tool-servers/{toolServerId}/tools","href":"/api-reference/endpoint/get-api-v1-tool-servers-toolserverid-tools"},{"title":"Add a tool to a tool server","openapi":"POST /v1/tool-servers/{toolServerId}/tools","href":"/api-reference/endpoint/post-api-v1-tool-servers-toolserverid-tools"},{"title":"Get a specific tool by name","openapi":"GET /v1/tool-servers/{toolServerId}/tools/{toolName}","href":"/api-reference/endpoint/get-api-v1-tool-servers-toolserverid-tools-toolname"},{"title":"Update a tool by name","openapi":"PATCH /v1/tool-servers/{toolServerId}/tools/{toolName}","href":"/api-reference/endpoint/patch-api-v1-tool-servers-toolserverid-tools-toolname"},{"title":"Delete a tool by name","openapi":"DELETE /v1/tool-servers/{toolServerId}/tools/{toolName}","href":"/api-reference/endpoint/delete-api-v1-tool-servers-toolserverid-tools-toolname"},{"title":"Test a tool call","openapi":"POST /v1/tool-servers/{toolServerId}/tools/{toolName}/test","href":"/api-reference/endpoint/post-api-v1-tool-servers-toolserverid-tools-toolname-test"}]},{"group":"MCP Gateway","pages":[{"title":"List visibility profiles","openapi":"GET /v1/tool-servers/{toolServerId}/profiles","href":"/api-reference/endpoint/get-api-v1-tool-servers-toolserverid-profiles"},{"title":"Create a visibility profile","openapi":"POST /v1/tool-servers/{toolServerId}/profiles","href":"/api-reference/endpoint/post-api-v1-tool-servers-toolserverid-profiles"},{"title":"List per-user access","openapi":"GET /v1/tool-servers/{toolServerId}/users","href":"/api-reference/endpoint/get-api-v1-tool-servers-toolserverid-users"},{"title":"Update a visibility profile","openapi":"PATCH /v1/tool-servers/{toolServerId}/profiles/{profileId}","href":"/api-reference/endpoint/patch-api-v1-tool-servers-toolserverid-profiles-profileid"},{"title":"Delete a visibility profile","openapi":"DELETE /v1/tool-servers/{toolServerId}/profiles/{profileId}","href":"/api-reference/endpoint/delete-api-v1-tool-servers-toolserverid-profiles-profileid"},{"title":"Set a user’s access and visibility","openapi":"PATCH /v1/tool-servers/{toolServerId}/users/{userUID}","href":"/api-reference/endpoint/patch-api-v1-tool-servers-toolserverid-users-useruid"},{"title":"Remove a user’s access row","openapi":"DELETE /v1/tool-servers/{toolServerId}/users/{userUID}","href":"/api-reference/endpoint/delete-api-v1-tool-servers-toolserverid-users-useruid"}]},{"group":"Integrations","pages":[{"title":"List connectable apps","openapi":"GET /v1/integrations","href":"/api-reference/endpoint/get-api-v1-integrations"},{"title":"List connected integrations","openapi":"GET /v1/integrations/connected","href":"/api-reference/endpoint/get-api-v1-integrations-connected"},{"title":"Get a connectable app","openapi":"GET /v1/integrations/{app}","href":"/api-reference/endpoint/get-api-v1-integrations-app"},{"title":"How an app can be connected","openapi":"GET /v1/integrations/{app}/auth","href":"/api-reference/endpoint/get-api-v1-integrations-app-auth"},{"title":"Connect an account","openapi":"POST /v1/integrations/{app}/connect","href":"/api-reference/endpoint/post-api-v1-integrations-app-connect"},{"title":"Whether an account is connected","openapi":"GET /v1/integrations/{app}/connection-status","href":"/api-reference/endpoint/get-api-v1-integrations-app-connection-status"},{"title":"Build a tool server from a connected account","openapi":"POST /v1/integrations/{app}/servers","href":"/api-reference/endpoint/post-api-v1-integrations-app-servers"},{"title":"List an app’s event types","openapi":"GET /v1/integrations/{app}/triggers","href":"/api-reference/endpoint/get-api-v1-integrations-app-triggers"},{"title":"List a connected integration’s tools","openapi":"GET /v1/integrations/servers/{id}/tools","href":"/api-reference/endpoint/get-api-v1-integrations-servers-id-tools"},{"title":"Change which tools a connected integration exposes","openapi":"PATCH /v1/integrations/servers/{id}/tools","href":"/api-reference/endpoint/patch-api-v1-integrations-servers-id-tools"},{"title":"Get an event type","openapi":"GET /v1/integrations/{app}/triggers/{slug}","href":"/api-reference/endpoint/get-api-v1-integrations-app-triggers-slug"},{"title":"Test one of a connected integration’s tools","openapi":"POST /v1/integrations/servers/{id}/tools/{toolName}/test","href":"/api-reference/endpoint/post-api-v1-integrations-servers-id-tools-toolname-test"}]},{"group":"Triggers","pages":[{"title":"List triggers","openapi":"GET /v1/triggers","href":"/api-reference/endpoint/get-api-v1-triggers"},{"title":"Create a trigger","openapi":"POST /v1/triggers","href":"/api-reference/endpoint/post-api-v1-triggers"},{"title":"Get a trigger","openapi":"GET /v1/triggers/{id}","href":"/api-reference/endpoint/get-api-v1-triggers-id"},{"title":"Update a trigger","openapi":"PATCH /v1/triggers/{id}","href":"/api-reference/endpoint/patch-api-v1-triggers-id"},{"title":"Delete a trigger","openapi":"DELETE /v1/triggers/{id}","href":"/api-reference/endpoint/delete-api-v1-triggers-id"},{"title":"List a trigger’s recent deliveries","openapi":"GET /v1/triggers/{id}/events","href":"/api-reference/endpoint/get-api-v1-triggers-id-events"}]},{"group":"Projects","pages":[{"title":"List all projects","openapi":"GET /v1/projects","href":"/api-reference/endpoint/get-api-v1-projects"},{"title":"Create a new project","openapi":"POST /v1/projects","href":"/api-reference/endpoint/post-api-v1-projects"},{"title":"Get a project by ID","openapi":"GET /v1/projects/{projectId}","href":"/api-reference/endpoint/get-api-v1-projects-projectid"},{"title":"Update a project","openapi":"PATCH /v1/projects/{projectId}","href":"/api-reference/endpoint/patch-api-v1-projects-projectid"},{"title":"Archive a project","openapi":"DELETE /v1/projects/{projectId}","href":"/api-reference/endpoint/delete-api-v1-projects-projectid"},{"title":"List project assistant conversations","openapi":"GET /v1/projects/{projectId}/conversations","href":"/api-reference/endpoint/get-api-v1-projects-projectid-conversations"},{"title":"Get project stats summary","openapi":"GET /v1/projects/{projectId}/stats","href":"/api-reference/endpoint/get-api-v1-projects-projectid-stats"},{"title":"List project agent threads","openapi":"GET /v1/projects/{projectId}/threads","href":"/api-reference/endpoint/get-api-v1-projects-projectid-threads"},{"title":"Get daily costs for a project","openapi":"GET /v1/projects/{projectId}/costs/daily","href":"/api-reference/endpoint/get-api-v1-projects-projectid-costs-daily"},{"title":"Get monthly costs for a project","openapi":"GET /v1/projects/{projectId}/costs/monthly","href":"/api-reference/endpoint/get-api-v1-projects-projectid-costs-monthly"}]},{"group":"Tenants","pages":[{"title":"List tenants","openapi":"GET /v1/tenants","href":"/api-reference/endpoint/get-api-v1-tenants"},{"title":"Get a tenant","openapi":"GET /v1/tenants/{tenantId}","href":"/api-reference/endpoint/get-api-v1-tenants-tenantid"},{"title":"Update a tenant","openapi":"PATCH /v1/tenants/{tenantId}","href":"/api-reference/endpoint/patch-api-v1-tenants-tenantid"},{"title":"Delete a tenant","openapi":"DELETE /v1/tenants/{tenantId}","href":"/api-reference/endpoint/delete-api-v1-tenants-tenantid"},{"title":"Get tenant costs","openapi":"GET /v1/tenants/{tenantId}/costs","href":"/api-reference/endpoint/get-api-v1-tenants-tenantid-costs"},{"title":"Get tenant stats","openapi":"GET /v1/tenants/{tenantId}/stats","href":"/api-reference/endpoint/get-api-v1-tenants-tenantid-stats"},{"title":"List subtenants","openapi":"GET /v1/tenants/{tenantId}/subtenants","href":"/api-reference/endpoint/get-api-v1-tenants-tenantid-subtenants"},{"title":"Get a subtenant","openapi":"GET /v1/tenants/{tenantId}/subtenants/{subtenantId}","href":"/api-reference/endpoint/get-api-v1-tenants-tenantid-subtenants-subtenantid"},{"title":"Update a subtenant (name, avatar)","openapi":"PATCH /v1/tenants/{tenantId}/subtenants/{subtenantId}","href":"/api-reference/endpoint/patch-api-v1-tenants-tenantid-subtenants-subtenantid"}]},{"group":"Tenant Sessions","pages":[{"title":"Issue a tenant session","openapi":"POST /api/v1/tenant-sessions","href":"/api-reference/endpoint/post-api-v1-tenant-sessions"}]},{"group":"Tenant Integrations","pages":[{"title":"List the apps this assistant offers, with my connection status","openapi":"GET /v1/tenant-integrations","href":"/api-reference/endpoint/get-api-v1-tenant-integrations"},{"title":"Re-read my connections now","openapi":"POST /v1/tenant-integrations/refresh","href":"/api-reference/endpoint/post-api-v1-tenant-integrations-refresh"},{"title":"Disconnect one of my accounts","openapi":"DELETE /v1/tenant-integrations/accounts/{accountId}","href":"/api-reference/endpoint/delete-api-v1-tenant-integrations-accounts-accountid"},{"title":"My connected accounts for one app","openapi":"GET /v1/tenant-integrations/{app}/accounts","href":"/api-reference/endpoint/get-api-v1-tenant-integrations-app-accounts"},{"title":"What connecting this app asks of me","openapi":"GET /v1/tenant-integrations/{app}/auth","href":"/api-reference/endpoint/get-api-v1-tenant-integrations-app-auth"},{"title":"Connect one of my accounts","openapi":"POST /v1/tenant-integrations/{app}/connect","href":"/api-reference/endpoint/post-api-v1-tenant-integrations-app-connect"}]},{"group":"Tenant Usage","pages":[{"title":"List tiers (plans)","openapi":"GET /v1/tenant-usage/tiers","href":"/api-reference/endpoint/get-api-v1-tenant-usage-tiers"},{"title":"Get tenant usage \u0026 limits","openapi":"GET /v1/tenant-usage/{tenantId}","href":"/api-reference/endpoint/get-api-v1-tenant-usage-tenantid"},{"title":"Get tenant usage history","openapi":"GET /v1/tenant-usage/{tenantId}/history","href":"/api-reference/endpoint/get-api-v1-tenant-usage-tenantid-history"},{"title":"Get subtenant usage \u0026 limits","openapi":"GET /v1/tenant-usage/{tenantId}/subtenants/{subtenantId}","href":"/api-reference/endpoint/get-api-v1-tenant-usage-tenantid-subtenants-subtenantid"},{"title":"Get subtenant usage history","openapi":"GET /v1/tenant-usage/{tenantId}/subtenants/{subtenantId}/history","href":"/api-reference/endpoint/get-api-v1-tenant-usage-tenantid-subtenants-subtenantid-history"}]},{"group":"Tenant Admin","pages":[{"title":"Add usage to a tenant","openapi":"POST /v1/tenant-admin/{tenantId}/add-usage","href":"/api-reference/endpoint/post-api-v1-tenant-admin-tenantid-add-usage"},{"title":"Add usage to a subtenant","openapi":"POST /v1/tenant-admin/{tenantId}/subtenants/{subtenantId}/add-usage","href":"/api-reference/endpoint/post-api-v1-tenant-admin-tenantid-subtenants-subtenantid-add-usage"},{"title":"Change a tenant tier (plan)","openapi":"POST /v1/tenant-admin/{tenantId}/tier","href":"/api-reference/endpoint/post-api-v1-tenant-admin-tenantid-tier"},{"title":"Reset tenant usage counters","openapi":"POST /v1/tenant-admin/{tenantId}/usage-limits/reset","href":"/api-reference/endpoint/post-api-v1-tenant-admin-tenantid-usage-limits-reset"},{"title":"Change a subtenant tier (plan)","openapi":"POST /v1/tenant-admin/{tenantId}/subtenants/{subtenantId}/tier","href":"/api-reference/endpoint/post-api-v1-tenant-admin-tenantid-subtenants-subtenantid-tier"},{"title":"Reset subtenant usage counters","openapi":"POST /v1/tenant-admin/{tenantId}/subtenants/{subtenantId}/usage-limits/reset","href":"/api-reference/endpoint/post-api-v1-tenant-admin-tenantid-subtenants-subtenantid-usage-limits-reset"}]},{"group":"Knowledge","pages":[{"title":"List document folders","openapi":"GET /v1/document-folders","href":"/api-reference/endpoint/get-api-v1-document-folders"},{"title":"Create a document folder","openapi":"POST /v1/document-folders","href":"/api-reference/endpoint/post-api-v1-document-folders"},{"title":"List documents","openapi":"GET /v1/documents","href":"/api-reference/endpoint/get-api-v1-documents"},{"title":"Create a markdown document","openapi":"POST /v1/documents","href":"/api-reference/endpoint/post-api-v1-documents"},{"title":"Update a document folder","openapi":"PATCH /v1/document-folders/{id}","href":"/api-reference/endpoint/patch-api-v1-document-folders-id"},{"title":"Delete a document folder","openapi":"DELETE /v1/document-folders/{id}","href":"/api-reference/endpoint/delete-api-v1-document-folders-id"},{"title":"Get document graph","openapi":"GET /v1/documents/graph","href":"/api-reference/endpoint/get-api-v1-documents-graph"},{"title":"Get a document by ID","openapi":"GET /v1/documents/{id}","href":"/api-reference/endpoint/get-api-v1-documents-id"},{"title":"Update a document","openapi":"PATCH /v1/documents/{id}","href":"/api-reference/endpoint/patch-api-v1-documents-id"},{"title":"Delete a document","openapi":"DELETE /v1/documents/{id}","href":"/api-reference/endpoint/delete-api-v1-documents-id"},{"title":"Attach a folder to an agent or assistant","openapi":"POST /v1/document-folders/{folderId}/attach","href":"/api-reference/endpoint/post-api-v1-document-folders-folderid-attach"},{"title":"Detach a folder from an agent or assistant","openapi":"POST /v1/document-folders/{folderId}/detach","href":"/api-reference/endpoint/post-api-v1-document-folders-folderid-detach"},{"title":"Attach a document to an agent or assistant","openapi":"POST /v1/documents/{id}/attach","href":"/api-reference/endpoint/post-api-v1-documents-id-attach"},{"title":"Detach a document from an agent or assistant","openapi":"POST /v1/documents/{id}/detach","href":"/api-reference/endpoint/post-api-v1-documents-id-detach"},{"title":"List subdocuments","openapi":"GET /v1/documents/{id}/subdocuments","href":"/api-reference/endpoint/get-api-v1-documents-id-subdocuments"},{"title":"Get document usage","openapi":"GET /v1/documents/{id}/usage","href":"/api-reference/endpoint/get-api-v1-documents-id-usage"},{"title":"List document versions","openapi":"GET /v1/documents/{id}/versions","href":"/api-reference/endpoint/get-api-v1-documents-id-versions"},{"title":"Revert a document to a previous version","openapi":"POST /v1/documents/{id}/revert/{version}","href":"/api-reference/endpoint/post-api-v1-documents-id-revert-version"},{"title":"Get a document version","openapi":"GET /v1/documents/{id}/versions/{version}","href":"/api-reference/endpoint/get-api-v1-documents-id-versions-version"}]},{"group":"Skills","pages":[{"title":"List the skills catalog (documents + folders)","openapi":"GET /v1/documents/skills","href":"/api-reference/endpoint/get-api-v1-documents-skills"},{"title":"Scaffold a folder-skill (folder + SKILL.md manifest)","openapi":"POST /v1/documents/skills/scaffold","href":"/api-reference/endpoint/post-api-v1-documents-skills-scaffold"},{"title":"List distinct skill/document tags","openapi":"GET /v1/documents/skills/tags","href":"/api-reference/endpoint/get-api-v1-documents-skills-tags"},{"title":"Download a skill tree (files with relative paths + content)","openapi":"GET /v1/documents/skills/{id}/tree","href":"/api-reference/endpoint/get-api-v1-documents-skills-id-tree"},{"title":"Record that a skill was uninstalled locally (CLI)","openapi":"DELETE /v1/documents/skills/{id}/install","href":"/api-reference/endpoint/delete-api-v1-documents-skills-id-install"},{"title":"Download a skill tree and record the install (CLI)","openapi":"POST /v1/documents/skills/{id}/install","href":"/api-reference/endpoint/post-api-v1-documents-skills-id-install"}]},{"group":"Files","pages":[{"title":"Upload a file","openapi":"POST /v1/files/upload","href":"/api-reference/endpoint/post-api-v1-files-upload"}]},{"group":"Speech to Text","pages":[{"title":"Transcribe audio (speech-to-text)","openapi":"POST /v1/whisper","href":"/api-reference/endpoint/post-api-v1-whisper"},{"title":"Get a transcript by id","openapi":"GET /v1/whisper/{transcriptId}","href":"/api-reference/endpoint/get-api-v1-whisper-transcriptid"}]},{"group":"Environments","pages":[{"title":"List environments","openapi":"GET /v1/environments","href":"/api-reference/endpoint/get-api-v1-environments"},{"title":"Create an environment","openapi":"POST /v1/environments","href":"/api-reference/endpoint/post-api-v1-environments"},{"title":"Delete an environment","openapi":"DELETE /v1/environments/{environmentId}","href":"/api-reference/endpoint/delete-api-v1-environments-environmentid"},{"title":"Get an environment by id","openapi":"GET /v1/environments/{environmentId}","href":"/api-reference/endpoint/get-api-v1-environments-environmentid"},{"title":"Update an environment","openapi":"PATCH /v1/environments/{environmentId}","href":"/api-reference/endpoint/patch-api-v1-environments-environmentid"},{"title":"List the agents and assistants connected to an environment","openapi":"GET /v1/environments/{environmentId}/connections","href":"/api-reference/endpoint/get-api-v1-environments-environmentid-connections"},{"title":"Disconnect an agent or assistant from its environment","openapi":"DELETE /v1/environments/{environmentId}/connections/{entityType}/{entityId}","href":"/api-reference/endpoint/delete-api-v1-environments-environmentid-connections-entitytype-entityid"},{"title":"Connect an agent or assistant to an environment","openapi":"PUT /v1/environments/{environmentId}/connections/{entityType}/{entityId}","href":"/api-reference/endpoint/put-api-v1-environments-environmentid-connections-entitytype-entityid"},{"title":"Bake (or re-bake) the environment snapshot","openapi":"POST /v1/environments/{environmentId}/snapshot/initialize","href":"/api-reference/endpoint/post-api-v1-environments-environmentid-snapshot-initialize"},{"title":"List the per-tenant snapshots derived from this environment","openapi":"GET /v1/environments/{environmentId}/tenant-snapshots","href":"/api-reference/endpoint/get-api-v1-environments-environmentid-tenant-snapshots"},{"title":"Derive (or re-derive) a tenant's snapshot from the base one","openapi":"POST /v1/environments/{environmentId}/tenant-snapshots/{tenantId}/initialize","href":"/api-reference/endpoint/post-api-v1-environments-environmentid-tenant-snapshots-tenantid-initialize"},{"title":"Drop a tenant's snapshot","openapi":"DELETE /v1/environments/{environmentId}/tenant-snapshots/{tenantId}","href":"/api-reference/endpoint/delete-api-v1-environments-environmentid-tenant-snapshots-tenantid"},{"title":"List the sandbox sessions run on this environment","openapi":"GET /v1/environments/{environmentId}/sessions","href":"/api-reference/endpoint/get-api-v1-environments-environmentid-sessions"},{"title":"Get the most recent session, reconciled against the engine","openapi":"GET /v1/environments/{environmentId}/sessions/last","href":"/api-reference/endpoint/get-api-v1-environments-environmentid-sessions-last"},{"title":"Get one session with its command log","openapi":"GET /v1/environments/{environmentId}/sessions/{sessionId}","href":"/api-reference/endpoint/get-api-v1-environments-environmentid-sessions-sessionid"},{"title":"List the CLIs installed on this environment","openapi":"GET /v1/environments/{environmentId}/clis","href":"/api-reference/endpoint/get-api-v1-environments-environmentid-clis"}]},{"group":"Sandboxes","pages":[{"title":"Start a sandbox session","openapi":"POST /v1/environments/{environmentId}/sandbox/start","href":"/api-reference/endpoint/post-api-v1-environments-environmentid-sandbox-start"},{"title":"Whether a session is live on this environment","openapi":"GET /v1/environments/{environmentId}/sandbox/status","href":"/api-reference/endpoint/get-api-v1-environments-environmentid-sandbox-status"},{"title":"Run a command in the sandbox","openapi":"POST /v1/environments/{environmentId}/sandbox/exec","href":"/api-reference/endpoint/post-api-v1-environments-environmentid-sandbox-exec"},{"title":"Stop the session","openapi":"POST /v1/environments/{environmentId}/sandbox/stop","href":"/api-reference/endpoint/post-api-v1-environments-environmentid-sandbox-stop"},{"title":"List a directory inside the sandbox","openapi":"POST /v1/environments/{environmentId}/sandbox/files/list","href":"/api-reference/endpoint/post-api-v1-environments-environmentid-sandbox-files-list"},{"title":"Read a text file from the sandbox","openapi":"POST /v1/environments/{environmentId}/sandbox/files/read","href":"/api-reference/endpoint/post-api-v1-environments-environmentid-sandbox-files-read"},{"title":"Write a file into the sandbox","openapi":"POST /v1/environments/{environmentId}/sandbox/files/write","href":"/api-reference/endpoint/post-api-v1-environments-environmentid-sandbox-files-write"}]},{"group":"Tenant MCP","pages":[{"title":"The MCP servers this assistant offers me, and the ones I connected","openapi":"GET /v1/tenant-mcp","href":"/api-reference/endpoint/get-api-v1-tenant-mcp"},{"title":"Connect an MCP server","openapi":"POST /v1/tenant-mcp","href":"/api-reference/endpoint/post-api-v1-tenant-mcp"},{"title":"Disconnect an MCP server","openapi":"DELETE /v1/tenant-mcp/{id}","href":"/api-reference/endpoint/delete-api-v1-tenant-mcp-id"},{"title":"One of my MCP servers","openapi":"GET /v1/tenant-mcp/{id}","href":"/api-reference/endpoint/get-api-v1-tenant-mcp-id"},{"title":"Rename one of my MCP servers","openapi":"PATCH /v1/tenant-mcp/{id}","href":"/api-reference/endpoint/patch-api-v1-tenant-mcp-id"},{"title":"The tools this server exposes","openapi":"GET /v1/tenant-mcp/{id}/tools","href":"/api-reference/endpoint/get-api-v1-tenant-mcp-id-tools"},{"title":"Authorize again","openapi":"POST /v1/tenant-mcp/{id}/reconnect","href":"/api-reference/endpoint/post-api-v1-tenant-mcp-id-reconnect"}]},{"group":"Documentation","pages":[{"title":"Documentation index page","openapi":"GET /v1/docs","href":"/api-reference/endpoint/get-api-v1-docs"},{"title":"Get rendered markdown documentation page","openapi":"GET /v1/docs/{filename}","href":"/api-reference/endpoint/get-api-v1-docs-filename"},{"title":"Get raw markdown documentation file","openapi":"GET /v1/docs/{filename}.md","href":"/api-reference/endpoint/get-api-v1-docs-filename-md"}]},{"group":"Health","pages":[{"title":"Health check endpoint","openapi":"GET /v1/health","href":"/api-reference/endpoint/get-api-v1-health"}]}]}]},"basePath":"","title":"Write a message - Devic Documentation","deploymentId":"dpl_HhUetB7eHHDAmK9T1Teip38TgFx9","buildId":"dpl_HhUetB7eHHDAmK9T1Teip38TgFx9","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-jJHA3WSo.js","utils-DbZn3Mjn.js","cloneDeep-CnBnaSyy.js","_Uint8Array-CMQtTgBR.js","isObject-FP1Yky1u.js","utils-Bl2DvzOJ.js","addUniqueKeysToSchema-BwOLo9p1.js","snippetPresets-BBiPpKa-.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-C0px4Tml.js","isEqual-zAyttAAO.js","usePlaygroundInputsStore-Dell6dGw.js","shallow-0VKqkSqN.js","getApiPlaygroundDisplay-CP_ctPEB.js","CodeSnippet-5L35ic0s.js","CodeSnippets-DOXbNhJw.js","Page-DRLI_2Ue.js","getPastedJson-VhzT9m2P.js","icon-CD8_AtCO.js","MethodPill-DGgOMftG.js","DuplicateIcon-DZ6A_EtN.js","createIcon-DUl4oM5f.js","DynamicMarkdown-BGHukeRM.js","SectionHeading-ChrEUs8u.js","axios-vUo_bRtp.js","Markdown-Dj-na-_-.js","dist-C5gjFYHe.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","katex-YMM-FMeD.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js","AssistantPageLink-DEBW87tT.js"]}