{ "error": { "code": "not_found", "message": "device not found" }}
code is stable and safe to match on; message is for people and may be reworded.
Status
code
When
400
bad_request
A parameter is invalid, such as a malformed cursor or a since that isn’t an RFC 3339 timestamp.
401
unauthorized
No token, or the token is wrong, expired or revoked.
403
forbidden
The token doesn’t have the scope this endpoint needs.
404
not_found
The record doesn’t exist, or belongs to another customer.
500
internal_error
Something went wrong on our side. Retry later; if it persists, contact support with the time and endpoint.
A filter that matches nothing returns 200 with an empty data list, not 404.
Updated 23 Oct 2026 15:20 · page e2df559
⌘I
{"docsConfig":{"theme":"willow","$schema":"https://mintlify.com/docs.json","name":"M.A.R.C.U.S.","colors":{"primary":"#2A1B5E","light":"#4FC3E0","dark":"#C8156A"},"logo":{"light":"https://mintcdn.com/m-a-r-c-us/9xPMGzocykMrr2xp/images/marcus-light.svg?fit=max\u0026auto=format\u0026n=9xPMGzocykMrr2xp\u0026q=85\u0026s=3bff4ebf5e159c77fc82b75226fd33ef","dark":"https://mintcdn.com/m-a-r-c-us/9xPMGzocykMrr2xp/images/marcus-dark.svg?fit=max\u0026auto=format\u0026n=9xPMGzocykMrr2xp\u0026q=85\u0026s=4183c9afd046bd248f3cec0092b310b6"},"favicon":"https://mintcdn.com/m-a-r-c-us/9xPMGzocykMrr2xp/images/favicon.svg?fit=max\u0026auto=format\u0026n=9xPMGzocykMrr2xp\u0026q=85\u0026s=56a1ad2678f4311ec733520bf0d3352c","api":{"openapi":"api-reference/openapi.json","playground":{"display":"interactive"}},"appearance":{"default":"light"},"navbar":{"links":[{"href":"mailto:support@involve.vc","label":"Support"}],"primary":{"type":"button","label":"Sign in","href":"https://app.uat.involvecloud.com"}},"fonts":{"heading":{"family":"Roboto"},"body":{"family":"Roboto"}},"icons":{"library":"fontawesome"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"m-a-r-c-us","hasAudioNarration":false,"actualSubdomain":"m-a-r-c-us","customDomains":["docs.marcus.involvecloud.com"],"gitSource":{"type":"github","owner":"dloomes","repo":"marcusinfo","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"feedback":{"thumbs":false},"entitlements":{},"buildId":"6af32be28e323f6b7c3b77bc","clientVersion":"0.0.4227","searchFilterCounts":[{"language":"default","tag":"Documentation","count":53},{"language":"default","tag":"API reference","count":20},{"language":"default","tag":"Supported devices","count":20},{"language":"default","tag":"Vendor adapters","count":14},{"language":"default","tag":"Deploy the Collector","count":13},{"language":"default","tag":"Administration","count":9},{"language":"default","tag":"Using the portal","count":9},{"language":"default","tag":"Install","count":6},{"language":"default","tag":"Generic adapters","count":5},{"language":"default","tag":"Getting started","count":4}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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":"site-roles","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/errors","slug":"/api-reference/errors","pageMetadata":{"title":"Errors","description":"Error responses and status codes.","icon":"triangle-exclamation","href":"/api-reference/errors"},"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: \"Error responses and status codes.\"\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={code:`code`,p:`p`,pre:`pre`,span:`span`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{CodeBlock,Table}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Errors use the same shape on every endpoint:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`6`,language:`json`,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:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`6`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"error\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"code\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"not_found\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"device not found\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`code`}),` is stable and safe to match on; `,_jsx(_components.code,{children:`message`}),` is for people and may be reworded.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Status`}),_jsx(_components.th,{children:_jsx(_components.code,{children:`code`})}),_jsx(_components.th,{children:`When`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`bad_request`})}),_jsxs(_components.td,{children:[`A parameter is invalid, such as a malformed `,_jsx(_components.code,{children:`cursor`}),` or a `,_jsx(_components.code,{children:`since`}),` that isn’t an RFC 3339 timestamp.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`401`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`unauthorized`})}),_jsx(_components.td,{children:`No token, or the token is wrong, expired or revoked.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`403`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`forbidden`})}),_jsx(_components.td,{children:`The token doesn’t have the scope this endpoint needs.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`404`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`not_found`})}),_jsx(_components.td,{children:`The record doesn’t exist, or belongs to another customer.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`500`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`internal_error`})}),_jsx(_components.td,{children:`Something went wrong on our side. Retry later; if it persists, contact support with the time and endpoint.`})]})]})]}),`\n`,_jsxs(_components.p,{children:[`A filter that matches nothing returns `,_jsx(_components.code,{children:`200`}),` with an empty `,_jsx(_components.code,{children:`data`}),` list, not `,_jsx(_components.code,{children:`404`}),`.`]}),`\n`,_jsx(`p`,{className:`docs-build-stamp`,style:{fontSize:`0.75rem`,opacity:.6,marginTop:`3rem`},children:`Updated 23 Oct 2026 15:20 · page e2df559`})]})}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":"Errors","description":"Error responses and status codes.","icon":"triangle-exclamation","href":"/api-reference/errors"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"subdomain":"m-a-r-c-us","siteName":"M.A.R.C.U.S.","title":"Errors - M.A.R.C.U.S.","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-23T14:26:00.694Z","originalFileLocation":"api-reference/errors.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=\"light\"}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=\"Error responses and status codes.\">\u003cmeta data-mint-head name=\"application-name\" content=\"M.A.R.C.U.S.\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/m-a-r-c-us/KDe9HxLAnMPYZRM3/_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/m-a-r-c-us/KDe9HxLAnMPYZRM3/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/m-a-r-c-us/KDe9HxLAnMPYZRM3/_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/m-a-r-c-us/KDe9HxLAnMPYZRM3/_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/m-a-r-c-us/KDe9HxLAnMPYZRM3/_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/m-a-r-c-us/KDe9HxLAnMPYZRM3/_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/m-a-r-c-us/KDe9HxLAnMPYZRM3/_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/m-a-r-c-us/KDe9HxLAnMPYZRM3/_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/m-a-r-c-us/KDe9HxLAnMPYZRM3/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Errors - M.A.R.C.U.S.\">\u003cmeta data-mint-head property=\"og:description\" content=\"Error responses and status codes.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"M.A.R.C.U.S.\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.marcus.involvecloud.com/api-reference/errors\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://m-a-r-c-us.mintlify.site/_mintlify/api/og/v2?division=Getting+started\u0026amp;title=Errors\u0026amp;description=Error+responses+and+status+codes.\u0026amp;theme=ae9e29ccafff03afe0b8d7cf\u0026amp;signature=72f4eec2ba3392666e9cc46907ca0bf980f3a999b0a73958d73a982c907124fa\">\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=\"Errors - M.A.R.C.U.S.\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Error responses and status codes.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://m-a-r-c-us.mintlify.site/_mintlify/api/og/v2?division=Getting+started\u0026amp;title=Errors\u0026amp;description=Error+responses+and+status+codes.\u0026amp;theme=ae9e29ccafff03afe0b8d7cf\u0026amp;signature=72f4eec2ba3392666e9cc46907ca0bf980f3a999b0a73958d73a982c907124fa\">\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/m-a-r-c-us/KDe9HxLAnMPYZRM3/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"M.A.R.C.U.S.\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2A1B5E\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.marcus.involvecloud.com/api-reference/errors\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/errors.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.marcus.involvecloud.com/#organization\",\"name\":\"M.A.R.C.U.S.\",\"url\":\"https://docs.marcus.involvecloud.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/m-a-r-c-us/9xPMGzocykMrr2xp/images/marcus-light.svg?fit=max\u0026auto=format\u0026n=9xPMGzocykMrr2xp\u0026q=85\u0026s=3bff4ebf5e159c77fc82b75226fd33ef\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.marcus.involvecloud.com#website\",\"name\":\"M.A.R.C.U.S.\",\"url\":\"https://docs.marcus.involvecloud.com\",\"publisher\":{\"@id\":\"https://docs.marcus.involvecloud.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.marcus.involvecloud.com/api-reference/errors#webpage\",\"url\":\"https://docs.marcus.involvecloud.com/api-reference/errors\",\"name\":\"Errors\",\"description\":\"Error responses and status codes.\",\"dateModified\":\"2026-10-23T14:26:00.694Z\",\"isPartOf\":{\"@id\":\"https://docs.marcus.involvecloud.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.marcus.involvecloud.com/api-reference/errors#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.marcus.involvecloud.com/api-reference/errors#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Getting started\",\"item\":\"https://docs.marcus.involvecloud.com/api-reference/introduction\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Errors\",\"item\":\"https://docs.marcus.involvecloud.com/api-reference/errors\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.marcus.involvecloud.com/api-reference/errors#article\",\"headline\":\"Errors\",\"name\":\"Errors\",\"description\":\"Error responses and status codes.\",\"url\":\"https://docs.marcus.involvecloud.com/api-reference/errors\",\"mainEntityOfPage\":{\"@id\":\"https://docs.marcus.involvecloud.com/api-reference/errors#webpage\"},\"dateModified\":\"2026-10-23T14:26:00.694Z\",\"publisher\":{\"@id\":\"https://docs.marcus.involvecloud.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.marcus.involvecloud.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"M.A.R.C.U.S.\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"M.A.R.C.U.S.\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/errors.md","siteName":"M.A.R.C.U.S.","nav":{"global":null,"anchors":[{"anchor":"Documentation","icon":"book-open","pages":[{"title":"Documentation","href":"/quickstart"}]},{"anchor":"API reference","icon":"code","groups":[{"group":"Getting started","icon":"rocket","pages":[{"title":"Public API","sidebarTitle":"Introduction","icon":"code","href":"/api-reference/introduction"},{"title":"Authentication","icon":"key","href":"/api-reference/authentication"},{"title":"Pagination","description":"Cursor-based paging through list endpoints.","icon":"list","href":"/api-reference/pagination"},{"title":"Errors","icon":"triangle-exclamation","href":"/api-reference/errors"}]},{"group":"Token check","icon":"key","pages":[{"title":"Verify a token","openapi":"api-reference/openapi.json GET /pub/v1/ping","description":"Returns the tenant id, token name, and granted scopes. Useful for smoke-testing that your bearer header is set correctly and that the token targets the tenant you expect.","href":"/api-reference/meta/verify-a-token"}]},{"group":"Devices","icon":"display","pages":[{"title":"List devices","openapi":"api-reference/openapi.json GET /pub/v1/devices","href":"/api-reference/devices/list-devices"},{"title":"Get a device","openapi":"api-reference/openapi.json GET /pub/v1/devices/{id}","href":"/api-reference/devices/get-a-device"},{"title":"Get latest telemetry","openapi":"api-reference/openapi.json GET /pub/v1/devices/{id}/telemetry","href":"/api-reference/devices/get-latest-telemetry"},{"title":"List events for a device","openapi":"api-reference/openapi.json GET /pub/v1/devices/{id}/events","href":"/api-reference/devices/list-events-for-a-device"}]},{"group":"Firmware","icon":"microchip","pages":[{"title":"List firmware versions","openapi":"api-reference/openapi.json GET /pub/v1/firmware","href":"/api-reference/firmware/list-firmware-versions"}]},{"group":"Buildings and rooms","icon":"building","pages":[{"title":"List buildings","openapi":"api-reference/openapi.json GET /pub/v1/buildings","href":"/api-reference/hierarchy/list-buildings"},{"title":"List rooms","openapi":"api-reference/openapi.json GET /pub/v1/rooms","href":"/api-reference/hierarchy/list-rooms"}]},{"group":"Assets","icon":"boxes-stacked","pages":[{"title":"List assets","openapi":"api-reference/openapi.json GET /pub/v1/assets","href":"/api-reference/assets/list-assets"},{"title":"Get one asset","openapi":"api-reference/openapi.json GET /pub/v1/assets/{id}","href":"/api-reference/assets/get-one-asset"}]},{"group":"Alerts","icon":"bell","pages":[{"title":"List alerts","openapi":"api-reference/openapi.json GET /pub/v1/alerts","href":"/api-reference/alerts/list-alerts"}]},{"group":"Events","icon":"wave-square","pages":[{"title":"List events","openapi":"api-reference/openapi.json GET /pub/v1/events","href":"/api-reference/events/list-events"}]},{"group":"Audit","icon":"clipboard-list","pages":[{"title":"List audit entries","openapi":"api-reference/openapi.json GET /pub/v1/audit","href":"/api-reference/audit/list-audit-entries"}]},{"group":"Room Readiness","icon":"moon","pages":[{"title":"List rooms with their latest runs","openapi":"api-reference/openapi.json GET /pub/v1/room-readiness/rooms","href":"/api-reference/room-readiness/list-rooms-with-their-latest-runs"},{"title":"List runs","openapi":"api-reference/openapi.json GET /pub/v1/room-readiness/runs","href":"/api-reference/room-readiness/list-runs"},{"title":"Get a run with its steps","openapi":"api-reference/openapi.json GET /pub/v1/room-readiness/runs/{id}","href":"/api-reference/room-readiness/get-a-run-with-its-steps"}]}]}]},"basePath":"","title":"Errors - M.A.R.C.U.S.","deploymentId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","buildId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","dynamics":[],"chunks":[]}