Create prompts in bulk and queue them for sampling.
A prompt whose text matches an existing prompt in the category (ignoring
case and whitespace) is returned as already_exists, so retries are safe.
If the new prompts exceed the plan’s prompt limit, nothing is created and
the response is 403 limit_exceeded.
Prompts still allowed by the plan after this request; null if unlimited.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Gauge Docs","description":"Gauge Chat measures AI visibility. Gauge Agents measures which developer tools coding agents choose and whether they can use them successfully.","colors":{"primary":"#051b23","light":"#e8ff3f","dark":"#2A6E8D"},"logo":{"light":"https://mintcdn.com/gauge-42561b62/O5gj27o-wX8DVccM/logo/light.svg?fit=max\u0026auto=format\u0026n=O5gj27o-wX8DVccM\u0026q=85\u0026s=6fb77f0aeb3f1d4b0404a3fb65f04c29","dark":"https://mintcdn.com/gauge-42561b62/O5gj27o-wX8DVccM/logo/dark.svg?fit=max\u0026auto=format\u0026n=O5gj27o-wX8DVccM\u0026q=85\u0026s=836ca3f8817c0cd273c2b7b325efad8a"},"favicon":"https://mintcdn.com/gauge-42561b62/O5gj27o-wX8DVccM/logo/gauge-square.svg?fit=max\u0026auto=format\u0026n=O5gj27o-wX8DVccM\u0026q=85\u0026s=775cd8fd4e458bdbe03b36d0cb388c3c","navbar":{"links":[{"href":"/cli","label":"CLI"},{"href":"/gauge-mcp","label":"MCP"},{"href":"/resources/changelog","label":"Changelog"},{"href":"https://app.withgauge.com","label":"Back to Gauge"}]},"footer":{"socials":{"website":"https://withgauge.com"}},"styling":{"eyebrows":"breadcrumbs","latex":true},"markdown":{"instructions":["For API and SDK launches, integration testing, and ongoing coding-agent checks, start with Gauge Agents:","- [Gauge Agents overview](https://docs.withgauge.com/agents/index.md)","- [Gauge Agents quickstart](https://docs.withgauge.com/agents/quickstart.md)","- [Create and inspect an eval](https://docs.withgauge.com/agents/guides/create-an-eval-and-run-an-experiment.md)","- [Agent Experience: diagnose integration failures](https://docs.withgauge.com/agents/concepts/agent-experience.md)","- [Agent Preference: measure product selection](https://docs.withgauge.com/agents/concepts/agent-preference.md)","- [GitHub PR checks](https://docs.withgauge.com/agents/guides/github-pr-checks.md)","For AI search visibility and AEO, start with [Gauge Chat](https://docs.withgauge.com/introduction/welcome.md)."]},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"gauge-42561b62","hasAudioNarration":false,"actualSubdomain":"gauge-42561b62","customDomains":["docs.withgauge.com"],"gitSource":{"type":"github","owner":"gauge-sh","repo":"learn-with-gauge","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae92d4a85741843a858179e","collectionId":"5c61fb52-df61-4f10-82a3-703f1b02279a","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae92d4a85741843a858179e"},"feedback":{"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae943a39564a1f5338a921e","clientVersion":"0.0.4045","searchFilterCounts":[{"language":"default","tag":"Gauge Agents","count":152},{"language":"default","tag":"Endpoints","count":131},{"language":"default","tag":"Gauge Chat","count":49},{"language":"default","tag":"Navigating Gauge","count":17},{"language":"default","tag":"Agent Preference","count":13},{"language":"default","tag":"Optimizations","count":13},{"language":"default","tag":"Guides","count":12},{"language":"default","tag":"Runs","count":12},{"language":"default","tag":"Agent Experience","count":11},{"language":"default","tag":"Integrations","count":8}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"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":"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":"byok-sep-25","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":"billing-updated-9-15","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}],"googleFontsInlined":false},"customCss":[{"filePath":"custom.css","content":"@import url(https://fonts.googleapis.com/css2?family=DM+Sans:wght@400;500;600;700\u0026display=swap);@import url(https://fonts.bunny.net/css?family=switzer:300,400,500,600);*,::after,::before{border-radius:0!important}html[data-current-path^=\"/agents/api-reference/\"] [data-component-part=code-block-root],html[data-current-path^=\"/agents/api-reference/\"] [data-component-part=code-block-root]::-webkit-scrollbar-thumb{border-radius:0!important}a,body,li,p,span{font-family:'Switzer','Arial',sans-serif!important}#content [data-component-part=step-content],#content.prose{color:#051b23}.dark #content [data-component-part=step-content],.dark #content.prose,.dark .docs-overview li,.dark .docs-overview p,.dark .docs-overview td{color:#d4d4d8}.prose h1,.prose h2,.prose h3,[class*=heading],[class*=title],h1,h2,h3,h4,h5,h6{font-family:'DM Sans','Arial',sans-serif!important;font-weight:700!important;letter-spacing:-.02em!important}.bg-primary\\/10.text-primary{background-color:#e8ff3f!important;color:#051b23!important;text-shadow:none!important}.docs-primary-button{background-color:#051b23;color:#fff!important}.dark .docs-primary-button{background-color:#e8ff3f;color:#051b23!important}.docs-overview,.docs-overview h1,.docs-overview h2,.docs-overview h3,.docs-overview li,.docs-overview p,.docs-overview td{color:#000}.dark .docs-overview,.dark .docs-overview h1,.dark .docs-overview h2,.dark .docs-overview h3{color:#fff}.docs-overview li>a,.docs-overview p>a{color:#2563eb!important;text-decoration:underline;text-underline-offset:2px}.dark .docs-overview li>a,.dark .docs-overview p>a{color:#60a5fa!important}.docs-pricing-grid{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:1.5rem}.docs-pricing-card{display:flex;flex-direction:column;overflow:hidden;border:1px solid #d1d5db;background:#fff;box-shadow:0 16px 40px -32px rgba(5,27,35,.55)}.docs-pricing-card-body{flex:1;padding:1.75rem}.docs-product-label{display:inline-flex;margin-bottom:1rem;background:#eff3f4;padding:.4rem .7rem;color:#2a5668;font-size:.75rem;font-weight:600;letter-spacing:.025em}.docs-pricing-card h3{margin:0;color:#051b23;font-size:1.35rem;line-height:1.25}.docs-pricing-summary{margin-top:.85rem;color:#4b5563!important;line-height:1.65}.docs-value-highlight{display:flex;align-items:center;gap:.85rem;margin-top:1.5rem;background:#f8fadf;padding:1rem}.docs-value-highlight strong{flex:none;color:#051b23;font-family:'DM Sans','Arial',sans-serif;font-size:1.75rem;line-height:1}.docs-value-highlight span{color:#35454b;font-size:.85rem;line-height:1.35}.docs-metric-grid{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:1rem;margin-top:1.5rem}.docs-metric-grid div,.docs-pricing-card-footer{display:flex;flex-direction:column;gap:.2rem}.docs-metric-grid strong{color:#051b23;font-size:1rem}.docs-metric-grid span{color:#6b7280;font-size:.78rem;line-height:1.35}.docs-pricing-card-footer{gap:1rem;border-top:1px solid #e5e7eb;background:#f8fafb;padding:1.5rem 1.75rem}.docs-plan-name{color:#4b5563;font-size:.78rem;font-weight:600;text-transform:uppercase;letter-spacing:.05em}.docs-price{display:flex;align-items:baseline;gap:.3rem;margin-top:.2rem;color:#051b23}.docs-price strong{font-family:'DM Sans','Arial',sans-serif;font-size:2rem;letter-spacing:-.04em}.docs-price span{color:#4b5563;font-size:.9rem}.docs-pricing-card-footer p{margin:.25rem 0 0;color:#4b5563!important;font-size:.85rem;line-height:1.5}.docs-pricing-cta{display:block;background:#e8ff3f;padding:.75rem 1rem;color:#051b23!important;font-size:.9rem;font-weight:600;text-align:center;text-decoration:none!important;transition:opacity 150ms ease}.docs-pricing-cta:hover{opacity:.88}.docs-enterprise-note{font-size:.78rem!important}.dark .docs-pricing-card{border-color:#3f3f46;background:#18181b;box-shadow:none}.dark .docs-product-label{background:#24333a;color:#c7d9df}.dark .docs-metric-grid strong,.dark .docs-price,.dark .docs-pricing-card h3,.dark .docs-value-highlight strong{color:#fff}.dark .docs-pricing-card-footer p,.dark .docs-pricing-summary{color:#d4d4d8!important}.dark .docs-value-highlight{background:#30351d}.dark .docs-metric-grid span,.dark .docs-plan-name,.dark .docs-price span,.dark .docs-value-highlight span{color:#b9c0c3}.dark .docs-pricing-card-footer{border-color:#3f3f46;background:#202024}.dark .docs-pricing-cta{background:#e8ff3f;color:#051b23!important}@media (min-width:768px){.docs-pricing-grid{row-gap:0}.docs-pricing-card{display:grid;grid-row:span 4;grid-template-rows:subgrid;row-gap:0}.docs-pricing-card-footer{display:grid;grid-row:span 3;grid-template-rows:subgrid}}@media (max-width:767px){.docs-pricing-grid{grid-template-columns:1fr}}html[data-current-path=\"/resources/changelog\"] .update-container{flex-direction:column;gap:1rem;padding:2rem 0;border-top:1px solid #e5e7eb}html[data-current-path=\"/resources/changelog\"] .update-container>div:first-child{position:static;width:100%}html[data-current-path=\"/resources/changelog\"] [data-component-part=update-label]{background:0 0!important;color:#52616b!important;padding:0;font-size:.8125rem;text-align:left;justify-content:flex-start}html[data-current-path=\"/resources/changelog\"] [data-component-part=update-tag-list]{display:none}html[data-current-path=\"/resources/changelog\"] [data-component-part=update-content]{font-size:1rem;line-height:1.75}html[data-current-path=\"/resources/changelog\"] [data-component-part=update-content] h2{margin-top:0;font-size:1.375rem;line-height:1.35}html[data-current-path=\"/resources/changelog\"] [data-component-part=update-content] ul{margin-bottom:0}html[data-current-path=\"/resources/changelog\"] [data-component-part=update-content] li{margin-top:1rem}html.dark[data-current-path=\"/resources/changelog\"] .update-container{border-color:#30363d}html.dark[data-current-path=\"/resources/changelog\"] [data-component-part=update-label]{color:#a1a1aa!important}"}],"page":{"pagePath":"chat/api-reference/endpoints/prompts/create-prompts","slug":"/chat/api-reference/endpoints/prompts/create-prompts","pageMetadata":{"openapi":"chat/openapi.json POST /orgs/{org}/categories/{category}/prompts","title":"Create prompts","description":"Create prompts in bulk and queue them for sampling.\n\nA prompt whose text matches an existing prompt in the category (ignoring\ncase and whitespace) is returned as `already_exists`, so retries are safe.\nIf the new prompts exceed the plan's prompt limit, nothing is created and\nthe response is 403 `limit_exceeded`.","href":"/chat/api-reference/endpoints/prompts/create-prompts"},"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 p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Create prompts in bulk and queue them for sampling.\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"A prompt whose text matches an existing prompt in the category (ignoring\\ncase and whitespace) is returned as \", _jsx(_components.code, {\n children: \"already_exists\"\n }), \", so retries are safe.\\nIf the new prompts exceed the plan’s prompt limit, nothing is created and\\nthe response is 403 \", _jsx(_components.code, {\n children: \"limit_exceeded\"\n }), \".\"]\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"openapi":"chat/openapi.json POST /orgs/{org}/categories/{category}/prompts","title":"Create prompts","description":"Create prompts in bulk and queue them for sampling.\n\nA prompt whose text matches an existing prompt in the category (ignoring\ncase and whitespace) is returned as `already_exists`, so retries are safe.\nIf the new prompts exceed the plan's prompt limit, nothing is created and\nthe response is 403 `limit_exceeded`.","href":"/chat/api-reference/endpoints/prompts/create-prompts"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"createPrompts","summary":"Create prompts","parameters":["c8440ac9-2312-4dba-9c87-ada0ee348323","001abcb4-ca6f-4da3-b0a6-09e22e077d2c","62ffdd92-abd8-4537-ad6b-94d8ba2fd4dc"],"responses":{"200":"c27f0ac8-9654-4c18-804b-159295a2ba49","201":"5ab1d80a-426d-47d6-b820-930a90182ace","400":"b9c33d79-0c49-4b61-9a15-dbda9a111937","401":"39b129a2-2e7b-43bd-84d9-725cf8d48b2e","403":"e6069f2c-5650-4e96-bc69-737be98b4b65","404":"3cdbb6fe-485f-4c22-94c9-3bf6844ca929","429":"d99def57-4d73-4ceb-a936-1d13ce38ef1a"},"description":"Create prompts in bulk and queue them for sampling.\n\nA prompt whose text matches an existing prompt in the category (ignoring\ncase and whitespace) is returned as `already_exists`, so retries are safe.\nIf the new prompts exceed the plan's prompt limit, nothing is created and\nthe response is 403 `limit_exceeded`.","tags":["Prompts"],"requestBody":"1fbd30c7-5a95-4dec-a286-2dbe544994b7","method":"post","type":"path","servers":["6a9882fa-3696-4650-b10a-274bc5a17c8d"],"security":["c9e1a190-94d7-431c-9d5b-f511b6d49c03"],"path":"/orgs/{org}/categories/{category}/prompts","baseUrlOptions":["https://app.withgauge.com/api/v1"],"title":"Create prompts","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"c8440ac9-2312-4dba-9c87-ada0ee348323":{"in":"path","name":"org","schema":{"title":"Org","type":"string","isRequired":true,"uniqueKey":"","typeLabel":"string"},"required":true},"001abcb4-ca6f-4da3-b0a6-09e22e077d2c":{"in":"path","name":"category","schema":{"title":"Category","type":"string","isRequired":true,"uniqueKey":"","typeLabel":"string"},"required":true},"62ffdd92-abd8-4537-ad6b-94d8ba2fd4dc":{"in":"query","name":"dryRun","schema":{"default":false,"title":"Dryrun","type":"boolean","isRequired":false,"uniqueKey":"","typeLabel":"boolean"},"required":false}},"requestBody":{"content":{"application/json":{"schema":{"properties":{"prompts":{"items":{"properties":{"text":{"maxLength":500,"minLength":1,"title":"Text","type":"string","isRequired":true,"uniqueKey":"prompts.items.[INDEX].text","typeLabel":"string"},"topicId":{"title":"Topicid","type":"string","isRequired":true,"uniqueKey":"prompts.items.[INDEX].topicId","typeLabel":"string"},"trackingType":{"default":"visibility","enum":["visibility","branded_own"],"title":"Trackingtype","type":"string","uniqueKey":"prompts.items.[INDEX].trackingType","typeLabel":"enum\u003cstring>"},"tagIds":{"items":{"type":"string","uniqueKey":"prompts.items.[INDEX].tagIds.items.[INDEX]","typeLabel":"string"},"title":"Tagids","type":"array","uniqueKey":"prompts.items.[INDEX].tagIds","typeLabel":"string[]"}},"required":["text","topicId"],"title":"PromptIn","type":"object","uniqueKey":"prompts.items.[INDEX]","typeLabel":"PromptIn · object"},"maxItems":500,"minItems":1,"title":"Prompts","type":"array","isRequired":true,"uniqueKey":"prompts","typeLabel":"PromptIn · object[]"}},"required":["prompts"],"title":"CreatePromptsIn","type":"object","uniqueKey":"","typeLabel":"CreatePromptsIn · object"},"examples":{"Example":{"title":"Example","value":{"prompts":[{"text":"\u003cstring>","topicId":"\u003cstring>","trackingType":"visibility","tagIds":["\u003cstring>"]}]}}},"exampleType":"generated"}},"required":true,"exampleType":"generated"},"responses":{"c27f0ac8-9654-4c18-804b-159295a2ba49":{"description":"OK","content":{"application/json":{"schema":{"properties":{"results":{"items":{"properties":{"index":{"title":"Index","type":"integer","isRequired":true,"uniqueKey":"results.items.[INDEX].index","typeLabel":"integer"},"status":{"enum":["created","already_exists","would_create"],"title":"Status","type":"string","isRequired":true,"uniqueKey":"results.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"prompt":{"oneOf":[{"type":"object","title":"PromptOut","required":["id","text","topicId","trackingType","tagIds","createdAt","firstAnswerDay"],"properties":{"id":{"title":"Id","type":"string","isRequired":true,"uniqueKey":"results.items.[INDEX].prompt.oneOf.0.id","typeLabel":"string"},"text":{"title":"Text","type":"string","isRequired":true,"uniqueKey":"results.items.[INDEX].prompt.oneOf.0.text","typeLabel":"string"},"topicId":{"oneOf":[{"type":"string","title":"Topicid","isRequired":true,"uniqueKey":"results.items.[INDEX].prompt.oneOf.0.topicId.oneOf.0","typeLabel":"string"},{"type":"null","title":"Topicid","isRequired":true,"uniqueKey":"results.items.[INDEX].prompt.oneOf.0.topicId.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"results.items.[INDEX].prompt.oneOf.0.topicId","typeLabel":"string | null"},"trackingType":{"title":"Trackingtype","type":"string","isRequired":true,"uniqueKey":"results.items.[INDEX].prompt.oneOf.0.trackingType","typeLabel":"string"},"tagIds":{"items":{"type":"string","uniqueKey":"results.items.[INDEX].prompt.oneOf.0.tagIds.items.[INDEX]","typeLabel":"string"},"title":"Tagids","type":"array","isRequired":true,"uniqueKey":"results.items.[INDEX].prompt.oneOf.0.tagIds","typeLabel":"string[]"},"createdAt":{"format":"date-time","title":"Createdat","type":"string","isRequired":true,"uniqueKey":"results.items.[INDEX].prompt.oneOf.0.createdAt","typeLabel":"string\u003cdate-time>"},"firstAnswerDay":{"oneOf":[{"type":"string","title":"Firstanswerday","description":"Pacific date of the prompt's first answer; null until sampled.","format":"date","isRequired":true,"uniqueKey":"results.items.[INDEX].prompt.oneOf.0.firstAnswerDay.oneOf.0","typeLabel":"string\u003cdate>"},{"type":"null","title":"Firstanswerday","description":"Pacific date of the prompt's first answer; null until sampled.","isRequired":true,"uniqueKey":"results.items.[INDEX].prompt.oneOf.0.firstAnswerDay.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"results.items.[INDEX].prompt.oneOf.0.firstAnswerDay","typeLabel":"string\u003cdate> | null"}},"uniqueKey":"results.items.[INDEX].prompt.oneOf.0","typeLabel":"PromptOut · object"},{"type":"null","uniqueKey":"results.items.[INDEX].prompt.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].prompt","typeLabel":"PromptOut · object | null"}},"required":["index","status"],"title":"CreateResult","type":"object","uniqueKey":"results.items.[INDEX]","typeLabel":"CreateResult · object"},"title":"Results","type":"array","isRequired":true,"uniqueKey":"results","typeLabel":"CreateResult · object[]"},"dryRun":{"title":"Dryrun","type":"boolean","isRequired":true,"uniqueKey":"dryRun","typeLabel":"boolean"},"remaining":{"oneOf":[{"type":"integer","title":"Remaining","description":"Prompts still allowed by the plan after this request; null if unlimited.","isRequired":true,"uniqueKey":"remaining.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Remaining","description":"Prompts still allowed by the plan after this request; null if unlimited.","isRequired":true,"uniqueKey":"remaining.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"remaining","typeLabel":"integer | null"}},"required":["results","dryRun","remaining"],"title":"CreatePromptsOut","type":"object","uniqueKey":"","typeLabel":"CreatePromptsOut · object"},"examples":{"Example":{"title":"Example","value":{"results":[{"index":123,"status":"created","prompt":{"id":"\u003cstring>","text":"\u003cstring>","topicId":"\u003cstring>","trackingType":"\u003cstring>","tagIds":["\u003cstring>"],"createdAt":"2023-11-07T05:31:56Z","firstAnswerDay":"2023-12-25"}}],"dryRun":true,"remaining":123}}},"exampleType":"generated"}},"exampleType":"generated"},"5ab1d80a-426d-47d6-b820-930a90182ace":{"description":"Created","content":{"application/json":{"schema":{"properties":{"results":{"items":{"properties":{"index":{"title":"Index","type":"integer","isRequired":true,"uniqueKey":"results.items.[INDEX].index","typeLabel":"integer"},"status":{"enum":["created","already_exists","would_create"],"title":"Status","type":"string","isRequired":true,"uniqueKey":"results.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"prompt":{"oneOf":[{"type":"object","title":"PromptOut","required":["id","text","topicId","trackingType","tagIds","createdAt","firstAnswerDay"],"properties":{"id":{"title":"Id","type":"string","isRequired":true,"uniqueKey":"results.items.[INDEX].prompt.oneOf.0.id","typeLabel":"string"},"text":{"title":"Text","type":"string","isRequired":true,"uniqueKey":"results.items.[INDEX].prompt.oneOf.0.text","typeLabel":"string"},"topicId":{"oneOf":[{"type":"string","title":"Topicid","isRequired":true,"uniqueKey":"results.items.[INDEX].prompt.oneOf.0.topicId.oneOf.0","typeLabel":"string"},{"type":"null","title":"Topicid","isRequired":true,"uniqueKey":"results.items.[INDEX].prompt.oneOf.0.topicId.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"results.items.[INDEX].prompt.oneOf.0.topicId","typeLabel":"string | null"},"trackingType":{"title":"Trackingtype","type":"string","isRequired":true,"uniqueKey":"results.items.[INDEX].prompt.oneOf.0.trackingType","typeLabel":"string"},"tagIds":{"items":{"type":"string","uniqueKey":"results.items.[INDEX].prompt.oneOf.0.tagIds.items.[INDEX]","typeLabel":"string"},"title":"Tagids","type":"array","isRequired":true,"uniqueKey":"results.items.[INDEX].prompt.oneOf.0.tagIds","typeLabel":"string[]"},"createdAt":{"format":"date-time","title":"Createdat","type":"string","isRequired":true,"uniqueKey":"results.items.[INDEX].prompt.oneOf.0.createdAt","typeLabel":"string\u003cdate-time>"},"firstAnswerDay":{"oneOf":[{"type":"string","title":"Firstanswerday","description":"Pacific date of the prompt's first answer; null until sampled.","format":"date","isRequired":true,"uniqueKey":"results.items.[INDEX].prompt.oneOf.0.firstAnswerDay.oneOf.0","typeLabel":"string\u003cdate>"},{"type":"null","title":"Firstanswerday","description":"Pacific date of the prompt's first answer; null until sampled.","isRequired":true,"uniqueKey":"results.items.[INDEX].prompt.oneOf.0.firstAnswerDay.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"results.items.[INDEX].prompt.oneOf.0.firstAnswerDay","typeLabel":"string\u003cdate> | null"}},"uniqueKey":"results.items.[INDEX].prompt.oneOf.0","typeLabel":"PromptOut · object"},{"type":"null","uniqueKey":"results.items.[INDEX].prompt.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].prompt","typeLabel":"PromptOut · object | null"}},"required":["index","status"],"title":"CreateResult","type":"object","uniqueKey":"results.items.[INDEX]","typeLabel":"CreateResult · object"},"title":"Results","type":"array","isRequired":true,"uniqueKey":"results","typeLabel":"CreateResult · object[]"},"dryRun":{"title":"Dryrun","type":"boolean","isRequired":true,"uniqueKey":"dryRun","typeLabel":"boolean"},"remaining":{"oneOf":[{"type":"integer","title":"Remaining","description":"Prompts still allowed by the plan after this request; null if unlimited.","isRequired":true,"uniqueKey":"remaining.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Remaining","description":"Prompts still allowed by the plan after this request; null if unlimited.","isRequired":true,"uniqueKey":"remaining.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"remaining","typeLabel":"integer | null"}},"required":["results","dryRun","remaining"],"title":"CreatePromptsOut","type":"object","uniqueKey":"","typeLabel":"CreatePromptsOut · object"},"examples":{"Example":{"title":"Example","value":{"results":[{"index":123,"status":"created","prompt":{"id":"\u003cstring>","text":"\u003cstring>","topicId":"\u003cstring>","trackingType":"\u003cstring>","tagIds":["\u003cstring>"],"createdAt":"2023-11-07T05:31:56Z","firstAnswerDay":"2023-12-25"}}],"dryRun":true,"remaining":123}}},"exampleType":"generated"}},"exampleType":"generated"},"b9c33d79-0c49-4b61-9a15-dbda9a111937":{"description":"Bad Request","content":{"application/json":{"schema":{"properties":{"error":{"properties":{"code":{"title":"Code","type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"title":"Message","type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"field":{"oneOf":[{"type":"string","title":"Field","uniqueKey":"error.field.oneOf.0","typeLabel":"string"},{"type":"null","title":"Field","uniqueKey":"error.field.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.field","typeLabel":"string | null"}},"required":["code","message"],"title":"ErrorDetail","type":"object","isRequired":true,"uniqueKey":"error","typeLabel":"ErrorDetail · object"}},"required":["error"],"title":"ErrorResponse","type":"object","uniqueKey":"","typeLabel":"ErrorResponse · object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","field":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"39b129a2-2e7b-43bd-84d9-725cf8d48b2e":{"description":"Unauthorized","content":{"application/json":{"schema":{"properties":{"error":{"properties":{"code":{"title":"Code","type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"title":"Message","type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"field":{"oneOf":[{"type":"string","title":"Field","uniqueKey":"error.field.oneOf.0","typeLabel":"string"},{"type":"null","title":"Field","uniqueKey":"error.field.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.field","typeLabel":"string | null"}},"required":["code","message"],"title":"ErrorDetail","type":"object","isRequired":true,"uniqueKey":"error","typeLabel":"ErrorDetail · object"}},"required":["error"],"title":"ErrorResponse","type":"object","uniqueKey":"","typeLabel":"ErrorResponse · object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","field":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"e6069f2c-5650-4e96-bc69-737be98b4b65":{"description":"Forbidden","content":{"application/json":{"schema":{"properties":{"error":{"properties":{"code":{"title":"Code","type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"title":"Message","type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"field":{"oneOf":[{"type":"string","title":"Field","uniqueKey":"error.field.oneOf.0","typeLabel":"string"},{"type":"null","title":"Field","uniqueKey":"error.field.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.field","typeLabel":"string | null"}},"required":["code","message"],"title":"ErrorDetail","type":"object","isRequired":true,"uniqueKey":"error","typeLabel":"ErrorDetail · object"}},"required":["error"],"title":"ErrorResponse","type":"object","uniqueKey":"","typeLabel":"ErrorResponse · object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","field":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"3cdbb6fe-485f-4c22-94c9-3bf6844ca929":{"description":"Not Found","content":{"application/json":{"schema":{"properties":{"error":{"properties":{"code":{"title":"Code","type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"title":"Message","type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"field":{"oneOf":[{"type":"string","title":"Field","uniqueKey":"error.field.oneOf.0","typeLabel":"string"},{"type":"null","title":"Field","uniqueKey":"error.field.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.field","typeLabel":"string | null"}},"required":["code","message"],"title":"ErrorDetail","type":"object","isRequired":true,"uniqueKey":"error","typeLabel":"ErrorDetail · object"}},"required":["error"],"title":"ErrorResponse","type":"object","uniqueKey":"","typeLabel":"ErrorResponse · object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","field":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"d99def57-4d73-4ceb-a936-1d13ce38ef1a":{"description":"Too Many Requests","content":{"application/json":{"schema":{"properties":{"error":{"properties":{"code":{"title":"Code","type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"title":"Message","type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"field":{"oneOf":[{"type":"string","title":"Field","uniqueKey":"error.field.oneOf.0","typeLabel":"string"},{"type":"null","title":"Field","uniqueKey":"error.field.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.field","typeLabel":"string | null"}},"required":["code","message"],"title":"ErrorDetail","type":"object","isRequired":true,"uniqueKey":"error","typeLabel":"ErrorDetail · object"}},"required":["error"],"title":"ErrorResponse","type":"object","uniqueKey":"","typeLabel":"ErrorResponse · object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","field":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"c9e1a190-94d7-431c-9d5b-f511b6d49c03":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"gauge_sk_\u003ckey>","description":"An organization API key from **Settings → Integrations → API Keys**, or a Gauge CLI login token from `gauge auth login`.","scopes":[],"schemeName":"BearerAuth"}}},"servers":{"6a9882fa-3696-4650-b10a-274bc5a17c8d":{"url":"https://app.withgauge.com/api/v1","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"gauge_sk_\u003ckey>","description":"An organization API key from **Settings → Integrations → API Keys**, or a Gauge CLI login token from `gauge auth login`.","scopes":[],"schemeName":"BearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"An organization API key from **Settings → Integrations → API Keys**, or a Gauge CLI login token from `gauge auth login`.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"BearerAuth","name":"Authorization"}],"title":"BearerAuth"}]},"originalFileLocation":"chat/openapi.json"},"subdomain":"gauge-42561b62","siteName":"Gauge Docs","title":"Create prompts - Gauge Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-03T02:15:10.487Z","originalFileLocation":"chat/api-reference/endpoints/prompts/create-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=\"Create prompts in bulk and queue them for sampling. A prompt whose text matches an existing prompt in the category (ignoring case and whitespace) is returned as already_exists, so retries are safe. If the new prompts exceed the plan\u0026#x27;s prompt limit, nothing is created and the response is 403 limit_exceeded.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Gauge Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/gauge-42561b62/d3-6r91DtnHOn4L9/_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/gauge-42561b62/d3-6r91DtnHOn4L9/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/gauge-42561b62/d3-6r91DtnHOn4L9/_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/gauge-42561b62/d3-6r91DtnHOn4L9/_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/gauge-42561b62/d3-6r91DtnHOn4L9/_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/gauge-42561b62/d3-6r91DtnHOn4L9/_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/gauge-42561b62/d3-6r91DtnHOn4L9/_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/gauge-42561b62/d3-6r91DtnHOn4L9/_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/gauge-42561b62/d3-6r91DtnHOn4L9/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create prompts - Gauge Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Create prompts in bulk and queue them for sampling. A prompt whose text matches an existing prompt in the category (ignoring case and whitespace) is returned as already_exists, so retries are safe. If the new prompts exceed the plan\u0026#x27;s prompt limit, nothing is created and the response is 403 limit_exceeded.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Gauge Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.withgauge.com/chat/api-reference/endpoints/prompts/create-prompts\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://gauge-42561b62.mintlify.app/_mintlify/api/og/v2?division=Prompts\u0026amp;title=Create+prompts\u0026amp;description=Create+prompts+in+bulk+and+queue+them+for+sampling.%0A%0AA+prompt+whose+text+matches+an+existing+prompt+in+the+category+%28ignoring%0Acase+and+whitespace%29+is+returned+a\u0026amp;theme=51b328f76a6bbd0e82d58487\u0026amp;signature=dc3f1f06ba34ab6a82f5cfb3bb2495fef870fa5e46e5745f5e1f1ba1b7ffc29e\">\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 prompts - Gauge Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Create prompts in bulk and queue them for sampling. A prompt whose text matches an existing prompt in the category (ignoring case and whitespace) is returned as already_exists, so retries are safe. If the new prompts exceed the plan\u0026#x27;s prompt limit, nothing is created and the response is 403 limit_exceeded.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://gauge-42561b62.mintlify.app/_mintlify/api/og/v2?division=Prompts\u0026amp;title=Create+prompts\u0026amp;description=Create+prompts+in+bulk+and+queue+them+for+sampling.%0A%0AA+prompt+whose+text+matches+an+existing+prompt+in+the+category+%28ignoring%0Acase+and+whitespace%29+is+returned+a\u0026amp;theme=51b328f76a6bbd0e82d58487\u0026amp;signature=dc3f1f06ba34ab6a82f5cfb3bb2495fef870fa5e46e5745f5e1f1ba1b7ffc29e\">\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/gauge-42561b62/d3-6r91DtnHOn4L9/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Gauge Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#051b23\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.withgauge.com/chat/api-reference/endpoints/prompts/create-prompts\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/chat/api-reference/endpoints/prompts/create-prompts.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.withgauge.com/#organization\",\"name\":\"Gauge Docs\",\"url\":\"https://docs.withgauge.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/gauge-42561b62/O5gj27o-wX8DVccM/logo/light.svg?fit=max\u0026auto=format\u0026n=O5gj27o-wX8DVccM\u0026q=85\u0026s=6fb77f0aeb3f1d4b0404a3fb65f04c29\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.withgauge.com#website\",\"name\":\"Gauge Docs\",\"url\":\"https://docs.withgauge.com\",\"publisher\":{\"@id\":\"https://docs.withgauge.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.withgauge.com/chat/api-reference/endpoints/prompts/create-prompts#webpage\",\"url\":\"https://docs.withgauge.com/chat/api-reference/endpoints/prompts/create-prompts\",\"name\":\"Create prompts\",\"description\":\"Create prompts in bulk and queue them for sampling. A prompt whose text matches an existing prompt in the category (ignoring case and whitespace) is returned as already_exists, so retries are safe. If the new prompts exceed the plan's prompt limit, nothing is created and the response is 403 limit_exceeded.\",\"dateModified\":\"2026-11-03T02:15:10.487Z\",\"isPartOf\":{\"@id\":\"https://docs.withgauge.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.withgauge.com/chat/api-reference/endpoints/prompts/create-prompts#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.withgauge.com/chat/api-reference/endpoints/prompts/create-prompts#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API reference\",\"item\":\"https://docs.withgauge.com/chat/api-reference/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Endpoints\",\"item\":\"https://docs.withgauge.com/chat/api-reference/endpoints/organizations/get-current-credential\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Prompts\",\"item\":\"https://docs.withgauge.com/chat/api-reference/endpoints/prompts/list-prompts\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"Create prompts\",\"item\":\"https://docs.withgauge.com/chat/api-reference/endpoints/prompts/create-prompts\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.withgauge.com/chat/api-reference/endpoints/prompts/create-prompts#apireference\",\"headline\":\"Create prompts\",\"name\":\"Create prompts\",\"description\":\"Create prompts in bulk and queue them for sampling. A prompt whose text matches an existing prompt in the category (ignoring case and whitespace) is returned as already_exists, so retries are safe. If the new prompts exceed the plan's prompt limit, nothing is created and the response is 403 limit_exceeded.\",\"url\":\"https://docs.withgauge.com/chat/api-reference/endpoints/prompts/create-prompts\",\"mainEntityOfPage\":{\"@id\":\"https://docs.withgauge.com/chat/api-reference/endpoints/prompts/create-prompts#webpage\"},\"dateModified\":\"2026-11-03T02:15:10.487Z\",\"publisher\":{\"@id\":\"https://docs.withgauge.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.withgauge.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Gauge Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Gauge Docs","nav":{"global":null,"products":[{"product":"Gauge Chat","icon":"messages","description":"AI visibility","groups":[{"group":"Introduction","pages":[{"title":"Gauge Chat overview","sidebarTitle":"Overview","href":"/introduction/welcome"},{"title":"Using Gauge Chat and Gauge Agents","href":"/introduction/chat-and-agents"},{"title":"Gauge Chat quickstart","sidebarTitle":"Quickstart","href":"/setup/integrations-and-settings"},{"title":"How do AI Models Search?","href":"/introduction/how-do-ai-models-search"},{"title":"Core AEO Metrics","href":"/introduction/core-aeo-metrics"},{"title":"How to Improve AI Visibility","href":"/introduction/how-to-improve-ai-visibility"}]},{"group":"Key Concepts","pages":[{"title":"AI Engines Gauge Tracks","href":"/navigating/ai-engines"},{"title":"Prompt Runs","href":"/navigating/prompt-runs"},{"title":"Branded Prompts","href":"/help/branded-prompts"},{"title":"Memory","href":"/navigating/memory"},{"title":"Skills","href":"/navigating/skills"},{"title":"Scheduled prompts","href":"/navigating/scheduled-prompts"},{"title":"Agencies","href":"/navigating/agencies"}]},{"group":"Navigating Gauge","pages":[{"title":"Organization Dashboard","href":"/navigating/dashboard"},{"title":"Ask Gauge","href":"/navigating/ask-gauge"},{"title":"Action Center","href":"/navigating/action-center"},{"title":"Rankings \u0026 Visibility","href":"/navigating/rankings-visibility"},{"title":"Prompts","href":"/navigating/prompts"},{"title":"Citations","href":"/navigating/citations"},{"title":"Topics","href":"/navigating/topics"},{"title":"Competitors \u0026 Brand Tracking","href":"/navigating/competitors"},{"title":"Sentiment Analysis","href":"/navigating/sentiment-analysis"},{"title":"Reddit","href":"/navigating/reddit"},{"title":"YouTube","href":"/navigating/youtube"},{"title":"AI Traffic","href":"/navigating/ai-traffic"},{"title":"Fanouts","href":"/navigating/fanouts"},{"title":"Content Engine","href":"/navigating/content"},{"title":"Library","href":"/navigating/library"},{"title":"ChatGPT Ads","href":"/navigating/chatgpt-ads"},{"title":"Ads Monitoring","href":"/navigating/ads-monitoring"}]},{"group":"Integrations","pages":[{"title":"Google Integration (Search Console, Analytics \u0026 Ads)","href":"/help/google-integration"},{"title":"PostHog integration","href":"/help/posthog-integration"},{"title":"CMS Integrations","href":"/help/cms-integrations"},{"title":"Slack Integration","href":"/help/slack-integration"},{"title":"Bring Your Own Key (BYOK)","href":"/help/byok"},{"title":"Sitemap Import","href":"/help/sitemap-import"},{"title":"Configuring AI Traffic","href":"/help/ai-traffic-setup"}]},{"group":"Account \u0026 Help","pages":[{"title":"Team Members","href":"/help/team-members"},{"title":"Billing \u0026 Plans","href":"/help/billing"},{"title":"Notifications \u0026 Email Digests","href":"/help/notifications"},{"title":"Tags","href":"/help/tags"},{"title":"Data Exports","href":"/help/exports"},{"title":"Troubleshooting data","href":"/help/troubleshooting-data"},{"title":"Publish and measure content","href":"/help/publish-and-measure-content"}]},{"group":"API","pages":[{"title":"Authenticate with the API","href":"/chat/api/authentication"},{"title":"Use the Chat API","href":"/chat/api/use-the-api"}]},{"group":"API reference","pages":[{"title":"Chat API reference","sidebarTitle":"Overview","href":"/chat/api-reference/overview"},{"group":"Endpoints","pages":[{"group":"Organizations","pages":[{"openapi":"chat/openapi.json GET /me","title":"Get current credential","href":"/chat/api-reference/endpoints/organizations/get-current-credential"},{"openapi":"chat/openapi.json GET /orgs","title":"List organizations","href":"/chat/api-reference/endpoints/organizations/list-organizations"},{"openapi":"chat/openapi.json GET /orgs/{org}","title":"Get organization","href":"/chat/api-reference/endpoints/organizations/get-organization"},{"openapi":"chat/openapi.json GET /orgs/{org}/categories","title":"List categories","href":"/chat/api-reference/endpoints/organizations/list-categories"},{"openapi":"chat/openapi.json GET /orgs/{org}/categories/{category}","title":"Get category","href":"/chat/api-reference/endpoints/organizations/get-category"}]},{"group":"Topics","pages":[{"openapi":"chat/openapi.json GET /orgs/{org}/categories/{category}/topics","title":"List topics","href":"/chat/api-reference/endpoints/topics/list-topics"},{"openapi":"chat/openapi.json POST /orgs/{org}/categories/{category}/topics","title":"Create topic","href":"/chat/api-reference/endpoints/topics/create-topic"},{"openapi":"chat/openapi.json GET /orgs/{org}/categories/{category}/topics/{topic_id}","title":"Get topic","href":"/chat/api-reference/endpoints/topics/get-topic"},{"openapi":"chat/openapi.json PATCH /orgs/{org}/categories/{category}/topics/{topic_id}","title":"Rename topic","href":"/chat/api-reference/endpoints/topics/rename-topic"}]},{"group":"Prompts","pages":[{"openapi":"chat/openapi.json GET /orgs/{org}/categories/{category}/prompts","title":"List prompts","description":null,"href":"/chat/api-reference/endpoints/prompts/list-prompts"},{"openapi":"chat/openapi.json POST /orgs/{org}/categories/{category}/prompts","title":"Create prompts","href":"/chat/api-reference/endpoints/prompts/create-prompts"},{"openapi":"chat/openapi.json PATCH /orgs/{org}/categories/{category}/prompts","title":"Bulk update prompts","description":"Move up to 500 prompts to a topic and/or set their tracking type. IDs\nnot in the category are reported in `notFound`.","href":"/chat/api-reference/endpoints/prompts/bulk-update-prompts"},{"openapi":"chat/openapi.json POST /orgs/{org}/categories/{category}/prompts/tags","title":"Add tags to prompts","href":"/chat/api-reference/endpoints/prompts/add-tags-to-prompts"},{"openapi":"chat/openapi.json DELETE /orgs/{org}/categories/{category}/prompts/tags","title":"Remove tags from prompts","href":"/chat/api-reference/endpoints/prompts/remove-tags-from-prompts"},{"openapi":"chat/openapi.json GET /orgs/{org}/categories/{category}/prompts/{prompt_id}","title":"Get prompt","href":"/chat/api-reference/endpoints/prompts/get-prompt"},{"openapi":"chat/openapi.json PATCH /orgs/{org}/categories/{category}/prompts/{prompt_id}","title":"Update prompt","href":"/chat/api-reference/endpoints/prompts/update-prompt"}]},{"group":"Tags","pages":[{"openapi":"chat/openapi.json GET /orgs/{org}/tags","title":"List tags","href":"/chat/api-reference/endpoints/tags/list-tags"},{"openapi":"chat/openapi.json POST /orgs/{org}/tags","title":"Create tag","href":"/chat/api-reference/endpoints/tags/create-tag"},{"openapi":"chat/openapi.json GET /orgs/{org}/tags/{tag_id}","title":"Get tag","href":"/chat/api-reference/endpoints/tags/get-tag"},{"openapi":"chat/openapi.json PATCH /orgs/{org}/tags/{tag_id}","title":"Update tag","href":"/chat/api-reference/endpoints/tags/update-tag"},{"openapi":"chat/openapi.json DELETE /orgs/{org}/tags/{tag_id}","title":"Delete tag","href":"/chat/api-reference/endpoints/tags/delete-tag"}]},{"group":"Brands","pages":[{"openapi":"chat/openapi.json GET /orgs/{org}/categories/{category}/brands","title":"List brands","href":"/chat/api-reference/endpoints/brands/list-brands"}]},{"group":"Query","pages":[{"openapi":"chat/openapi.json POST /orgs/{org}/query","title":"Run a report query","href":"/chat/api-reference/endpoints/query/run-a-report-query"},{"openapi":"chat/openapi.json GET /orgs/{org}/query/metadata","title":"Get the query catalog","href":"/chat/api-reference/endpoints/query/get-the-query-catalog"}]},{"group":"Answers","pages":[{"openapi":"chat/openapi.json GET /orgs/{org}/categories/{category}/answers","title":"List answers","href":"/chat/api-reference/endpoints/answers/list-answers"},{"openapi":"chat/openapi.json GET /orgs/{org}/categories/{category}/answers/{answer_id}","title":"Get answer","href":"/chat/api-reference/endpoints/answers/get-answer"},{"openapi":"chat/openapi.json GET /orgs/{org}/categories/{category}/citations","title":"List citations","href":"/chat/api-reference/endpoints/answers/list-citations"}]}]}]},{"group":"Resources","pages":[{"title":"Understanding your metrics","href":"/resources/measurement-reference"},{"title":"MCP tool list","href":"/resources/mcp-tools"},{"title":"AEO Glossary","href":"/resources/glossary"},{"title":"FAQ","href":"/resources/faq"},{"title":"Changelog","href":"/resources/changelog"}]}]},{"product":"Gauge Agents","icon":"code","description":"Coding Agent optimization","pages":[{"title":"Gauge Agents","href":"/agents"}]}]},"basePath":"","title":"Create prompts - Gauge Docs","buildId":"dpl_36EDyZCDfRuoUD9af5CH4M1bqY2h","deploymentId":"dpl_36EDyZCDfRuoUD9af5CH4M1bqY2h","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DCDCdBVX.js","utils-ME8dDnLe.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-0e84ACsd.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-wgRBj-ia.js","snippetPresets-C11Sgb-o.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-C0lapOpP.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-ZeRQV8fF.js","shallow-BupWh095.js","getApiPlaygroundDisplay-BnYQO2Ss.js","CodeSnippet-RKKOc8c_.js","CodeSnippets-Drf_m8wS.js","Page-Bevw23-4.js","getPastedJson-u6QiPzNZ.js","icon-Bb-CBSxO.js","MethodPill-F7l5AI7V.js","DuplicateIcon-IiAXkdSg.js","createIcon-FliI8EBc.js","DynamicMarkdown-B62XqCSI.js","SectionHeading-Dj31pT03.js","axios-vUo_bRtp.js","Markdown-BOgQCTwD.js","clsx-BIWXJmsZ.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-DKZWslLH.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-UDqbR6xh.js"]}