Perception prompts are questions (e.g. “How trustworthy does this brand appear on a scale from 0–10?”) that are sent to LLMs to score brand attributes. This endpoint requires the Custom Perception Prompts feature to be enabled for your organization.Perception prompts share the same quota as regular prompts.
curl -s -X POST \ -H "x-spotlight-api-key: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "prompts": [ { "text": "On a scale from 0 to 10, how trustworthy does this brand appear?", "propertyId": "Trust", "scoringLogic": "0-6: detractor, 7-8: passive, 9-10: promoter" }, { "text": "How clear and easy to understand is this brand'"'"'s messaging?", "propertyId": "Clarity", "goodScore": "Messaging is clear and compelling", "badScore": "Messaging is confusing or inconsistent" } ] }' \ "https://app.rocketblue.ai/api/v1/brands/BRAND_ID/perception-prompts"
{"docsConfig":{"theme":"almond","$schema":"https://mintlify.com/docs.json","name":"rocketblue","description":"# rocketblue\n\nrocketblue is an AI search visibility platform that helps businesses get discovered, recommended, and cited by AI assistants such as ChatGPT, Google AI Overviews, Gemini, Claude, Perplexity, and Copilot.\n\nInstead of simply monitoring AI search rankings, rocketblue **automates the work required to improve them**. It turns GEO and AI search expertise into a set of agentic tools that continuously find visibility gaps and take action across your website, content, YouTube, off-site mentions, and other sources that influence how AI models understand and recommend your business.\n\nrocketblue can:\n\n- **Monitor AI visibility** across major AI search engines, prompts, markets, and languages.\n- **Improve website AI-readiness** by identifying and fixing infrastructure issues that prevent AI systems from understanding or accessing your content.\n- **Create and publish content** designed to increase the likelihood of being discovered and cited by AI systems.\n- **Generate YouTube videos** that create additional sources for AI models to discover and cite.\n- **Find off-site opportunities** for relevant mentions and placements that can strengthen your presence across the web.\n- **Identify Reddit opportunities** where genuine discussions can help build awareness and relevance.\n- **Track citations and sources** to understand which content and websites influence AI responses.\n- **Monitor brand perception** to see how AI systems describe your business, products, and competitors.\n- **Measure competitors** and identify where they are winning visibility that you are missing.\n- **Track local and international visibility** across cities, countries, languages, and markets.\n\nrocketblue is built around a simple idea: **AI search visibility shouldn't require another full-time job.**\n\nThe platform combines large-scale AI response data, GEO expertise, and autonomous agents to continuously identify opportunities and execute improvements—so businesses can improve their visibility on autopilot while still having the data and controls needed to understand what is happening.","colors":{"primary":"#16A34A","light":"#07C983","dark":"#15803D"},"logo":{"light":"https://mintcdn.com/spotlight-91d6de8e/fV4SZTXppbAacapd/images/rocketblue-wide.png?fit=max\u0026auto=format\u0026n=fV4SZTXppbAacapd\u0026q=85\u0026s=2acf61950ecf72f50d7f01827f0d2c15","dark":"https://mintcdn.com/spotlight-91d6de8e/fV4SZTXppbAacapd/images/rocketblue-wide-dark.png?fit=max\u0026auto=format\u0026n=fV4SZTXppbAacapd\u0026q=85\u0026s=4b2b4c42141ad69fc628c98474da5af7","href":"https://rocketblue.ai"},"favicon":{"light":"https://mintcdn.com/spotlight-91d6de8e/Ue9m3Did92gqRuw8/images/rocketblue-icon-sm.png?fit=max\u0026auto=format\u0026n=Ue9m3Did92gqRuw8\u0026q=85\u0026s=bca433038c1d5adf6d192a04939b03f4","dark":"https://mintcdn.com/spotlight-91d6de8e/Ue9m3Did92gqRuw8/images/rocketblue-icon-sm.png?fit=max\u0026auto=format\u0026n=Ue9m3Did92gqRuw8\u0026q=85\u0026s=bca433038c1d5adf6d192a04939b03f4"},"navbar":{"links":[{"href":"https://rocketblue.ai/contact/","label":"Support"}],"primary":{"type":"button","label":"rocketblue dashboard","href":"https://app.rocketblue.ai"}},"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/spotlightllc","website":"https://rocketblue.ai"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"spotlight-91d6de8e","hasAudioNarration":false,"actualSubdomain":"spotlight-91d6de8e","customDomains":["docs.rocketblue.ai"],"gitSource":{"type":"github","owner":"mintlify-community","repo":"docs-spotlight-91d6de8e-fc8f393d","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae882e55d89f58bdbceeb9b","collectionId":"9a537989-c47f-4235-b085-8913e0961e8c","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae882e55d89f58bdbceeb9b"},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6ae882e55d89f58bdbceeb9b","clientVersion":"0.0.4067","searchFilterCounts":[{"language":"default","tag":"API reference","count":41},{"language":"default","tag":"API Reference","count":36},{"language":"default","tag":"Topics \u0026 Prompts","count":12},{"language":"default","tag":"Perception","count":7},{"language":"default","tag":"MCP","count":6},{"language":"default","tag":"Get Started","count":5},{"language":"default","tag":"Guides","count":5},{"language":"default","tag":"Onboarding","count":5},{"language":"default","tag":"Web Search Queries","count":3},{"language":"default","tag":"Brands","count":2}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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":"llms-txt-v2","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":"vite-origin","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":"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}],"googleFontsInlined":true},"customCss":[],"page":{"pagePath":"api-reference/topics-prompts/create-perception-prompts","slug":"/api-reference/topics-prompts/create-perception-prompts","pageMetadata":{"title":"Create perception prompts","api":"POST /v1/brands/{brandId}/perception-prompts","description":"Add perception prompts to a brand.","icon":"eye-plus","href":"/api-reference/topics-prompts/create-perception-prompts"},"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: \"Add perception prompts to a brand.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,em:`em`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{CodeBlock,Expandable,Heading,ParamField,Table}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Perception prompts are questions (e.g. `,_jsx(_components.em,{children:`“How trustworthy does this brand appear on a scale from 0–10?”`}),`) that are sent to LLMs to score brand attributes. This endpoint requires the `,_jsx(_components.strong,{children:`Custom Perception Prompts`}),` feature to be enabled for your organization.`]}),`\n`,_jsx(_components.p,{children:`Perception prompts share the same quota as regular prompts.`}),`\n`,_jsx(Heading,{level:`3`,id:`path-parameters`,children:`Path parameters`}),`\n`,_jsx(ParamField,{path:`brandId`,type:`string`,required:true,id:`param-brand-id`,children:_jsxs(_components.p,{children:[`Brand UUID. Obtain from `,_jsx(_components.a,{href:`/api-reference/brands/list`,children:`List brands`}),`.`]})}),`\n`,_jsx(Heading,{level:`3`,id:`request-body`,children:`Request body`}),`\n`,_jsx(ParamField,{body:`prompts`,type:`PerceptionPromptInput[]`,required:true,id:`param-prompts`,children:_jsx(Expandable,{title:`PerceptionPromptInput`})}),`\n`,_jsx(Heading,{level:`3`,id:`request`,children:`Request`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`19`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`19`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -s`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"x-spotlight-api-key: YOUR_API_KEY\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"prompts\": [`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` {`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"text\": \"On a scale from 0 to 10, how trustworthy does this brand appear?\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"propertyId\": \"Trust\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"scoringLogic\": \"0-6: detractor, 7-8: passive, 9-10: promoter\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` {`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"text\": \"How clear and easy to understand is this brand'\"'\"'s messaging?\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"propertyId\": \"Clarity\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"goodScore\": \"Messaging is clear and compelling\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"badScore\": \"Messaging is confusing or inconsistent\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` ]`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://app.rocketblue.ai/api/v1/brands/BRAND_ID/perception-prompts\"`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`3`,id:`response`,children:`Response`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`12`,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:`12`,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:` \"prompts\"`}),_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`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"perception-prompt-uuid-1\"`}),_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:` \"brandId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"brand-uuid-123\"`}),_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:` \"propertyId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Trust\"`}),_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:` \"promptText\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"On a scale from 0 to 10, how trustworthy does this brand appear?\"`}),_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:` \"scoringLogic\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"0-6: detractor, 7-8: passive, 9-10: promoter\"`})]}),`\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`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"remainingSlots\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`85`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`3`,id:`errors`,children:`Errors`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Status`}),_jsx(_components.th,{children:`Code`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`403`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`custom_perception_prompts_disabled`})}),_jsx(_components.td,{children:`Custom perception prompts are not enabled for this organization or brand.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`409`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`prompt_limit_exceeded`})}),_jsxs(_components.td,{children:[`Prompt quota reached. See `,_jsx(_components.a,{href:`/errors`,children:`Errors`}),`.`]})]})]})]})]})}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":"Create perception prompts","api":"POST /v1/brands/{brandId}/perception-prompts","description":"Add perception prompts to a brand.","icon":"eye-plus","href":"/api-reference/topics-prompts/create-perception-prompts"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Path parameters","slug":"path-parameters","depth":3,"children":[]},{"title":"Request body","slug":"request-body","depth":3,"children":[]},{"title":"Request","slug":"request","depth":3,"children":[]},{"title":"Response","slug":"response","depth":3,"children":[]},{"title":"Errors","slug":"errors","depth":3,"children":[]}],"codeExamples":{},"endpoint":{"title":"Create perception prompts","path":"/v1/brands/{brandId}/perception-prompts","method":"post","request":{"security":[],"parameters":{"query":{},"header":{},"cookie":{},"path":{"brandId":{"schema":[{"type":"string","description":"Brand UUID. Obtain from List brands .","required":true}]}}},"body":{"application/json":{"schemaArray":[{"type":"object","properties":{"prompts":[{"type":"array","items":[{"type":"object","properties":{}}],"required":true}]}}],"examples":{"example":{"value":{"prompts":[{}]}}}}}},"response":{},"deprecated":false}},"jsLinks":[],"subdomain":"spotlight-91d6de8e","siteName":"rocketblue","title":"Create perception prompts - rocketblue","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-07-28T10:06:34.180Z","originalFileLocation":"api-reference/topics-prompts/create-perception-prompts.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=\"Add perception prompts to a brand.\">\u003cmeta data-mint-head name=\"application-name\" content=\"rocketblue\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/spotlight-91d6de8e/DBNl8zfefVCuAJgg/_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/spotlight-91d6de8e/DBNl8zfefVCuAJgg/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/spotlight-91d6de8e/DBNl8zfefVCuAJgg/_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/spotlight-91d6de8e/DBNl8zfefVCuAJgg/_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/spotlight-91d6de8e/DBNl8zfefVCuAJgg/_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/spotlight-91d6de8e/DBNl8zfefVCuAJgg/_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/spotlight-91d6de8e/DBNl8zfefVCuAJgg/_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/spotlight-91d6de8e/DBNl8zfefVCuAJgg/_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/spotlight-91d6de8e/DBNl8zfefVCuAJgg/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create perception prompts - rocketblue\">\u003cmeta data-mint-head property=\"og:description\" content=\"Add perception prompts to a brand.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"rocketblue\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.rocketblue.ai/api-reference/topics-prompts/create-perception-prompts\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://spotlight-91d6de8e.mintlify.app/_mintlify/api/og/v2?division=Topics+%26+Prompts\u0026amp;title=Create+perception+prompts\u0026amp;description=Add+perception+prompts+to+a+brand.\u0026amp;theme=b55b26acbfff2e5adc91153f\u0026amp;signature=0610c49d4f5e4ef1621ffb6d9b77115b5169baca882ef2463636d3f23f3ed224\">\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=\"Create perception prompts - rocketblue\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Add perception prompts to a brand.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://spotlight-91d6de8e.mintlify.app/_mintlify/api/og/v2?division=Topics+%26+Prompts\u0026amp;title=Create+perception+prompts\u0026amp;description=Add+perception+prompts+to+a+brand.\u0026amp;theme=b55b26acbfff2e5adc91153f\u0026amp;signature=0610c49d4f5e4ef1621ffb6d9b77115b5169baca882ef2463636d3f23f3ed224\">\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/spotlight-91d6de8e/DBNl8zfefVCuAJgg/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"rocketblue\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#16A34A\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.rocketblue.ai/api-reference/topics-prompts/create-perception-prompts\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/topics-prompts/create-perception-prompts.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.rocketblue.ai/#organization\",\"name\":\"rocketblue\",\"url\":\"https://docs.rocketblue.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/spotlight-91d6de8e/fV4SZTXppbAacapd/images/rocketblue-wide.png?fit=max\u0026auto=format\u0026n=fV4SZTXppbAacapd\u0026q=85\u0026s=2acf61950ecf72f50d7f01827f0d2c15\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.rocketblue.ai#website\",\"name\":\"rocketblue\",\"url\":\"https://docs.rocketblue.ai\",\"publisher\":{\"@id\":\"https://docs.rocketblue.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.rocketblue.ai/api-reference/topics-prompts/create-perception-prompts#webpage\",\"url\":\"https://docs.rocketblue.ai/api-reference/topics-prompts/create-perception-prompts\",\"name\":\"Create perception prompts\",\"description\":\"Add perception prompts to a brand.\",\"dateModified\":\"2026-07-28T10:06:34.180Z\",\"isPartOf\":{\"@id\":\"https://docs.rocketblue.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.rocketblue.ai/api-reference/topics-prompts/create-perception-prompts#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.rocketblue.ai/api-reference/topics-prompts/create-perception-prompts#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API Reference\",\"item\":\"https://docs.rocketblue.ai/api-reference/discovery\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Topics \u0026 Prompts\",\"item\":\"https://docs.rocketblue.ai/api-reference/topics-prompts/batch-create\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Create perception prompts\",\"item\":\"https://docs.rocketblue.ai/api-reference/topics-prompts/create-perception-prompts\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.rocketblue.ai/api-reference/topics-prompts/create-perception-prompts#apireference\",\"headline\":\"Create perception prompts\",\"name\":\"Create perception prompts\",\"description\":\"Add perception prompts to a brand.\",\"url\":\"https://docs.rocketblue.ai/api-reference/topics-prompts/create-perception-prompts\",\"mainEntityOfPage\":{\"@id\":\"https://docs.rocketblue.ai/api-reference/topics-prompts/create-perception-prompts#webpage\"},\"dateModified\":\"2026-07-28T10:06:34.180Z\",\"publisher\":{\"@id\":\"https://docs.rocketblue.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.rocketblue.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"rocketblue\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"rocketblue","nav":{"global":null,"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":"/onboarding"}]},{"tab":"API reference","groups":[{"group":"Get Started","pages":[{"title":"Introduction","icon":"star","href":"/api-reference"},{"title":"Quickstart","icon":"rocket","href":"/quickstart"},{"title":"Authentication","icon":"key","href":"/authentication"},{"title":"Pagination","icon":"list","href":"/pagination"},{"title":"Errors","icon":"triangle-exclamation","href":"/errors"}]},{"group":"API Reference","pages":[{"title":"Discovery","icon":"plug","href":"/api-reference/discovery"},{"group":"Organization","pages":[{"title":"Get organization context","tag":"GET","href":"/api-reference/organization/context"}]},{"group":"Brands","pages":[{"title":"List brands","api":"GET /v1/brands","icon":"building","href":"/api-reference/brands/list"},{"title":"Get brand context","tag":"GET","href":"/api-reference/brands/context"}]},{"group":"Runs","pages":[{"title":"List runs","api":"GET /v1/brands/{brandId}/runs","icon":"clock-rotate-left","href":"/api-reference/runs/list"},{"title":"Get run stats","api":"GET /v1/runs/{runId}/stats","icon":"chart-bar","href":"/api-reference/runs/stats"}]},{"group":"Results","pages":[{"title":"Get run results","api":"GET /v1/runs/{runId}","icon":"table-list","href":"/api-reference/results/get-run-results"},{"title":"Get latest results","api":"GET /v1/brands/{brandId}/last/results","icon":"bolt","href":"/api-reference/results/get-latest-results"}]},{"group":"Created Content","pages":[{"title":"List created content","tag":"GET","href":"/api-reference/created-content/list"},{"title":"Get created content","tag":"GET","href":"/api-reference/created-content/get"}]},{"group":"Content Suggestions","pages":[{"title":"Get content suggestions","api":"GET /v1/runs/{runId}/content-suggestions","icon":"lightbulb","href":"/api-reference/content-suggestions/get-run-suggestions"},{"title":"Get latest content suggestions","api":"GET /v1/brands/{brandId}/last/content-suggestions","icon":"bolt","href":"/api-reference/content-suggestions/get-latest-suggestions"}]},{"group":"Sources","pages":[{"title":"Get run sources","api":"GET /v1/runs/{runId}/sources","icon":"link","href":"/api-reference/sources/get-run-sources"},{"title":"Get latest sources","api":"GET /v1/brands/{brandId}/last/sources","icon":"bolt","href":"/api-reference/sources/get-latest-sources"}]},{"group":"Web Search Queries","pages":[{"title":"Get run web search queries","tag":"GET","href":"/api-reference/web-search-queries/get-run"},{"title":"Get brand web search queries","tag":"GET","href":"/api-reference/web-search-queries/get-brand"},{"title":"Get latest web search queries","tag":"GET","href":"/api-reference/web-search-queries/get-latest"}]},{"group":"Perception","pages":[{"title":"Get brand perception","api":"GET /v1/brands/{brandId}/perception","icon":"eye","href":"/api-reference/perception/get-brand-perception"},{"title":"Get run perception","api":"GET /v1/runs/{runId}/perception","icon":"eye","href":"/api-reference/perception/get-run-perception"},{"title":"Get latest perception","api":"GET /v1/brands/{brandId}/last/perception","icon":"bolt","href":"/api-reference/perception/get-latest-perception"},{"title":"Get perception sources","api":"GET /v1/runs/{runId}/perception-sources","icon":"link","href":"/api-reference/perception/get-run-perception-sources"},{"title":"Get latest perception sources","api":"GET /v1/brands/{brandId}/last/perception-sources","icon":"bolt","href":"/api-reference/perception/get-latest-perception-sources"},{"title":"Get perception prompts \u0026 responses (run)","api":"GET /v1/runs/{runId}/perception-prompts-responses","icon":"message-lines","href":"/api-reference/perception/get-run-perception-prompts-responses"},{"title":"Get perception prompts \u0026 responses (brand)","api":"GET /v1/brands/{brandId}/perception-prompts-responses","icon":"message-lines","href":"/api-reference/perception/get-brand-perception-prompts-responses"}]},{"group":"Topics \u0026 Prompts","pages":[{"title":"Batch create topics \u0026 prompts","api":"POST /v1/brands/{brandId}/topics-prompts/batch","icon":"layer-group","href":"/api-reference/topics-prompts/batch-create"},{"title":"Create topics","api":"POST /v1/brands/{brandId}/topics","icon":"folder-plus","href":"/api-reference/topics-prompts/create-topics"},{"title":"Create prompts","api":"POST /v1/topics/{topicId}/prompts","icon":"plus","href":"/api-reference/topics-prompts/create-prompts"},{"title":"Batch update prompts","tag":"POST","href":"/api-reference/topics-prompts/batch-update-prompts"},{"title":"Move prompts to topic","tag":"POST","href":"/api-reference/topics-prompts/move-prompts-to-topic"},{"title":"Rename topic","tag":"PATCH","href":"/api-reference/topics-prompts/rename-topic"},{"title":"Batch update topics","tag":"POST","href":"/api-reference/topics-prompts/batch-update-topics"},{"title":"Batch delete prompts","description":"Delete multiple prompts in one request.","tag":"POST","href":"/api-reference/topics-prompts/batch-delete-prompts"},{"title":"Create perception prompts","api":"POST /v1/brands/{brandId}/perception-prompts","icon":"eye-plus","href":"/api-reference/topics-prompts/create-perception-prompts"},{"title":"Update perception prompts","api":"POST /v1/perception-prompts/batch-update","description":"Update the property and/or scoring logic on one or more existing perception prompts.","icon":"pen-to-square","href":"/api-reference/topics-prompts/update-perception-prompts"},{"title":"Delete prompt","api":"DELETE /v1/prompts/{promptId}","icon":"trash","href":"/api-reference/topics-prompts/delete-prompt"},{"title":"Delete topic","api":"DELETE /v1/topics/{topicId}","icon":"folder-minus","href":"/api-reference/topics-prompts/delete-topic"}]}]}]},{"tab":"MCP","pages":[{"title":"MCP","href":"/mcp-overview"}]}]},"basePath":"","title":"Create perception prompts - rocketblue","buildId":"dpl_9VVk5y1P8k1ATeJguVngy9Q3cmbD","deploymentId":"dpl_9VVk5y1P8k1ATeJguVngy9Q3cmbD","dynamics":["c2aa737661","2b790eda92","b0f84f53ff"],"chunks":["OpenApiReferenceProvider-DX1Meug0.js","utils-B_OMIQVC.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-ChxhRPMa.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-CuKvD8Iv.js","snippetPresets-C5d7p2hp.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CfHcE8m4.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C1zZV314.js","shallow-CmQhqCJn.js","getApiPlaygroundDisplay-YRo9s1O7.js","CodeSnippet-RN1MTdfk.js","CodeSnippets-DKLPHxJA.js","Page-BAvA99GL.js","getPastedJson-bz0M41mU.js","icon-CsmhpPrv.js","MethodPill-CNGsVE77.js","DuplicateIcon-DilfU_Z2.js","createIcon-BdsYzQck.js","DynamicMarkdown-CbqEDjbV.js","SectionHeading-O6hXpFCN.js","axios-vUo_bRtp.js"]}