Submits facts for one or more entities and triggers evaluation of any checks that depend on them.
Important: facts are only persisted to the database when the cache property is set. If cache is omitted or false, the submitted facts are used to evaluate checks but are not stored, so they will not be available afterwards (for example, when checks are re-evaluated or when viewing fact details). Set cache to true to persist facts indefinitely, or to an object with a duration to persist them until they expire.
Controls whether the submitted facts are persisted to the database. Defaults to false, meaning facts are NOT stored and are only used to evaluate checks at submission time. Set to true to persist facts with no expiry, or to { duration } to persist facts until the duration elapses.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Spotify for Backstage","colors":{"primary":"#34baa2","light":"#9af0e1","dark":"#91eeda"},"logo":{"light":"https://mintcdn.com/spotify-89f50c35/24doFeqc-xIrJKxF/static/logo/light.svg?fit=max\u0026auto=format\u0026n=24doFeqc-xIrJKxF\u0026q=85\u0026s=e7c3376851f302fc6d1308df15deb771","dark":"https://mintcdn.com/spotify-89f50c35/24doFeqc-xIrJKxF/static/logo/dark.svg?fit=max\u0026auto=format\u0026n=24doFeqc-xIrJKxF\u0026q=85\u0026s=a4e4bd6c0b855fc5959169face3701e1","href":"/"},"favicon":"https://mintcdn.com/spotify-89f50c35/6C5KyJhdlFRgXnE0/static/favicon.ico?fit=max\u0026auto=format\u0026n=6C5KyJhdlFRgXnE0\u0026q=85\u0026s=78c7096e52c0a4493c1d4b76355d22d9","api":{"playground":{"display":"simple"}},"appearance":{"default":"dark"},"navbar":{"links":[{"href":"https://backstage.spotify.com/contact-us/try-portal/","label":"Try Spotify Portal"}],"primary":{"type":"button","label":"Log in","href":"https://backstage.spotify.com/login/"}},"footer":{"socials":{"linkedin":"https://www.linkedin.com/showcase/spotify-r\u0026d","x":"https://twitter.com/spotifyeng","youtube":"https://www.youtube.com/@SpotifyRnD","instagram":"https://www.instagram.com/lifeatspotify","facebook":"https://www.facebook.com/spotify"},"links":[{"header":"Learn More","items":[{"label":"Go to backstage.spotify.com","href":"https://backstage.spotify.com"},{"label":"Explore the demo","href":"https://demo.backstage.io/catalog"},{"label":"Partner interest form","href":"https://backstage.spotify.com/interested-in-partnering"}]},{"header":"News \u0026 Updates","items":[{"label":"Read our blog","href":"https://backstage.spotify.com/blog"},{"label":"Subscribe to newsletter","href":"https://spoti.fi/backstagenewsletter"},{"label":"Portal system status","href":"https://status.spotifyportal.com"}]},{"header":"Community","items":[{"label":"Join the community","href":"https://github.com/backstage/community"},{"label":"Get Backstage Certified","href":"https://www.cncf.io/training/certification/cba"}]},{"header":"Legal","items":[{"label":"Security","href":"https://backstage.spotify.com/security"},{"label":"Privacy Policy","href":"https://backstage.spotify.com/spotify-for-backstage-terms/privacy-policy"},{"label":"Cookies","href":"https://www.spotify.com/legal/cookies-policy"},{"label":"Terms of Service","href":"https://backstage.spotify.com/terms-of-service"},{"label":"Trademark Usage","href":"https://www.linuxfoundation.org/legal/trademark-usage"}]}]},"seo":{"metatags":{"canonical":"https://backstage.spotify.com/docs"}},"fonts":{"heading":{"family":"Circular Sp","source":"https://mintlify-assets.b-cdn.net/fonts/CircularSpTitle-Bold.woff2","format":"woff2"},"body":{"family":"Circular Sp","source":"https://mintlify-assets.b-cdn.net/fonts/CircularSp-Book.woff2","format":"woff2"}},"styling":{"codeblocks":{"theme":{"light":"github-light","dark":"dracula"}},"latex":false},"integrations":{"gtm":{"tagId":"GTM-58S6R55"},"telemetry":{"enabled":false}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"navigation":{"global":{"anchors":[{"anchor":"Contact us","icon":"headset","href":"https://backstage.spotify.com/contact-us/talk-to-us/"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"spotify-89f50c35","hasAudioNarration":false,"actualSubdomain":"spotify-89f50c35","customDomains":["backstage.spotify.com"],"gitSource":{"type":"github","owner":"backstage-external","repo":"spotify-for-backstage-docs","deployBranch":"main","contentDirectory":"public","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"REMOVE_BRANDING":{"status":"ENABLED"},"CONTEXTUAL_FEEDBACK":{"status":"ENABLED"},"CODE_SNIPPET_FEEDBACK":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af5c8c1bb452cd0b1db62ad","clientVersion":"0.0.4117","searchFilterCounts":[{"language":"default","tag":"Portal","count":140},{"language":"default","tag":"Plugins","count":111},{"language":"default","tag":"Soundcheck","count":88},{"language":"default","tag":"Portal Features \u0026 Plugins","count":88},{"language":"default","tag":"API Reference","count":45},{"language":"default","tag":"Integrations","count":35},{"language":"default","tag":"Guides","count":34},{"language":"default","tag":"Core Concepts","count":31},{"language":"default","tag":"Checks","count":19},{"language":"default","tag":"Fact Collectors","count":16}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true,"deflection":{"enabled":true,"email":"backstage-support@spotify.com","showHelpButton":true}},"basePath":"/docs","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"styles.css","content":"body{--font-jetbrains-mono:\n 'JetBrains Mono', SF Mono, SFMono-Regular, Menlo, Monaco, Cascadia Mono,\n Segoe UI Mono, Roboto Mono, Oxygen Mono, Ubuntu Monospace, Source Code Pro,\n Fira Mono, Droid Sans Mono, Consolas, Courier New, monospace}#topbar-cta-button svg path{stroke:#000000}#topbar-cta-button span{color:#000000}#content:has(.video-overlay){isolation:auto}.landing-page-card{transition:all 0.3s cubic-bezier(0.4, 0, 0.2, 1);backdrop-filter:blur(12px);border-width:2px;background-color:rgb(255 255 255)}.landing-page-card:is(.dark *){background-color:rgb(255 255 255 / 0.1)}.landing-page-card:hover{transform:translateY(-0.25rem)}.landing-page-card [data-component-part=\"card-icon\"],.landing-page-card [data-component-part=\"card-icon\"]>img{width:48px;height:48px}.landing-page-card h2{font-size:1.5rem;margin-bottom:1rem;font-weight:600}"}],"page":{"pagePath":"plugins/soundcheck/api-reference/facts/submit-facts","slug":"/plugins/soundcheck/api-reference/facts/submit-facts","pageMetadata":{"title":"Submit facts","description":"Submits facts for one or more entities and triggers evaluation of any checks that depend on them.\n\n**Important:** facts are only persisted to the database when the `cache` property is set. If `cache` is omitted or `false`, the submitted facts are used to evaluate checks but are *not* stored, so they will not be available afterwards (for example, when checks are re-evaluated or when viewing fact details). Set `cache` to `true` to persist facts indefinitely, or to an object with a `duration` to persist them until they expire.\n","deprecated":null,"version":null,"openapi":"/plugins/soundcheck/openapi.yaml post /facts","href":"/plugins/soundcheck/api-reference/facts/submit-facts","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n em: \"em\",\n p: \"p\",\n strong: \"strong\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Submits facts for one or more entities and triggers evaluation of any checks that depend on them.\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"Important:\"\n }), \" facts are only persisted to the database when the \", _jsx(_components.code, {\n children: \"cache\"\n }), \" property is set. If \", _jsx(_components.code, {\n children: \"cache\"\n }), \" is omitted or \", _jsx(_components.code, {\n children: \"false\"\n }), \", the submitted facts are used to evaluate checks but are \", _jsx(_components.em, {\n children: \"not\"\n }), \" stored, so they will not be available afterwards (for example, when checks are re-evaluated or when viewing fact details). Set \", _jsx(_components.code, {\n children: \"cache\"\n }), \" to \", _jsx(_components.code, {\n children: \"true\"\n }), \" to persist facts indefinitely, or to an object with a \", _jsx(_components.code, {\n children: \"duration\"\n }), \" to persist them until they expire.\"]\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":{"codeStyling":{"theme":{"light":"github-light","dark":"dracula"}},"config":{},"pageMetadata":{"title":"Submit facts","description":"Submits facts for one or more entities and triggers evaluation of any checks that depend on them.\n\n**Important:** facts are only persisted to the database when the `cache` property is set. If `cache` is omitted or `false`, the submitted facts are used to evaluate checks but are *not* stored, so they will not be available afterwards (for example, when checks are re-evaluated or when viewing fact details). Set `cache` to `true` to persist facts indefinitely, or to an object with a `duration` to persist them until they expire.\n","deprecated":null,"version":null,"openapi":"/plugins/soundcheck/openapi.yaml post /facts","href":"/plugins/soundcheck/api-reference/facts/submit-facts","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"submitFacts","summary":"Submit facts","tags":["Facts"],"description":"Submits facts for one or more entities and triggers evaluation of any checks that depend on them.\n\n**Important:** facts are only persisted to the database when the `cache` property is set. If `cache` is omitted or `false`, the submitted facts are used to evaluate checks but are *not* stored, so they will not be available afterwards (for example, when checks are re-evaluated or when viewing fact details). Set `cache` to `true` to persist facts indefinitely, or to an object with a `duration` to persist them until they expire.\n","requestBody":"e69e0ad4-a1ea-49cd-bf6e-71c6d77298dc","responses":{"200":"9a92e830-99c0-47c1-bffe-3a33a4b1e8fb","400":"a0a741ad-b62a-4171-a92b-ac853083fabe","403":"16a759b0-a4be-4077-8347-77d671f35e6c"},"method":"post","type":"path","servers":["59925ce5-6164-44b8-9168-9b125b464937"],"security":[],"path":"/facts","baseUrlOptions":["https://backstage.example.com/api/soundcheck"],"title":"Submit facts","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["facts"],"properties":{"facts":{"type":"array","items":{"type":"object","required":["factRef","entityRef","data"],"properties":{"factRef":{"oneOf":[{"type":"object","required":["source","scope","name"],"properties":{"source":{"type":"string","isRequired":true,"uniqueKey":"facts.items.[INDEX].factRef.oneOf.0.source","typeLabel":"string"},"scope":{"type":"string","isRequired":true,"uniqueKey":"facts.items.[INDEX].factRef.oneOf.0.scope","typeLabel":"string"},"name":{"type":"string","isRequired":true,"uniqueKey":"facts.items.[INDEX].factRef.oneOf.0.name","typeLabel":"string"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"facts.items.[INDEX].factRef.oneOf.0","typeLabel":"object"},{"type":"string","description":"FactRef string in the form [source:][scope/]name.\n","pattern":"^.+:.+\\/[a-zA-Z0-9]+(?:[_\\-.][a-zA-Z0-9]+)*$","isRequired":true,"uniqueKey":"facts.items.[INDEX].factRef.oneOf.1","typeLabel":"string"}],"isRequired":true,"uniqueKey":"facts.items.[INDEX].factRef","typeLabel":"object | string"},"entityRef":{"type":"string","pattern":"^.+:.+\\/(?=.{1,256}$).+$","description":"Entity reference in the form kind:namespace/name.","isRequired":true,"uniqueKey":"facts.items.[INDEX].entityRef","typeLabel":"string"},"data":{"type":"object","additionalProperties":true,"isRequired":true,"uniqueKey":"facts.items.[INDEX].data","typeLabel":"object"},"timestamp":{"type":"string","format":"date-time","uniqueKey":"facts.items.[INDEX].timestamp","typeLabel":"string\u003cdate-time>"}},"additionalProperties":false,"uniqueKey":"facts.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"facts","typeLabel":"object[]"},"cache":{"oneOf":[{"type":"boolean","description":"Controls whether the submitted facts are persisted to the database. Defaults to `false`, meaning facts are NOT stored and are only used to evaluate checks at submission time. Set to `true` to persist facts with no expiry, or to `{ duration }` to persist facts until the duration elapses.\n","uniqueKey":"cache.oneOf.0","typeLabel":"boolean"},{"type":"object","description":"Controls whether the submitted facts are persisted to the database. Defaults to `false`, meaning facts are NOT stored and are only used to evaluate checks at submission time. Set to `true` to persist facts with no expiry, or to `{ duration }` to persist facts until the duration elapses.\n","required":["duration"],"properties":{"duration":{"type":"object","properties":{"years":{"type":"number","uniqueKey":"cache.oneOf.1.duration.years","typeLabel":"number"},"months":{"type":"number","uniqueKey":"cache.oneOf.1.duration.months","typeLabel":"number"},"weeks":{"type":"number","uniqueKey":"cache.oneOf.1.duration.weeks","typeLabel":"number"},"days":{"type":"number","uniqueKey":"cache.oneOf.1.duration.days","typeLabel":"number"},"hours":{"type":"number","uniqueKey":"cache.oneOf.1.duration.hours","typeLabel":"number"},"minutes":{"type":"number","uniqueKey":"cache.oneOf.1.duration.minutes","typeLabel":"number"},"seconds":{"type":"number","uniqueKey":"cache.oneOf.1.duration.seconds","typeLabel":"number"},"milliseconds":{"type":"number","uniqueKey":"cache.oneOf.1.duration.milliseconds","typeLabel":"number"}},"minProperties":1,"additionalProperties":false,"isRequired":true,"uniqueKey":"cache.oneOf.1.duration","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"cache.oneOf.1","typeLabel":"object"}],"uniqueKey":"cache","typeLabel":"boolean | object"}},"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"persisted":{"title":"persisted","value":{"facts":[{"factRef":"my-source:default/my-fact","entityRef":"component:default/my-service","data":{"hasReadme":true}}],"cache":true}},"persistedWithExpiry":{"title":"persistedWithExpiry","value":{"facts":[{"factRef":"my-source:default/my-fact","entityRef":"component:default/my-service","data":{"hasReadme":true}}],"cache":{"duration":{"days":1}}}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"9a92e830-99c0-47c1-bffe-3a33a4b1e8fb":{"description":"Facts submitted successfully","content":{"application/json":{"schema":{"type":"object","required":["facts"],"properties":{"facts":{"type":"array","items":{"type":"object","required":["factRef","entityRef"],"properties":{"factRef":{"type":"string","isRequired":true,"uniqueKey":"facts.items.[INDEX].factRef","typeLabel":"string"},"entityRef":{"type":"string","isRequired":true,"uniqueKey":"facts.items.[INDEX].entityRef","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"facts.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"facts","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"facts":[{"factRef":"\u003cstring>","entityRef":"\u003cstring>"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"a0a741ad-b62a-4171-a92b-ac853083fabe":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"name":{"type":"string","isRequired":true,"uniqueKey":"error.name","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"required":["name","message"],"additionalProperties":true,"isRequired":true,"uniqueKey":"error","typeLabel":"object"},"response":{"type":"object","properties":{"statusCode":{"type":"integer","isRequired":true,"uniqueKey":"response.statusCode","typeLabel":"integer"}},"required":["statusCode"],"additionalProperties":false,"isRequired":true,"uniqueKey":"response","typeLabel":"object"},"request":{"type":"object","properties":{"method":{"type":"string","isRequired":true,"uniqueKey":"request.method","typeLabel":"string"},"url":{"type":"string","isRequired":true,"uniqueKey":"request.url","typeLabel":"string"}},"required":["method","url"],"additionalProperties":false,"uniqueKey":"request","typeLabel":"object"}},"required":["error","response"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"name":"\u003cstring>","message":"\u003cstring>"},"response":{"statusCode":123},"request":{"method":"\u003cstring>","url":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"16a759b0-a4be-4077-8347-77d671f35e6c":{"description":"Forbidden","content":{"text/plain":{"schema":{"type":"string","uniqueKey":"","typeLabel":"string"},"examples":{"Example":{"title":"Example","value":"\u003cstring>"}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{},"servers":{"59925ce5-6164-44b8-9168-9b125b464937":{"url":"https://backstage.example.com/api/soundcheck"}}},"originalFileLocation":"plugins/soundcheck/openapi.yaml"},"subdomain":"spotify-89f50c35","siteName":"Spotify for Backstage","title":"Submit facts - Spotify for Backstage","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-21T14:16:41.907Z","originalFileLocation":"plugins/soundcheck/api-reference/facts/submit-facts.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=\"dark\"}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=\"Submits facts for one or more entities and triggers evaluation of any checks that depend on them. Important: facts are only persisted to the database when the cache property is set. If cache is omitted or false, the submitted facts are used to evaluate checks but are not stored, so they will not be available afterwards (for example, when checks are re-evaluated or when viewing fact details). Set cache to true to persist facts indefinitely, or to an object with a duration to persist them until they expire.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Spotify for Backstage\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/spotify-89f50c35/R_8z5ScClO7v3nRq/_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=\"/docs/mintlify-assets/_mintlify/favicons/spotify-89f50c35/R_8z5ScClO7v3nRq/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/spotify-89f50c35/R_8z5ScClO7v3nRq/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/spotify-89f50c35/R_8z5ScClO7v3nRq/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/spotify-89f50c35/R_8z5ScClO7v3nRq/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/spotify-89f50c35/R_8z5ScClO7v3nRq/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/spotify-89f50c35/R_8z5ScClO7v3nRq/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/spotify-89f50c35/R_8z5ScClO7v3nRq/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/spotify-89f50c35/R_8z5ScClO7v3nRq/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Submit facts - Spotify for Backstage\">\u003cmeta data-mint-head property=\"og:description\" content=\"Submits facts for one or more entities and triggers evaluation of any checks that depend on them. Important: facts are only persisted to the database when the cache property is set. If cache is omitted or false, the submitted facts are used to evaluate checks but are not stored, so they will not be available afterwards (for example, when checks are re-evaluated or when viewing fact details). Set cache to true to persist facts indefinitely, or to an object with a duration to persist them until they expire.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Spotify for Backstage\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://backstage.spotify.com/docs/plugins/soundcheck/api-reference/facts/submit-facts\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://spotify-89f50c35.mintlify.site/docs/_mintlify/api/og/v2?division=Facts\u0026amp;title=Submit+facts\u0026amp;description=Submits+facts+for+one+or+more+entities+and+triggers+evaluation+of+any+checks+that+depend+on+them.%0A%0A**Important%3A**+facts+are+only+persisted+to+the+database+when+\u0026amp;theme=a6f41037062b0a3b3eab7f14\u0026amp;signature=2b2022c9bed570c82e3ff251b757f0fc387c64b965fc52674c30b3a4a1b7e8f4\">\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=\"Submit facts - Spotify for Backstage\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Submits facts for one or more entities and triggers evaluation of any checks that depend on them. Important: facts are only persisted to the database when the cache property is set. If cache is omitted or false, the submitted facts are used to evaluate checks but are not stored, so they will not be available afterwards (for example, when checks are re-evaluated or when viewing fact details). Set cache to true to persist facts indefinitely, or to an object with a duration to persist them until they expire.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://spotify-89f50c35.mintlify.site/docs/_mintlify/api/og/v2?division=Facts\u0026amp;title=Submit+facts\u0026amp;description=Submits+facts+for+one+or+more+entities+and+triggers+evaluation+of+any+checks+that+depend+on+them.%0A%0A**Important%3A**+facts+are+only+persisted+to+the+database+when+\u0026amp;theme=a6f41037062b0a3b3eab7f14\u0026amp;signature=2b2022c9bed570c82e3ff251b757f0fc387c64b965fc52674c30b3a4a1b7e8f4\">\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=\"/docs/mintlify-assets/_mintlify/favicons/spotify-89f50c35/R_8z5ScClO7v3nRq/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Spotify for Backstage\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#34baa2\">\u003clink data-mint-head rel=\"canonical\" href=\"https://backstage.spotify.com/docs/plugins/soundcheck/api-reference/facts/submit-facts\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/plugins/soundcheck/api-reference/facts/submit-facts.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://backstage.spotify.com/#organization\",\"name\":\"Spotify for Backstage\",\"url\":\"https://backstage.spotify.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/spotify-89f50c35/24doFeqc-xIrJKxF/static/logo/light.svg?fit=max\u0026auto=format\u0026n=24doFeqc-xIrJKxF\u0026q=85\u0026s=e7c3376851f302fc6d1308df15deb771\"}},{\"@type\":\"WebSite\",\"@id\":\"https://backstage.spotify.com/docs#website\",\"name\":\"Spotify for Backstage\",\"url\":\"https://backstage.spotify.com/docs\",\"publisher\":{\"@id\":\"https://backstage.spotify.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://backstage.spotify.com/docs/plugins/soundcheck/api-reference/facts/submit-facts#webpage\",\"url\":\"https://backstage.spotify.com/docs/plugins/soundcheck/api-reference/facts/submit-facts\",\"name\":\"Submit facts\",\"description\":\"Submits facts for one or more entities and triggers evaluation of any checks that depend on them. Important: facts are only persisted to the database when the cache property is set. If cache is omitted or false, the submitted facts are used to evaluate checks but are not stored, so they will not be available afterwards (for example, when checks are re-evaluated or when viewing fact details). Set cache to true to persist facts indefinitely, or to an object with a duration to persist them until they expire.\",\"dateModified\":\"2026-10-21T14:16:41.907Z\",\"isPartOf\":{\"@id\":\"https://backstage.spotify.com/docs#website\"},\"breadcrumb\":{\"@id\":\"https://backstage.spotify.com/docs/plugins/soundcheck/api-reference/facts/submit-facts#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://backstage.spotify.com/docs/plugins/soundcheck/api-reference/facts/submit-facts#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Soundcheck\",\"item\":\"https://backstage.spotify.com/docs/plugins/soundcheck\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"API Reference\",\"item\":\"https://backstage.spotify.com/docs/plugins/soundcheck/api-reference/campaigns/get-campaigns\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Submit facts\",\"item\":\"https://backstage.spotify.com/docs/plugins/soundcheck/api-reference/facts/submit-facts\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://backstage.spotify.com/docs/plugins/soundcheck/api-reference/facts/submit-facts#apireference\",\"headline\":\"Submit facts\",\"name\":\"Submit facts\",\"description\":\"Submits facts for one or more entities and triggers evaluation of any checks that depend on them. Important: facts are only persisted to the database when the cache property is set. If cache is omitted or false, the submitted facts are used to evaluate checks but are not stored, so they will not be available afterwards (for example, when checks are re-evaluated or when viewing fact details). Set cache to true to persist facts indefinitely, or to an object with a duration to persist them until they expire.\",\"url\":\"https://backstage.spotify.com/docs/plugins/soundcheck/api-reference/facts/submit-facts\",\"mainEntityOfPage\":{\"@id\":\"https://backstage.spotify.com/docs/plugins/soundcheck/api-reference/facts/submit-facts#webpage\"},\"dateModified\":\"2026-10-21T14:16:41.907Z\",\"publisher\":{\"@id\":\"https://backstage.spotify.com/#organization\"},\"isPartOf\":{\"@id\":\"https://backstage.spotify.com/docs#website\"}}]}\u003c/script>","agentPointerHref":"/docs/plugins/soundcheck/api-reference/facts/submit-facts.md","siteName":"Spotify for Backstage","nav":{"global":{"anchors":[{"anchor":"Contact us","icon":"headset","href":"https://backstage.spotify.com/contact-us/talk-to-us/"}]},"tabs":[{"tab":"Portal","pages":[{"title":"Portal","href":"/portal"}]},{"tab":"Plugins","pages":[{"title":"Spotify Plugins for Backstage","href":"/plugins"},{"group":"Getting Started","root":{"title":"Getting Started Guide","sidebarTitle":"Getting started with Plugins for Backstage","href":"/plugins/getting-started/index"},"pages":[{"title":"AWS Marketplace","sidebarTitle":"Buy Plugins on AWS Marketplace","href":"/plugins/getting-started/aws-marketplace"}]},{"group":"Soundcheck","root":{"title":"Soundcheck","sidebarTitle":"Overview","href":"/plugins/soundcheck/index"},"pages":[{"title":"Installation \u0026 Setup","href":"/plugins/soundcheck/setup-and-installation"},{"group":"Core Concepts","root":{"title":"Core Concepts","href":"/plugins/soundcheck/core-concepts/index"},"pages":[{"group":"Checks","root":{"title":"Checks","sidebarTitle":"Overview","href":"/plugins/soundcheck/core-concepts/checks/index"},"pages":[{"title":"Manual Checks","href":"/plugins/soundcheck/core-concepts/checks/manual-checks"},{"title":"Multi-Fact Checks","sidebarTitle":"Multi-Fact Checks","href":"/plugins/soundcheck/core-concepts/checks/multi-fact-checks"},{"title":"Check Exemptions","sidebarTitle":"Check Exemptions","href":"/plugins/soundcheck/core-concepts/checks/check-exemptions"}]},{"title":"Tracks","href":"/plugins/soundcheck/core-concepts/tracks"},{"title":"Campaigns","href":"/plugins/soundcheck/core-concepts/campaigns"},{"title":"Filters","href":"/plugins/soundcheck/core-concepts/filters"},{"title":"Check Results","href":"/plugins/soundcheck/core-concepts/checkResults"},{"group":"Fact Collectors","root":{"title":"Fact Collectors","sidebarTitle":"Overview","href":"/plugins/soundcheck/core-concepts/fact-collectors/index"},"pages":[{"group":"Integrations","pages":[{"title":"Azure DevOps","href":"/plugins/soundcheck/core-concepts/fact-collectors/3p-integrations/azure"},{"title":"BigQuery","sidebarTitle":"BigQuery","href":"/plugins/soundcheck/core-concepts/fact-collectors/3p-integrations/bigquery"},{"title":"Catalog","sidebarTitle":"Catalog","href":"/plugins/soundcheck/core-concepts/fact-collectors/3p-integrations/catalog"},{"title":"Datadog","href":"/plugins/soundcheck/core-concepts/fact-collectors/3p-integrations/datadog"},{"title":"Data Registry","sidebarTitle":"Data Registry (Portal)","href":"/plugins/soundcheck/core-concepts/fact-collectors/3p-integrations/data-registry"},{"title":"GitHub","href":"/plugins/soundcheck/core-concepts/fact-collectors/3p-integrations/github"},{"title":"GitLab","href":"/plugins/soundcheck/core-concepts/fact-collectors/3p-integrations/gitlab"},{"title":"HTTP","sidebarTitle":"HTTP","href":"/plugins/soundcheck/core-concepts/fact-collectors/3p-integrations/http"},{"title":"Jira","sidebarTitle":"Jira","href":"/plugins/soundcheck/core-concepts/fact-collectors/3p-integrations/jira"},{"title":"Kubernetes","href":"/plugins/soundcheck/core-concepts/fact-collectors/3p-integrations/kubernetes"},{"title":"NewRelic","href":"/plugins/soundcheck/core-concepts/fact-collectors/3p-integrations/newrelic"},{"title":"PagerDuty","href":"/plugins/soundcheck/core-concepts/fact-collectors/3p-integrations/pagerduty"},{"title":"Source Control Management","href":"/plugins/soundcheck/core-concepts/fact-collectors/3p-integrations/scm"},{"title":"SonarQube","href":"/plugins/soundcheck/core-concepts/fact-collectors/3p-integrations/sonarqube"},{"title":"Soundcheck","href":"/plugins/soundcheck/core-concepts/fact-collectors/3p-integrations/soundcheck"},{"title":"Tech Insights","href":"/plugins/soundcheck/core-concepts/fact-collectors/3p-integrations/techinsights"}]}]},{"title":"Check Insights Page Overview","sidebarTitle":"Check Insights","href":"/plugins/soundcheck/core-concepts/check-insights"},{"title":"Track Insights Page Overview","sidebarTitle":"Track Insights","href":"/plugins/soundcheck/core-concepts/track-insights"},{"title":"Campaign Insights Page Overview","sidebarTitle":"Campaign Insights","href":"/plugins/soundcheck/core-concepts/campaign-insights"},{"title":"Tech Insights","sidebarTitle":"Tech Insights","href":"/plugins/soundcheck/core-concepts/tech-insights"},{"title":"Events","href":"/plugins/soundcheck/core-concepts/events"},{"title":"Notifications","href":"/plugins/soundcheck/core-concepts/notifications"}]},{"group":"Using Soundcheck","pages":[{"title":"Entity Card","href":"/plugins/soundcheck/soundcheck-elements/soundcheck-entity-card"},{"title":"Entity Tab","href":"/plugins/soundcheck/soundcheck-elements/soundcheck-entity-tab"}]},{"group":"Tutorials","pages":[{"title":"Creating a Custom Third-Party Integration","href":"/plugins/soundcheck/tutorials/custom-fact-collector"},{"title":"Creating a Custom No-Code UI for a Third-Party Integration","href":"/plugins/soundcheck/tutorials/custom-fact-collector-ncui"},{"title":"Start Measuring Catalog Maturity in 1 hour with the SCM Compliance Track","href":"/plugins/soundcheck/tutorials/start-measuring-catalog-maturity"},{"title":"Climb the maturity ladder with the Recommended Source Control Track","href":"/plugins/soundcheck/tutorials/climb-the-maturity-ladder-with-the-recommended-source-control-track"},{"title":"Start to enable your experts to manage maturity progress","href":"/plugins/soundcheck/tutorials/start-to-enable-your-experts-to-manage-maturity-progress"}]},{"group":"API Reference","pages":[{"group":"Campaigns","pages":[{"title":"Get campaigns","deprecated":null,"version":null,"openapi":"/plugins/soundcheck/openapi.yaml get /campaigns","href":"/plugins/soundcheck/api-reference/campaigns/get-campaigns"},{"title":"Create campaigns","deprecated":null,"version":null,"openapi":"/plugins/soundcheck/openapi.yaml post /campaigns","href":"/plugins/soundcheck/api-reference/campaigns/create-campaigns"},{"title":"Get campaign entities","deprecated":null,"version":null,"openapi":"/plugins/soundcheck/openapi.yaml post /campaigns/entities","href":"/plugins/soundcheck/api-reference/campaigns/get-campaign-entities"},{"title":"Get a campaign","deprecated":null,"version":null,"openapi":"/plugins/soundcheck/openapi.yaml get /campaigns/{campaignId}","href":"/plugins/soundcheck/api-reference/campaigns/get-a-campaign"},{"title":"Update a campaign","deprecated":null,"version":null,"openapi":"/plugins/soundcheck/openapi.yaml put /campaigns/{campaignId}","href":"/plugins/soundcheck/api-reference/campaigns/update-a-campaign"},{"title":"Delete a campaign","deprecated":null,"version":null,"openapi":"/plugins/soundcheck/openapi.yaml delete /campaigns/{campaignId}","href":"/plugins/soundcheck/api-reference/campaigns/delete-a-campaign"}]},{"group":"Certification","pages":[{"title":"Get certifications for an entity","deprecated":null,"version":null,"openapi":"/plugins/soundcheck/openapi.yaml get /certifications","href":"/plugins/soundcheck/api-reference/certification/get-certifications-for-an-entity"},{"title":"Certify world","deprecated":null,"version":null,"openapi":"/plugins/soundcheck/openapi.yaml post /certify_world","href":"/plugins/soundcheck/api-reference/certification/certify-world"}]},{"group":"Checks","pages":[{"title":"Get checks","deprecated":null,"version":null,"openapi":"/plugins/soundcheck/openapi.yaml get /checks","href":"/plugins/soundcheck/api-reference/checks/get-checks"},{"title":"Create checks","deprecated":null,"version":null,"openapi":"/plugins/soundcheck/openapi.yaml post /checks","href":"/plugins/soundcheck/api-reference/checks/create-checks"},{"title":"Get check entities","deprecated":null,"version":null,"openapi":"/plugins/soundcheck/openapi.yaml post /checks/entities","href":"/plugins/soundcheck/api-reference/checks/get-check-entities"},{"title":"Execute checks","deprecated":null,"version":null,"openapi":"/plugins/soundcheck/openapi.yaml post /checks/execute","href":"/plugins/soundcheck/api-reference/checks/execute-checks"},{"title":"Get exemptions","deprecated":null,"version":null,"openapi":"/plugins/soundcheck/openapi.yaml get /checks/exemptions","href":"/plugins/soundcheck/api-reference/checks/get-exemptions"},{"title":"Create an exemption","deprecated":null,"version":null,"openapi":"/plugins/soundcheck/openapi.yaml post /checks/exemptions","href":"/plugins/soundcheck/api-reference/checks/create-an-exemption"},{"title":"Revoke an exemption","deprecated":null,"version":null,"openapi":"/plugins/soundcheck/openapi.yaml post /checks/exemptions/revoke","href":"/plugins/soundcheck/api-reference/checks/revoke-an-exemption"},{"title":"Restore a revoked exemption","deprecated":null,"version":null,"openapi":"/plugins/soundcheck/openapi.yaml post /checks/exemptions/restore","href":"/plugins/soundcheck/api-reference/checks/restore-a-revoked-exemption"},{"title":"Get revoked exemptions","deprecated":null,"version":null,"openapi":"/plugins/soundcheck/openapi.yaml get /checks/exemptions/revoked","href":"/plugins/soundcheck/api-reference/checks/get-revoked-exemptions"},{"title":"Get a check","deprecated":null,"version":null,"openapi":"/plugins/soundcheck/openapi.yaml get /checks/{checkId}","href":"/plugins/soundcheck/api-reference/checks/get-a-check"},{"title":"Update a check","deprecated":null,"version":null,"openapi":"/plugins/soundcheck/openapi.yaml put /checks/{checkId}","href":"/plugins/soundcheck/api-reference/checks/update-a-check"},{"title":"Delete a check","deprecated":null,"version":null,"openapi":"/plugins/soundcheck/openapi.yaml delete /checks/{checkId}","href":"/plugins/soundcheck/api-reference/checks/delete-a-check"},{"title":"Get the aggregate status of a check","deprecated":null,"version":null,"openapi":"/plugins/soundcheck/openapi.yaml get /checks/{checkId}/status","href":"/plugins/soundcheck/api-reference/checks/get-the-aggregate-status-of-a-check"},{"title":"Get the aggregate status of a check","deprecated":null,"version":null,"openapi":"/plugins/soundcheck/openapi.yaml post /checks/{checkId}/status","href":"/plugins/soundcheck/api-reference/checks/get-the-aggregate-status-of-a-check-1"},{"title":"Get the status history of a check","deprecated":null,"version":null,"openapi":"/plugins/soundcheck/openapi.yaml get /checks/{checkId}/status-history","href":"/plugins/soundcheck/api-reference/checks/get-the-status-history-of-a-check"},{"title":"Get the status history of a check","deprecated":null,"version":null,"openapi":"/plugins/soundcheck/openapi.yaml post /checks/{checkId}/status-history","href":"/plugins/soundcheck/api-reference/checks/get-the-status-history-of-a-check-1"}]},{"group":"FactCollectors","pages":[{"title":"List fact collectors","deprecated":null,"version":null,"openapi":"/plugins/soundcheck/openapi.yaml get /fact-collectors","href":"/plugins/soundcheck/api-reference/factcollectors/list-fact-collectors"},{"title":"Create fact collectors","deprecated":null,"version":null,"openapi":"/plugins/soundcheck/openapi.yaml post /fact-collectors","href":"/plugins/soundcheck/api-reference/factcollectors/create-fact-collectors"},{"title":"Get a fact collector","deprecated":null,"version":null,"openapi":"/plugins/soundcheck/openapi.yaml get /fact-collectors/{collectorId}","href":"/plugins/soundcheck/api-reference/factcollectors/get-a-fact-collector"},{"title":"Update a fact collector","deprecated":null,"version":null,"openapi":"/plugins/soundcheck/openapi.yaml put /fact-collectors/{collectorId}","href":"/plugins/soundcheck/api-reference/factcollectors/update-a-fact-collector"},{"title":"Delete a fact collector","description":null,"deprecated":null,"version":null,"openapi":"/plugins/soundcheck/openapi.yaml delete /fact-collectors/{collectorId}","href":"/plugins/soundcheck/api-reference/factcollectors/delete-a-fact-collector"}]},{"group":"Facts","pages":[{"title":"Submit facts","deprecated":null,"version":null,"openapi":"/plugins/soundcheck/openapi.yaml post /facts","href":"/plugins/soundcheck/api-reference/facts/submit-facts"},{"title":"Trigger on-demand fact collection","description":"Queues fact collection jobs for the specified collectors and entities. Collection is performed asynchronously; the endpoint returns immediately with a summary of what was queued. Requires the soundcheck.fact.collect permission.\n","deprecated":null,"version":null,"openapi":"/plugins/soundcheck/openapi.yaml post /facts/collect","href":"/plugins/soundcheck/api-reference/facts/trigger-on-demand-fact-collection"}]},{"group":"CheckResults","pages":[{"title":"Get check results","deprecated":null,"version":null,"openapi":"/plugins/soundcheck/openapi.yaml get /results","href":"/plugins/soundcheck/api-reference/checkresults/get-check-results"},{"title":"Submit check results","deprecated":null,"version":null,"openapi":"/plugins/soundcheck/openapi.yaml post /results","href":"/plugins/soundcheck/api-reference/checkresults/submit-check-results"},{"title":"Delete check results","deprecated":null,"version":null,"openapi":"/plugins/soundcheck/openapi.yaml delete /results","href":"/plugins/soundcheck/api-reference/checkresults/delete-check-results"}]},{"group":"Tracks","pages":[{"title":"Get tracks","deprecated":null,"version":null,"openapi":"/plugins/soundcheck/openapi.yaml get /tracks","href":"/plugins/soundcheck/api-reference/tracks/get-tracks"},{"title":"Create tracks","deprecated":null,"version":null,"openapi":"/plugins/soundcheck/openapi.yaml post /tracks","href":"/plugins/soundcheck/api-reference/tracks/create-tracks"},{"title":"Get a track","deprecated":null,"version":null,"openapi":"/plugins/soundcheck/openapi.yaml get /tracks/{trackId}","href":"/plugins/soundcheck/api-reference/tracks/get-a-track"},{"title":"Update a track","deprecated":null,"version":null,"openapi":"/plugins/soundcheck/openapi.yaml put /tracks/{trackId}","href":"/plugins/soundcheck/api-reference/tracks/update-a-track"},{"title":"Delete a track","deprecated":null,"version":null,"openapi":"/plugins/soundcheck/openapi.yaml delete /tracks/{trackId}","href":"/plugins/soundcheck/api-reference/tracks/delete-a-track"},{"title":"Get entities for a track filtered by certification status","deprecated":null,"version":null,"openapi":"/plugins/soundcheck/openapi.yaml get /tracks/{trackId}/entities","href":"/plugins/soundcheck/api-reference/tracks/get-entities-for-a-track-filtered-by-certification-status"},{"title":"Get entities failing checks in a track","deprecated":null,"version":null,"openapi":"/plugins/soundcheck/openapi.yaml post /tracks/{trackId}/failing-entities","href":"/plugins/soundcheck/api-reference/tracks/get-entities-failing-checks-in-a-track"},{"title":"Get the aggregate certification status for a track","deprecated":null,"version":null,"openapi":"/plugins/soundcheck/openapi.yaml get /tracks/{trackId}/status","href":"/plugins/soundcheck/api-reference/tracks/get-the-aggregate-certification-status-for-a-track"},{"title":"Get the aggregate certification status for a track","deprecated":null,"version":null,"openapi":"/plugins/soundcheck/openapi.yaml post /tracks/{trackId}/status","href":"/plugins/soundcheck/api-reference/tracks/get-the-aggregate-certification-status-for-a-track-1"},{"title":"Get the aggregate certification status history of a track","deprecated":null,"version":null,"openapi":"/plugins/soundcheck/openapi.yaml get /tracks/{trackId}/status-history","href":"/plugins/soundcheck/api-reference/tracks/get-the-aggregate-certification-status-history-of-a-track"},{"title":"Get the aggregate certification status history of a track","deprecated":null,"version":null,"openapi":"/plugins/soundcheck/openapi.yaml post /tracks/{trackId}/status-history","href":"/plugins/soundcheck/api-reference/tracks/get-the-aggregate-certification-status-history-of-a-track-1"}]}]},{"title":"API Client","sidebarTitle":"API Client","href":"/plugins/soundcheck/api-client"},{"title":"MCP Actions","href":"/plugins/soundcheck/mcp-actions"},{"title":"Health Page","sidebarTitle":"Health Page","href":"/plugins/soundcheck/health"},{"title":"Soundcheck - Advanced Performance Tuning","sidebarTitle":"Advanced Performance Tuning","href":"/plugins/soundcheck/performance"},{"title":"Internationalization (i18n)","sidebarTitle":"Internationalization","href":"/plugins/soundcheck/internationalization"},{"group":"Troubleshooting","root":{"title":"Troubleshooting","href":"/plugins/soundcheck/troubleshooting/index"},"pages":[{"title":"Job Queue Statistics","href":"/plugins/soundcheck/troubleshooting/job-queue-statistics"}]}]},{"group":"RBAC","root":{"title":"RBAC","sidebarTitle":"Overview","href":"/plugins/rbac/index"},"pages":[{"title":"Installation \u0026 Setup","sidebarTitle":"Setup \u0026 Installation","href":"/plugins/rbac/setup-and-installation"},{"title":"Core Concepts","href":"/plugins/rbac/core-concepts"},{"title":"MCP Actions","href":"/plugins/rbac/mcp-actions"},{"group":"Tutorials","pages":[{"title":"Fine-tune Software Templates Access","href":"/plugins/rbac/tutorials/fine-tune-template-access"},{"title":"Read-Only Catalog Permissions","href":"/plugins/rbac/tutorials/read-only-catalog"},{"title":"Catalog Delete Permissions","href":"/plugins/rbac/tutorials/delete-catalog-for-owners"},{"title":"Establish a foundational permission policy","href":"/plugins/rbac/tutorials/foundational-permission-policy"}]}]},{"group":"Skill Exchange","root":{"title":"Skill Exchange","sidebarTitle":"Overview","href":"/plugins/skill-exchange/index"},"pages":[{"title":"Setup \u0026 Installation","href":"/plugins/skill-exchange/setup-and-installation"},{"title":"Notifications","sidebarTitle":"Notifications","href":"/plugins/skill-exchange/notifications"},{"title":"Skill Exchange Actions","href":"/plugins/skill-exchange/actions"},{"group":"Tutorials","pages":[{"title":"Customizing Skill Exchange","href":"/plugins/skill-exchange/tutorials/customizing-skill-exchange"}]},{"group":"References","pages":[{"title":"EmbedsMessageBuilder","href":"/plugins/skill-exchange/references/EmbedsMessageBuilder"},{"title":"MentorsMessageBuilder","href":"/plugins/skill-exchange/references/MentorsMessageBuilder"},{"title":"HacksMessageBuilder","href":"/plugins/skill-exchange/references/HacksMessageBuilder"}]}]},{"group":"Insights","root":{"sidebarTitle":"Insights","title":"Overview","href":"/plugins/insights/index"},"pages":[{"title":"Setup \u0026 Installation","sidebarTitle":"Setup \u0026 Installation","href":"/plugins/insights/setup-and-installation"},{"group":"Core Concepts","pages":[{"title":"Usage Data","href":"/plugins/insights/core-concepts/usage-data"},{"title":"Feedback","href":"/plugins/insights/core-concepts/feedback"}]},{"title":"Migration \u0026 Installation","sidebarTitle":"Migrating to Insights with Feedback","href":"/plugins/insights/migrating-to-insights-with-feedback"},{"title":"MCP Actions","href":"/plugins/insights/mcp-actions"},{"group":"Tutorials","pages":[{"title":"Optimizing your Insights configuration","href":"/plugins/insights/tutorials/Optimizing-Insights-set-up"},{"title":"Tips for running your first Feedback Survey","href":"/plugins/insights/tutorials/feedback-survey"}]}]}]},{"tab":"Xirp","pages":[{"title":"Xirp","href":"/xirp"}]}]},"basePath":"","title":"Submit facts - Spotify for Backstage","buildId":"dpl_AHzSCQPRq6mP9FZXEa5AbDZTffie","deploymentId":"dpl_AHzSCQPRq6mP9FZXEa5AbDZTffie","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-C0w-WQJ2.js","utils-C5d2irbo.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-CJr73d5s.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-B9xqpnhe.js","snippetPresets-C6Ms_vrL.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-C4vTqKLT.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-Dvb1kse5.js","shallow-BIuit-p4.js","getApiPlaygroundDisplay-B4qYxU7P.js","CodeSnippet-DbbDcn2_.js","CodeSnippets-P3qMtezt.js","Page-DLEGoKJA.js","getPastedJson-rlg7qTiW.js","icon-ChyN3MIj.js","MethodPill-BDbONhDa.js","DuplicateIcon-CJlrtq8z.js","createIcon-BDOguHRU.js","DynamicMarkdown-mBxoveKr.js","SectionHeading-CAMJotVi.js","axios-vUo_bRtp.js","Markdown-BNXMbgxP.js","clsx-4BR7cppx.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CAwBMBkB.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-CJogWhER.js"]}