Edits the brief’s outline and planning fields. Omitted fields keep their current value; list fields replace the whole list. Only briefs in draft or failed can be edited, and the draft post’s plan is updated with them. Anything else returns 409. Editing drops research notes such as the baseline and recommended angle, as the dashboard editor does.
Send your API key in the Authorization header as Bearer API_KEY. Account API keys work in every workspace you belong to: send X-Notra-Organization-Id with the workspace id or slug to choose one. Workspace endpoints require it when you belong to more than one workspace; GET /v1/me/workspaces works without it. Organization keys only accept their own workspace there.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Notra Documentation","description":"Documentation for Notra: track your brand across AI answer engines and turn your team's work into content.","colors":{"primary":"#8b5cf6","light":"#8b5cf6","dark":"#8b5cf6"},"logo":{"light":"https://mintcdn.com/notra/2ET3yj_w1EiaVUnN/logo/notra-wordmark.svg?fit=max\u0026auto=format\u0026n=2ET3yj_w1EiaVUnN\u0026q=85\u0026s=ec067541de0d7eb5eb2bddf6eed3e9b4","dark":"https://mintcdn.com/notra/2ET3yj_w1EiaVUnN/logo/notra-wordmark-dark.svg?fit=max\u0026auto=format\u0026n=2ET3yj_w1EiaVUnN\u0026q=85\u0026s=acc35d633060260aca265100d13e09a1"},"favicon":"https://mintcdn.com/notra/KRbWPF6cEiTVNBm6/favicon.svg?fit=max\u0026auto=format\u0026n=KRbWPF6cEiTVNBm6\u0026q=85\u0026s=ff71fb69837d03de53146d96aad9402a","api":{"url":"full"},"appearance":{"default":"light"},"navbar":{"links":[{"href":"https://www.usenotra.com/discord","label":"Discord"},{"href":"https://github.com/usenotra","type":"github"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.usenotra.com"}},"footer":{"socials":{"x":"https://x.com/usenotra","github":"https://github.com/usenotra","discord":"https://www.usenotra.com/discord"}},"search":{"prompt":"Search the Notra docs..."},"seo":{"metatags":{"twitter:site":"@usenotra"}},"styling":{"eyebrows":"breadcrumbs","codeblocks":"system","latex":true},"errors":{"404":{"redirect":false,"title":"This page is on a content pipeline of its own","description":"Looks like this page hasn't shipped yet. Try the [quickstart](/quickstart) or the [product map](/geo/product-map)."}},"contextual":{"options":["copy","view","assistant","mcp","chatgpt","claude","cursor"],"display":"header"},"thumbnails":{"preset":"headline"},"metadata":{"timestamp":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"notra","hasAudioNarration":false,"actualSubdomain":"notra","customDomains":["www.usenotra.com"],"gitSource":{"type":"github","owner":"usenotra","repo":"notra","deployBranch":"main","contentDirectory":"apps/docs","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true,"edits":false,"agentFeedback":true,"issues":false},"entitlements":{},"buildId":"6af55ae354881783984abc26","clientVersion":"0.0.4111","searchFilterCounts":[{"language":"default","tag":"Developers","count":175},{"language":"default","tag":"Endpoints","count":158},{"language":"default","tag":"GEO","count":105},{"language":"default","tag":"Sites","count":67},{"language":"default","tag":"Analytics","count":32},{"language":"default","tag":"Integrations","count":23},{"language":"default","tag":"Posts","count":16},{"language":"default","tag":"AI Traffic","count":15},{"language":"default","tag":"Studio","count":15},{"language":"default","tag":"Domains","count":12}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"/docs","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"buttons.css","content":".notra-button,#topbar-cta-button>a{--notra-button-shadow: 0 0 transparent;display:inline-flex;align-items:center;justify-content:center;gap:0.375rem;height:2rem;padding:0 0.625rem;border:1px solid transparent;border-radius:0.5rem;font-size:0.875rem;font-weight:500;line-height:1;text-decoration:none;white-space:nowrap;cursor:pointer;box-shadow:var(--notra-button-shadow);transition:background-color 150ms ease-out,\n filter 150ms ease-out,\n transform 150ms ease-out}.notra-button-primary,#topbar-cta-button>a{color:oklch(0.997 0 0);border-color:oklch(0.6056 0.2189 292.7172 / 60%);background:linear-gradient(\n 180deg,\n oklch(0.6056 0.2189 292.7172 / 85%),\n oklch(0.6056 0.2189 292.7172)\n );--notra-button-shadow:\n inset 0 1px 0 rgb(255 255 255 / 28%), 0 1px 2px rgb(0 0 0 / 18%)}.notra-button-primary:hover,#topbar-cta-button>a:hover{filter:brightness(1.1)}.notra-button-outline{color:hsl(0 0% 9%);border-color:hsl(0 0% 89.8%);background:hsl(0 0% 100%);--notra-button-shadow: 0 1px 2px rgb(0 0 0 / 5%)}.notra-button-outline:hover{background:hsl(0 0% 96.1%)}.dark .notra-button-outline{color:hsl(0 0% 98%);border-color:hsl(240 4% 20%);background:hsl(240 4% 20% / 30%);--notra-button-shadow: 0 0 transparent}.dark .notra-button-outline:hover{background:hsl(240 4% 20% / 50%)}@supports (corner-shape: squircle){.notra-button,#topbar-cta-button>a{corner-shape:squircle;border-radius:0.75rem}}#topbar-cta-button>a>span{background:transparent}.notra-button:focus-visible,#topbar-cta-button>a:focus-visible{outline:none;border-color:oklch(0.6056 0.2189 292.7172);box-shadow:0 0 0 3px oklch(0.6056 0.2189 292.7172 / 50%),\n var(--notra-button-shadow)}.notra-button:active:not(:disabled),#topbar-cta-button>a:active{transform:scale(0.97)}.notra-button:disabled{cursor:not-allowed;opacity:0.5}@media (prefers-reduced-motion: reduce){.notra-button,#topbar-cta-button>a{transition:none}.notra-button:active:not(:disabled),#topbar-cta-button>a:active{transform:none}}"},{"filePath":"card-icons.css","content":"html.dark [data-component-part=\"card-icon\"] img[src*=\"/images/integrations/posthog.svg\"]{content:url(\"/images/integrations/posthog-dark.svg\")}"},{"filePath":"theme.css","content":"[role=\"menu\"]:has([data-component-part=\"theme-preference-menu-item\"]){opacity:0;pointer-events:none}"}],"page":{"pagePath":"api-reference/geo/update-a-content-brief","slug":"/api-reference/geo/update-a-content-brief","pageMetadata":{"title":"Update a content brief","description":"Edits the brief's outline and planning fields. Omitted fields keep their current value; list fields replace the whole list. Only briefs in `draft` or `failed` can be edited, and the draft post's plan is updated with them. Anything else returns 409. Editing drops research notes such as the baseline and recommended angle, as the dashboard editor does.","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json patch /v1/projects/{projectId}/geo/briefs/{briefId}","href":"/api-reference/geo/update-a-content-brief","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Edits the brief’s outline and planning fields. Omitted fields keep their current value; list fields replace the whole list. Only briefs in \", _jsx(_components.code, {\n children: \"draft\"\n }), \" or \", _jsx(_components.code, {\n children: \"failed\"\n }), \" can be edited, and the draft post’s plan is updated with them. Anything else returns 409. Editing drops research notes such as the baseline and recommended angle, as the dashboard editor does.\"]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"codeStyling":"system","config":{},"pageMetadata":{"title":"Update a content brief","description":"Edits the brief's outline and planning fields. Omitted fields keep their current value; list fields replace the whole list. Only briefs in `draft` or `failed` can be edited, and the draft post's plan is updated with them. Anything else returns 409. Editing drops research notes such as the baseline and recommended angle, as the dashboard editor does.","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json patch /v1/projects/{projectId}/geo/briefs/{briefId}","href":"/api-reference/geo/update-a-content-brief","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/docs/_mintlify/custom/notra/1c34b1755a71d50d/databuddy.js","/docs/_mintlify/custom/notra/5641b035830c1390/theme-toggle.js"],"openApiReferenceData":{"operation":{"tags":["GEO"],"operationId":"updateGeoContentBrief","summary":"Update a content brief","description":"Edits the brief's outline and planning fields. Omitted fields keep their current value; list fields replace the whole list. Only briefs in `draft` or `failed` can be edited, and the draft post's plan is updated with them. Anything else returns 409. Editing drops research notes such as the baseline and recommended angle, as the dashboard editor does.","parameters":["998c1a42-2c66-4efe-be6b-622658d2eb0f","6c04b73a-d4d1-4cab-8109-a38771da65a0"],"requestBody":"0057e6e8-d1c2-4a56-89e2-734553ee1b52","responses":{"200":"bde0c248-f0ff-4793-8ad9-12ebba714d2a","400":"0f046700-5e68-4354-9e0f-dad65a7c6fba","401":"7baa09fd-9b92-4c2c-8f00-33ea90d35655","402":"dacd2e55-80bf-4e49-8668-65e52af6088a","403":"9b477d00-f5d1-435a-8eb3-d841c4e05309","404":"da92217e-365e-4721-a2bf-b187bab7bd19","409":"46156276-33ea-44b5-bfe4-688be92e6c84","500":"04a617d3-3cc6-4d1f-bd78-9ec6e08a5945","503":"2b7ad7d1-58f7-4cac-8114-baeaf1f66c70"},"method":"patch","type":"path","servers":["fb211914-76df-45d3-8099-6ef9da0eba67","511afd44-535b-487f-962b-6c37c6ecebb8"],"security":["51c2dcd1-b8c1-403f-90bc-1b4111aebea6"],"path":"/v1/projects/{projectId}/geo/briefs/{briefId}","baseUrlOptions":["https://api.usenotra.com","https://demo-api.usenotra.com"],"title":"Update a content brief","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated","urlDisplay":"full"},"dependencies":{"parameters":{"998c1a42-2c66-4efe-be6b-622658d2eb0f":{"schema":{"type":"string","minLength":1,"pattern":"^[A-Za-z0-9_-]{1,100}$","example":"b1f2c3d4-0000-4000-8000-000000000000","isRequired":true,"uniqueKey":"","typeLabel":"string"},"required":true,"name":"projectId","in":"path"},"6c04b73a-d4d1-4cab-8109-a38771da65a0":{"schema":{"type":"string","minLength":1,"pattern":"^[A-Za-z0-9_-]{1,100}$","isRequired":true,"uniqueKey":"","typeLabel":"string"},"required":true,"name":"briefId","in":"path"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"expectedUpdatedAt":{"type":"string","format":"date-time","description":"The brief's updatedAt from your last read. When set, the update fails with 409 if the brief changed since. Omit to overwrite the latest version.","uniqueKey":"expectedUpdatedAt","typeLabel":"string\u003cdate-time>"},"workingTitle":{"type":"string","minLength":1,"maxLength":120,"pattern":"^[^\\r\\n]*$","uniqueKey":"workingTitle","typeLabel":"string"},"targetPrompt":{"type":"string","minLength":1,"pattern":"^[^\\r\\n]*$","uniqueKey":"targetPrompt","typeLabel":"string"},"intent":{"type":"string","minLength":1,"pattern":"^[^\\r\\n]*$","uniqueKey":"intent","typeLabel":"string"},"audience":{"type":"string","minLength":1,"pattern":"^[^\\r\\n]*$","uniqueKey":"audience","typeLabel":"string"},"jobToBeDone":{"type":"string","minLength":1,"pattern":"^[^\\r\\n]*$","uniqueKey":"jobToBeDone","typeLabel":"string"},"sections":{"type":"array","items":{"type":"object","properties":{"heading":{"type":"string","minLength":1,"pattern":"^[^\\r\\n]*$","isRequired":true,"uniqueKey":"sections.items.[INDEX].heading","typeLabel":"string"},"goal":{"type":"string","minLength":1,"pattern":"^[^\\r\\n]*$","isRequired":true,"uniqueKey":"sections.items.[INDEX].goal","typeLabel":"string"},"claims":{"type":"array","items":{"type":"string","minLength":1,"pattern":"^[^\\r\\n]*$","uniqueKey":"sections.items.[INDEX].claims.items.[INDEX]","typeLabel":"string"},"maxItems":5,"isRequired":true,"uniqueKey":"sections.items.[INDEX].claims","typeLabel":"string[]"}},"required":["heading","goal","claims"],"uniqueKey":"sections.items.[INDEX]","typeLabel":"object"},"minItems":3,"maxItems":8,"description":"The outline. Replaces every section; send the full list in order.","uniqueKey":"sections","typeLabel":"object[]"},"questionsToAnswer":{"type":"array","items":{"type":"string","minLength":1,"pattern":"^[^\\r\\n]*$","uniqueKey":"questionsToAnswer.items.[INDEX]","typeLabel":"string"},"maxItems":8,"description":"FAQ questions. Replaces the whole list.","uniqueKey":"questionsToAnswer","typeLabel":"string[]"},"internalLinks":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","minLength":1,"pattern":"^[^\\r\\n]*$","isRequired":true,"uniqueKey":"internalLinks.items.[INDEX].url","typeLabel":"string"},"anchor":{"type":"string","minLength":1,"pattern":"^[^\\r\\n]*$","isRequired":true,"uniqueKey":"internalLinks.items.[INDEX].anchor","typeLabel":"string"},"why":{"type":"string","minLength":1,"pattern":"^[^\\r\\n]*$","isRequired":true,"uniqueKey":"internalLinks.items.[INDEX].why","typeLabel":"string"}},"required":["url","anchor","why"],"uniqueKey":"internalLinks.items.[INDEX]","typeLabel":"object"},"maxItems":6,"description":"Replaces the whole list.","uniqueKey":"internalLinks","typeLabel":"object[]"},"acceptanceChecklist":{"type":"array","items":{"type":"string","minLength":1,"pattern":"^[^\\r\\n]*$","uniqueKey":"acceptanceChecklist.items.[INDEX]","typeLabel":"string"},"maxItems":8,"description":"Replaces the whole list.","uniqueKey":"acceptanceChecklist","typeLabel":"string[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"expectedUpdatedAt":"2023-11-07T05:31:56Z","workingTitle":"\u003cstring>","targetPrompt":"\u003cstring>","intent":"\u003cstring>","audience":"\u003cstring>","jobToBeDone":"\u003cstring>","sections":[{"heading":"\u003cstring>","goal":"\u003cstring>","claims":["\u003cstring>"]}],"questionsToAnswer":["\u003cstring>"],"internalLinks":[{"url":"\u003cstring>","anchor":"\u003cstring>","why":"\u003cstring>"}],"acceptanceChecklist":["\u003cstring>"]}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"bde0c248-f0ff-4793-8ad9-12ebba714d2a":{"description":"Brief updated successfully","content":{"application/json":{"schema":{"type":"object","properties":{"brief":{"type":"object","properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"brief.id","typeLabel":"string"},"topic":{"type":"string","isRequired":true,"uniqueKey":"brief.topic","typeLabel":"string"},"brief":{"type":"object","properties":{"targetPrompt":{"type":"string","isRequired":true,"uniqueKey":"brief.brief.targetPrompt","typeLabel":"string"},"intent":{"type":"string","isRequired":true,"uniqueKey":"brief.brief.intent","typeLabel":"string"},"contentSubtype":{"type":"string","enum":["guide","comparison","listicle","how-to","faq","alternatives"],"isRequired":true,"uniqueKey":"brief.brief.contentSubtype","typeLabel":"enum\u003cstring>"},"workingTitle":{"type":"string","isRequired":true,"uniqueKey":"brief.brief.workingTitle","typeLabel":"string"},"audience":{"type":"string","isRequired":true,"uniqueKey":"brief.brief.audience","typeLabel":"string"},"jobToBeDone":{"type":"string","isRequired":true,"uniqueKey":"brief.brief.jobToBeDone","typeLabel":"string"},"sections":{"type":"array","items":{"type":"object","properties":{"heading":{"type":"string","isRequired":true,"uniqueKey":"brief.brief.sections.items.[INDEX].heading","typeLabel":"string"},"goal":{"type":"string","isRequired":true,"uniqueKey":"brief.brief.sections.items.[INDEX].goal","typeLabel":"string"},"claims":{"type":"array","items":{"type":"string","uniqueKey":"brief.brief.sections.items.[INDEX].claims.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"brief.brief.sections.items.[INDEX].claims","typeLabel":"string[]"}},"required":["heading","goal","claims"],"uniqueKey":"brief.brief.sections.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"brief.brief.sections","typeLabel":"object[]"},"questionsToAnswer":{"type":"array","items":{"type":"string","uniqueKey":"brief.brief.questionsToAnswer.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"brief.brief.questionsToAnswer","typeLabel":"string[]"},"internalLinks":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","isRequired":true,"uniqueKey":"brief.brief.internalLinks.items.[INDEX].url","typeLabel":"string"},"anchor":{"type":"string","isRequired":true,"uniqueKey":"brief.brief.internalLinks.items.[INDEX].anchor","typeLabel":"string"},"why":{"type":"string","isRequired":true,"uniqueKey":"brief.brief.internalLinks.items.[INDEX].why","typeLabel":"string"}},"required":["url","anchor","why"],"uniqueKey":"brief.brief.internalLinks.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"brief.brief.internalLinks","typeLabel":"object[]"},"acceptanceChecklist":{"type":"array","items":{"type":"string","uniqueKey":"brief.brief.acceptanceChecklist.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"brief.brief.acceptanceChecklist","typeLabel":"string[]"},"recommendedAngle":{"type":"string","uniqueKey":"brief.brief.recommendedAngle","typeLabel":"string"},"competitorsToCounter":{"type":"array","items":{"type":"string","uniqueKey":"brief.brief.competitorsToCounter.items.[INDEX]","typeLabel":"string"},"uniqueKey":"brief.brief.competitorsToCounter","typeLabel":"string[]"},"sourcesToReference":{"type":"array","items":{"type":"string","uniqueKey":"brief.brief.sourcesToReference.items.[INDEX]","typeLabel":"string"},"uniqueKey":"brief.brief.sourcesToReference","typeLabel":"string[]"},"missingCoverage":{"type":"array","items":{"type":"string","uniqueKey":"brief.brief.missingCoverage.items.[INDEX]","typeLabel":"string"},"uniqueKey":"brief.brief.missingCoverage","typeLabel":"string[]"},"baseline":{"oneOf":[{"type":"object","properties":{"sourcePromptId":{"type":"string","isRequired":true,"uniqueKey":"brief.brief.baseline.oneOf.0.sourcePromptId","typeLabel":"string"},"mentionedEngines":{"type":"number","isRequired":true,"uniqueKey":"brief.brief.baseline.oneOf.0.mentionedEngines","typeLabel":"number"},"totalEngines":{"type":"number","isRequired":true,"uniqueKey":"brief.brief.baseline.oneOf.0.totalEngines","typeLabel":"number"},"engines":{"type":"array","items":{"type":"object","properties":{"engine":{"type":"string","isRequired":true,"uniqueKey":"brief.brief.baseline.oneOf.0.engines.items.[INDEX].engine","typeLabel":"string"},"mentioned":{"type":"boolean","isRequired":true,"uniqueKey":"brief.brief.baseline.oneOf.0.engines.items.[INDEX].mentioned","typeLabel":"boolean"},"position":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"brief.brief.baseline.oneOf.0.engines.items.[INDEX].position.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"brief.brief.baseline.oneOf.0.engines.items.[INDEX].position.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"brief.brief.baseline.oneOf.0.engines.items.[INDEX].position","typeLabel":"number | null"}},"required":["engine","mentioned","position"],"uniqueKey":"brief.brief.baseline.oneOf.0.engines.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"brief.brief.baseline.oneOf.0.engines","typeLabel":"object[]"},"competitorMentions":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","isRequired":true,"uniqueKey":"brief.brief.baseline.oneOf.0.competitorMentions.items.[INDEX].name","typeLabel":"string"},"engines":{"type":"number","isRequired":true,"uniqueKey":"brief.brief.baseline.oneOf.0.competitorMentions.items.[INDEX].engines","typeLabel":"number"}},"required":["name","engines"],"uniqueKey":"brief.brief.baseline.oneOf.0.competitorMentions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"brief.brief.baseline.oneOf.0.competitorMentions","typeLabel":"object[]"},"citedDomains":{"type":"array","items":{"type":"object","properties":{"domain":{"type":"string","isRequired":true,"uniqueKey":"brief.brief.baseline.oneOf.0.citedDomains.items.[INDEX].domain","typeLabel":"string"},"engines":{"type":"number","isRequired":true,"uniqueKey":"brief.brief.baseline.oneOf.0.citedDomains.items.[INDEX].engines","typeLabel":"number"}},"required":["domain","engines"],"uniqueKey":"brief.brief.baseline.oneOf.0.citedDomains.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"brief.brief.baseline.oneOf.0.citedDomains","typeLabel":"object[]"},"capturedAt":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"brief.brief.baseline.oneOf.0.capturedAt.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"brief.brief.baseline.oneOf.0.capturedAt.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"brief.brief.baseline.oneOf.0.capturedAt","typeLabel":"string | null"}},"required":["sourcePromptId","mentionedEngines","totalEngines","engines","competitorMentions","citedDomains","capturedAt"],"uniqueKey":"brief.brief.baseline.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"sourcePromptId":{"type":"string"},"mentionedEngines":{"type":"number"},"totalEngines":{"type":"number"},"engines":{"type":"array","items":{"type":"object","properties":{"engine":{"type":"string"},"mentioned":{"type":"boolean"},"position":{"oneOf":[{"type":"number"},{"type":"null"}]}},"required":["engine","mentioned","position"]}},"competitorMentions":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"engines":{"type":"number"}},"required":["name","engines"]}},"citedDomains":{"type":"array","items":{"type":"object","properties":{"domain":{"type":"string"},"engines":{"type":"number"}},"required":["domain","engines"]}},"capturedAt":{"oneOf":[{"type":"string"},{"type":"null"}]}},"required":["sourcePromptId","mentionedEngines","totalEngines","engines","competitorMentions","citedDomains","capturedAt"],"uniqueKey":"brief.brief.baseline.oneOf.1","typeLabel":"null"}],"uniqueKey":"brief.brief.baseline","typeLabel":"object | null"}},"required":["targetPrompt","intent","contentSubtype","workingTitle","audience","jobToBeDone","sections","questionsToAnswer","internalLinks","acceptanceChecklist"],"isRequired":true,"uniqueKey":"brief.brief","typeLabel":"object"},"status":{"type":"string","enum":["draft","approved","writing","completed","failed"],"isRequired":true,"uniqueKey":"brief.status","typeLabel":"enum\u003cstring>"},"autoApproved":{"type":"boolean","isRequired":true,"uniqueKey":"brief.autoApproved","typeLabel":"boolean"},"runId":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"brief.runId.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"brief.runId.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"brief.runId","typeLabel":"string | null"},"postId":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"brief.postId.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"brief.postId.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"brief.postId","typeLabel":"string | null"},"humanized":{"type":"boolean","isRequired":true,"uniqueKey":"brief.humanized","typeLabel":"boolean"},"error":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"brief.error.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"brief.error.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"brief.error","typeLabel":"string | null"},"createdAt":{"type":"string","isRequired":true,"uniqueKey":"brief.createdAt","typeLabel":"string"},"updatedAt":{"type":"string","isRequired":true,"uniqueKey":"brief.updatedAt","typeLabel":"string"},"completedAt":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"brief.completedAt.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"brief.completedAt.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"brief.completedAt","typeLabel":"string | null"}},"required":["id","topic","brief","status","autoApproved","runId","postId","humanized","error","createdAt","updatedAt","completedAt"],"isRequired":true,"uniqueKey":"brief","typeLabel":"object"},"organization":{"type":"object","properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"organization.id","typeLabel":"string"},"slug":{"type":"string","isRequired":true,"uniqueKey":"organization.slug","typeLabel":"string"},"name":{"type":"string","isRequired":true,"uniqueKey":"organization.name","typeLabel":"string"},"logo":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"organization.logo.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"organization.logo.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"organization.logo","typeLabel":"string | null"}},"required":["id","slug","name","logo"],"isRequired":true,"uniqueKey":"organization","typeLabel":"object"}},"required":["brief","organization"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"brief":{"id":"\u003cstring>","topic":"\u003cstring>","brief":{"targetPrompt":"\u003cstring>","intent":"\u003cstring>","contentSubtype":"guide","workingTitle":"\u003cstring>","audience":"\u003cstring>","jobToBeDone":"\u003cstring>","sections":[{"heading":"\u003cstring>","goal":"\u003cstring>","claims":["\u003cstring>"]}],"questionsToAnswer":["\u003cstring>"],"internalLinks":[{"url":"\u003cstring>","anchor":"\u003cstring>","why":"\u003cstring>"}],"acceptanceChecklist":["\u003cstring>"],"recommendedAngle":"\u003cstring>","competitorsToCounter":["\u003cstring>"],"sourcesToReference":["\u003cstring>"],"missingCoverage":["\u003cstring>"],"baseline":{"sourcePromptId":"\u003cstring>","mentionedEngines":123,"totalEngines":123,"engines":[{"engine":"\u003cstring>","mentioned":true,"position":123}],"competitorMentions":[{"name":"\u003cstring>","engines":123}],"citedDomains":[{"domain":"\u003cstring>","engines":123}],"capturedAt":"\u003cstring>"}},"status":"draft","autoApproved":true,"runId":"\u003cstring>","postId":"\u003cstring>","humanized":true,"error":"\u003cstring>","createdAt":"\u003cstring>","updatedAt":"\u003cstring>","completedAt":"\u003cstring>"},"organization":{"id":"\u003cstring>","slug":"\u003cstring>","name":"\u003cstring>","logo":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"0f046700-5e68-4354-9e0f-dad65a7c6fba":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","uniqueKey":"code","typeLabel":"string"},"recovery":{"type":"string","uniqueKey":"recovery","typeLabel":"string"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","code":"\u003cstring>","recovery":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"7baa09fd-9b92-4c2c-8f00-33ea90d35655":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","uniqueKey":"code","typeLabel":"string"},"recovery":{"type":"string","uniqueKey":"recovery","typeLabel":"string"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","code":"\u003cstring>","recovery":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"dacd2e55-80bf-4e49-8668-65e52af6088a":{"description":"GEO plan or available AI credits required","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","uniqueKey":"code","typeLabel":"string"},"recovery":{"type":"string","uniqueKey":"recovery","typeLabel":"string"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","code":"\u003cstring>","recovery":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"9b477d00-f5d1-435a-8eb3-d841c4e05309":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","uniqueKey":"code","typeLabel":"string"},"recovery":{"type":"string","uniqueKey":"recovery","typeLabel":"string"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","code":"\u003cstring>","recovery":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"da92217e-365e-4721-a2bf-b187bab7bd19":{"description":"Organization, project or resource not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","uniqueKey":"code","typeLabel":"string"},"recovery":{"type":"string","uniqueKey":"recovery","typeLabel":"string"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","code":"\u003cstring>","recovery":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"46156276-33ea-44b5-bfe4-688be92e6c84":{"description":"Conflict","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","uniqueKey":"code","typeLabel":"string"},"recovery":{"type":"string","uniqueKey":"recovery","typeLabel":"string"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","code":"\u003cstring>","recovery":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"04a617d3-3cc6-4d1f-bd78-9ec6e08a5945":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","uniqueKey":"code","typeLabel":"string"},"recovery":{"type":"string","uniqueKey":"recovery","typeLabel":"string"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","code":"\u003cstring>","recovery":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"2b7ad7d1-58f7-4cac-8114-baeaf1f66c70":{"description":"Authentication or billing service unavailable","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","uniqueKey":"code","typeLabel":"string"},"recovery":{"type":"string","uniqueKey":"recovery","typeLabel":"string"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","code":"\u003cstring>","recovery":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"51c2dcd1-b8c1-403f-90bc-1b4111aebea6":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"Send your API key in the Authorization header as Bearer API_KEY. Account API keys work in every workspace you belong to: send X-Notra-Organization-Id with the workspace id or slug to choose one. Workspace endpoints require it when you belong to more than one workspace; GET /v1/me/workspaces works without it. Organization keys only accept their own workspace there.","scopes":[],"schemeName":"BearerAuth"}}},"servers":{"fb211914-76df-45d3-8099-6ef9da0eba67":{"url":"https://api.usenotra.com","description":"Production"},"511afd44-535b-487f-962b-6c37c6ecebb8":{"url":"https://demo-api.usenotra.com","description":"Sandbox with sample data. Get a free sandbox key at demo.usenotra.com, no signup needed"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"Send your API key in the Authorization header as Bearer API_KEY. Account API keys work in every workspace you belong to: send X-Notra-Organization-Id with the workspace id or slug to choose one. Workspace endpoints require it when you belong to more than one workspace; GET /v1/me/workspaces works without it. Organization keys only accept their own workspace there.","scopes":[],"schemeName":"BearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Send your API key in the Authorization header as Bearer API_KEY. Account API keys work in every workspace you belong to: send X-Notra-Organization-Id with the workspace id or slug to choose one. Workspace endpoints require it when you belong to more than one workspace; GET /v1/me/workspaces works without it. Organization keys only accept their own workspace there.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"BearerAuth","name":"Authorization"}],"title":"BearerAuth"}]},"originalFileLocation":"https://api.usenotra.com/openapi.json"},"subdomain":"notra","siteName":"Notra Documentation","title":"Update a content brief - Notra Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"originalFileLocation":"api-reference/geo/update-a-content-brief.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"light\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Edits the brief\u0026#x27;s outline and planning fields. Omitted fields keep their current value; list fields replace the whole list. Only briefs in draft or failed can be edited, and the draft post\u0026#x27;s plan is updated with them. Anything else returns 409. Editing drops research notes such as the baseline and recommended angle, as the dashboard editor does.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Notra Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/notra/sxLIY7EtkqgtHg_V/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/docs/mintlify-assets/_mintlify/favicons/notra/sxLIY7EtkqgtHg_V/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/notra/sxLIY7EtkqgtHg_V/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/notra/sxLIY7EtkqgtHg_V/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/notra/sxLIY7EtkqgtHg_V/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/notra/sxLIY7EtkqgtHg_V/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/notra/sxLIY7EtkqgtHg_V/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/notra/sxLIY7EtkqgtHg_V/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/notra/sxLIY7EtkqgtHg_V/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Update a content brief - Notra Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Edits the brief\u0026#x27;s outline and planning fields. Omitted fields keep their current value; list fields replace the whole list. Only briefs in draft or failed can be edited, and the draft post\u0026#x27;s plan is updated with them. Anything else returns 409. Editing drops research notes such as the baseline and recommended angle, as the dashboard editor does.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Notra Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://www.usenotra.com/docs/api-reference/geo/update-a-content-brief\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://notra.mintlify.site/docs/_mintlify/api/og/v2?division=Content+Gaps+and+Briefs\u0026amp;title=Update+a+content+brief\u0026amp;description=Edits+the+brief%27s+outline+and+planning+fields.+Omitted+fields+keep+their+current+value%3B+list+fields+replace+the+whole+list.+Only+briefs+in+%60draft%60+or+%60failed%60+c\u0026amp;theme=ee1615b07fb0909d0eced992\u0026amp;signature=13b085799a355135b2696aae008859dadcec498655d1f8cdf8b73fe9da41a143\">\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=\"Update a content brief - Notra Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Edits the brief\u0026#x27;s outline and planning fields. Omitted fields keep their current value; list fields replace the whole list. Only briefs in draft or failed can be edited, and the draft post\u0026#x27;s plan is updated with them. Anything else returns 409. Editing drops research notes such as the baseline and recommended angle, as the dashboard editor does.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://notra.mintlify.site/docs/_mintlify/api/og/v2?division=Content+Gaps+and+Briefs\u0026amp;title=Update+a+content+brief\u0026amp;description=Edits+the+brief%27s+outline+and+planning+fields.+Omitted+fields+keep+their+current+value%3B+list+fields+replace+the+whole+list.+Only+briefs+in+%60draft%60+or+%60failed%60+c\u0026amp;theme=ee1615b07fb0909d0eced992\u0026amp;signature=13b085799a355135b2696aae008859dadcec498655d1f8cdf8b73fe9da41a143\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/docs/mintlify-assets/_mintlify/favicons/notra/sxLIY7EtkqgtHg_V/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Notra Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#8b5cf6\">\u003clink data-mint-head rel=\"canonical\" href=\"https://www.usenotra.com/docs/api-reference/geo/update-a-content-brief\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/api-reference/geo/update-a-content-brief.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://www.usenotra.com/#organization\",\"name\":\"Notra Documentation\",\"url\":\"https://www.usenotra.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/notra/2ET3yj_w1EiaVUnN/logo/notra-wordmark.svg?fit=max\u0026auto=format\u0026n=2ET3yj_w1EiaVUnN\u0026q=85\u0026s=ec067541de0d7eb5eb2bddf6eed3e9b4\"}},{\"@type\":\"WebSite\",\"@id\":\"https://www.usenotra.com/docs#website\",\"name\":\"Notra Documentation\",\"url\":\"https://www.usenotra.com/docs\",\"publisher\":{\"@id\":\"https://www.usenotra.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://www.usenotra.com/docs/api-reference/geo/update-a-content-brief#webpage\",\"url\":\"https://www.usenotra.com/docs/api-reference/geo/update-a-content-brief\",\"name\":\"Update a content brief\",\"description\":\"Edits the brief's outline and planning fields. Omitted fields keep their current value; list fields replace the whole list. Only briefs in draft or failed can be edited, and the draft post's plan is updated with them. Anything else returns 409. Editing drops research notes such as the baseline and recommended angle, as the dashboard editor does.\",\"isPartOf\":{\"@id\":\"https://www.usenotra.com/docs#website\"},\"breadcrumb\":{\"@id\":\"https://www.usenotra.com/docs/api-reference/geo/update-a-content-brief#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://www.usenotra.com/docs/api-reference/geo/update-a-content-brief#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Endpoints\",\"item\":\"https://www.usenotra.com/docs/api-reference/discovery/check-public-api-reachability\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"GEO\",\"item\":\"https://www.usenotra.com/docs/api-reference/geo/list-geo-projects\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Content Gaps and Briefs\",\"item\":\"https://www.usenotra.com/docs/api-reference/geo/list-content-gaps\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"Update a content brief\",\"item\":\"https://www.usenotra.com/docs/api-reference/geo/update-a-content-brief\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://www.usenotra.com/docs/api-reference/geo/update-a-content-brief#apireference\",\"headline\":\"Update a content brief\",\"name\":\"Update a content brief\",\"description\":\"Edits the brief's outline and planning fields. Omitted fields keep their current value; list fields replace the whole list. Only briefs in draft or failed can be edited, and the draft post's plan is updated with them. Anything else returns 409. Editing drops research notes such as the baseline and recommended angle, as the dashboard editor does.\",\"url\":\"https://www.usenotra.com/docs/api-reference/geo/update-a-content-brief\",\"mainEntityOfPage\":{\"@id\":\"https://www.usenotra.com/docs/api-reference/geo/update-a-content-brief#webpage\"},\"publisher\":{\"@id\":\"https://www.usenotra.com/#organization\"},\"isPartOf\":{\"@id\":\"https://www.usenotra.com/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Notra Documentation\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Notra Documentation\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/api-reference/geo/update-a-content-brief.md","siteName":"Notra Documentation","nav":{"global":null,"tabs":[{"tab":"GEO","icon":"chart-line","pages":[{"title":"GEO","href":"/quickstart"}]},{"tab":"Sites","icon":"globe","pages":[{"title":"Sites","href":"/sites/overview"}]},{"tab":"Analytics","icon":"robot","pages":[{"title":"Analytics","href":"/analytics/overview"}]},{"tab":"Playbooks","icon":"book-open","pages":[{"title":"Playbooks","href":"/playbooks/first-30-days"}]},{"tab":"Studio","icon":"pen-nib","pages":[{"title":"Studio","href":"/concepts/content-pipeline"}]},{"tab":"Developers","icon":"code","groups":[{"group":"Getting Started","icon":"rocket","pages":[{"title":"Getting started","href":"/api/getting-started"},{"title":"Authentication","href":"/api/authentication"},{"title":"Rate limits","href":"/api/rate-limits"},{"title":"Versioning and deprecation","href":"/api/versioning"}]},{"group":"Developer Tools","icon":"terminal","pages":[{"title":"CLI","href":"/devtools/cli"},{"title":"MCP server","href":"/devtools/mcp"},{"title":"Claude Connector","href":"/devtools/claude"},{"title":"ChatGPT Plugin","href":"/devtools/chatgpt"},{"title":"Composio Toolkit","href":"/devtools/composio"},{"title":"Raycast Extension","href":"/devtools/raycast"}]},{"group":"Guides","icon":"book-open","pages":[{"title":"Caching","href":"/api/caching"},{"title":"Common tasks","href":"/api/common-tasks"},{"title":"Pagination","href":"/api/pagination"},{"title":"TypeScript types","href":"/api/types"}]},{"group":"Webhooks","icon":"webhook","pages":[{"title":"Webhooks overview","href":"/api/webhooks/overview"},{"title":"Webhook events","href":"/api/webhooks/events"},{"title":"Outbound webhooks","href":"/api/webhooks/outbound"}]},{"group":"Endpoints","icon":"server","expanded":true,"pages":[{"group":"Discovery","expanded":true,"pages":[{"title":"Check public API reachability","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/status","href":"/api-reference/discovery/check-public-api-reachability"},{"title":"Get authenticated workspace context","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/me/workspaces","href":"/api-reference/discovery/get-authenticated-workspace-context"}]},{"group":"Posts","expanded":true,"pages":[{"title":"List posts","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/posts","href":"/api-reference/content/list-posts"},{"title":"Create a post","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json post /v1/posts","href":"/api-reference/content/create-a-post"},{"title":"Get a single post","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/posts/{postId}","href":"/api-reference/content/get-a-single-post"},{"title":"Update a single post","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json patch /v1/posts/{postId}","href":"/api-reference/content/update-a-single-post"},{"title":"Delete a single post","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json delete /v1/posts/{postId}","href":"/api-reference/content/delete-a-single-post"},{"title":"Get a post's agent reach","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/posts/{postId}/agent-reach","href":"/api-reference/content/get-a-posts-agent-reach"},{"title":"Open a draft pull request for a post","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json post /v1/posts/{postId}/pull-request","href":"/api-reference/content/open-a-draft-pull-request-for-a-post"},{"title":"List post authors","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/posts/authors","href":"/api-reference/content/list-post-authors"},{"group":"Generation","expanded":true,"pages":[{"title":"Queue async post generation","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json post /v1/posts/generate","href":"/api-reference/content/queue-async-post-generation"},{"title":"Get async post generation status","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/posts/generate/{jobId}","href":"/api-reference/content/get-async-post-generation-status"}]},{"group":"Scheduling","expanded":true,"pages":[{"title":"Get a post's publishing schedule","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/posts/{postId}/schedule","href":"/api-reference/content/get-a-posts-publishing-schedule"},{"title":"Schedule a post for publishing","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json post /v1/posts/{postId}/schedule","href":"/api-reference/content/schedule-a-post-for-publishing"},{"title":"Cancel a post's publishing schedule","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json delete /v1/posts/{postId}/schedule","href":"/api-reference/content/cancel-a-posts-publishing-schedule"}]}]},{"group":"Sites","expanded":true,"pages":[{"title":"List Notra Sites","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/sites","href":"/api-reference/sites/list-notra-sites"},{"title":"Get a Site","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/sites/{siteId}","href":"/api-reference/sites/get-a-site"},{"group":"Deployments","expanded":true,"pages":[{"title":"List a Site's deployments","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/sites/{siteId}/deployments","href":"/api-reference/sites/list-a-sites-deployments"},{"title":"Deploy the production branch","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json post /v1/sites/{siteId}/deployments","href":"/api-reference/sites/deploy-the-production-branch"},{"title":"Get a deployment and its build log","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/sites/{siteId}/deployments/{deploymentId}","href":"/api-reference/sites/get-a-deployment-and-its-build-log"},{"title":"Rebuild a deployment","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json post /v1/sites/{siteId}/deployments/{deploymentId}/redeploy","href":"/api-reference/sites/rebuild-a-deployment"}]},{"group":"Posts","expanded":true,"pages":[{"title":"Preview a post on a Site","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json post /v1/sites/{siteId}/post-previews","href":"/api-reference/sites/preview-a-post-on-a-site"},{"title":"Get a post preview","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/sites/{siteId}/post-previews/{postId}","href":"/api-reference/sites/get-a-post-preview"},{"title":"Publish a post to a Site","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json post /v1/sites/{siteId}/publications","href":"/api-reference/sites/publish-a-post-to-a-site"}]},{"group":"Authors and Design","expanded":true,"pages":[{"title":"List a site's authors","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/sites/{siteId}/authors","href":"/api-reference/sites/list-a-sites-authors"},{"title":"Create or update a site author","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json put /v1/sites/{siteId}/authors/{authorId}","href":"/api-reference/sites/create-or-update-a-site-author"},{"title":"Delete a site author","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json delete /v1/sites/{siteId}/authors/{authorId}","href":"/api-reference/sites/delete-a-site-author"},{"title":"Import Notra authors into a site","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json post /v1/sites/{siteId}/authors/import","href":"/api-reference/sites/import-notra-authors-into-a-site"},{"title":"Set the author page layout","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json patch /v1/sites/{siteId}/author-page","href":"/api-reference/sites/set-the-author-page-layout"},{"title":"Set the blog and changelog paths","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json patch /v1/sites/{siteId}/sections","href":"/api-reference/sites/set-the-blog-and-changelog-paths"},{"title":"Publish a site's Design changes","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json post /v1/sites/{siteId}/publish","href":"/api-reference/sites/publish-a-sites-design-changes"}]}]},{"group":"Brand Identities","expanded":true,"pages":[{"title":"List available brand identities","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/brand-identities","href":"/api-reference/content/list-available-brand-identities"},{"title":"Get a single brand identity","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/brand-identities/{brandIdentityId}","href":"/api-reference/content/get-a-single-brand-identity"},{"title":"Update a single brand identity","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json patch /v1/brand-identities/{brandIdentityId}","href":"/api-reference/content/update-a-single-brand-identity"},{"title":"Delete a single brand identity","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json delete /v1/brand-identities/{brandIdentityId}","href":"/api-reference/content/delete-a-single-brand-identity"},{"group":"Generation","expanded":true,"pages":[{"title":"Queue async brand identity generation","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json post /v1/brand-identities/generate","href":"/api-reference/content/queue-async-brand-identity-generation"},{"title":"Get async brand identity generation status","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/brand-identities/generate/{jobId}","href":"/api-reference/content/get-async-brand-identity-generation-status"}]},{"group":"Colors","expanded":true,"pages":[{"title":"List brand colors","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/brand-identities/{brandIdentityId}/colors","href":"/api-reference/content/list-brand-colors"},{"title":"Add a brand color","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json post /v1/brand-identities/{brandIdentityId}/colors","href":"/api-reference/content/add-a-brand-color"},{"title":"Update a brand color","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json patch /v1/brand-identities/{brandIdentityId}/colors/{colorId}","href":"/api-reference/content/update-a-brand-color"},{"title":"Delete a brand color","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json delete /v1/brand-identities/{brandIdentityId}/colors/{colorId}","href":"/api-reference/content/delete-a-brand-color"}]}]},{"group":"Integrations","expanded":true,"pages":[{"title":"List available integrations","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/integrations","href":"/api-reference/content/list-available-integrations"},{"title":"Create a GitHub integration","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json post /v1/integrations/github","href":"/api-reference/content/create-a-github-integration"},{"title":"List recent GitHub activity","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/integrations/github/{integrationId}/activity","href":"/api-reference/content/list-recent-github-activity"},{"title":"Delete a single integration","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json delete /v1/integrations/{integrationId}","href":"/api-reference/content/delete-a-single-integration"}]},{"group":"Schedules","expanded":true,"pages":[{"title":"List schedules","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/schedules","href":"/api-reference/schedules/list-schedules"},{"title":"Create a schedule","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json post /v1/schedules","href":"/api-reference/schedules/create-a-schedule"},{"title":"Update a schedule","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json patch /v1/schedules/{scheduleId}","href":"/api-reference/schedules/update-a-schedule"},{"title":"Delete a schedule","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json delete /v1/schedules/{scheduleId}","href":"/api-reference/schedules/delete-a-schedule"},{"title":"Run a schedule now","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json post /v1/schedules/{scheduleId}/run","href":"/api-reference/schedules/run-a-schedule-now"},{"title":"List a schedule's runs","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/schedules/{scheduleId}/runs","href":"/api-reference/schedules/list-a-schedules-runs"}]},{"group":"Event Triggers","expanded":true,"pages":[{"title":"List event triggers","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/event-triggers","href":"/api-reference/event-triggers/list-event-triggers"},{"title":"Create an event trigger","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json post /v1/event-triggers","href":"/api-reference/event-triggers/create-an-event-trigger"},{"title":"Get an event trigger","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/event-triggers/{triggerId}","href":"/api-reference/event-triggers/get-an-event-trigger"},{"title":"Update an event trigger","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json patch /v1/event-triggers/{triggerId}","href":"/api-reference/event-triggers/update-an-event-trigger"},{"title":"Delete an event trigger","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json delete /v1/event-triggers/{triggerId}","href":"/api-reference/event-triggers/delete-an-event-trigger"}]},{"group":"Webhooks","expanded":true,"pages":[{"title":"List outbound webhook subscriptions","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/webhooks","href":"/api-reference/webhooks/list-outbound-webhook-subscriptions"},{"title":"Subscribe an HTTPS endpoint to Notra events","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json post /v1/webhooks","href":"/api-reference/webhooks/subscribe-an-https-endpoint-to-notra-events"},{"title":"Remove a webhook subscription and cancel unsent deliveries","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json delete /v1/webhooks/{endpointId}","href":"/api-reference/webhooks/remove-a-webhook-subscription-and-cancel-unsent-deliveries"},{"group":"Deliveries","expanded":true,"pages":[{"title":"List webhook deliveries","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/webhooks/deliveries","href":"/api-reference/webhooks/list-webhook-deliveries"},{"title":"Get payload and attempt history for a delivery","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/webhooks/deliveries/{deliveryId}","href":"/api-reference/webhooks/get-payload-and-attempt-history-for-a-delivery"},{"title":"Retry a failed delivery, retaining its history","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json post /v1/webhooks/deliveries/{deliveryId}/retry","href":"/api-reference/webhooks/retry-a-failed-delivery-retaining-its-history"}]}]},{"group":"Skills","expanded":true,"pages":[{"title":"List skills","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/skills","href":"/api-reference/skills/list-skills"},{"title":"Create a skill","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json post /v1/skills","href":"/api-reference/skills/create-a-skill"},{"title":"Get a single skill","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/skills/{name}","href":"/api-reference/skills/get-a-single-skill"},{"title":"Update a skill","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json patch /v1/skills/{name}","href":"/api-reference/skills/update-a-skill"},{"title":"Delete a skill","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json delete /v1/skills/{name}","href":"/api-reference/skills/delete-a-skill"}]},{"group":"Chats","expanded":true,"pages":[{"title":"List chats","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/chats","href":"/api-reference/chats/list-chats"},{"title":"Start a new chat and stream the reply","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json post /v1/chats","href":"/api-reference/chats/start-a-new-chat-and-stream-the-reply"},{"title":"Get a chat by external channel id","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/chats/by-external","href":"/api-reference/chats/get-a-chat-by-external-channel-id"},{"title":"Get a single chat with messages","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/chats/{chatId}","href":"/api-reference/chats/get-a-single-chat-with-messages"},{"title":"Post a message to an existing chat and stream the reply","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json post /v1/chats/{chatId}","href":"/api-reference/chats/post-a-message-to-an-existing-chat-and-stream-the-reply"}]},{"group":"Feedback","expanded":true,"pages":[{"title":"Submit feedback to an organization's feedback URL","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json post /v1/feedback/{organizationSlug}","href":"/api-reference/feedback/submit-feedback-to-an-organizations-feedback-url"},{"title":"Submit feedback with an API key","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json post /v1/feedback","href":"/api-reference/feedback/submit-feedback-with-an-api-key"},{"title":"List feedback","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/feedback","href":"/api-reference/feedback/list-feedback"},{"title":"Get a single feedback entry","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/feedback/{feedbackId}","href":"/api-reference/feedback/get-a-single-feedback-entry"},{"title":"Update feedback status","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json patch /v1/feedback/{feedbackId}","href":"/api-reference/feedback/update-feedback-status"}]},{"group":"GEO","expanded":true,"pages":[{"group":"Projects","expanded":true,"pages":[{"title":"List GEO projects","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects","href":"/api-reference/geo/list-geo-projects"},{"title":"Create a GEO project","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json post /v1/projects","href":"/api-reference/geo/create-a-geo-project"},{"title":"Get a single GEO project","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects/{projectId}","href":"/api-reference/geo/get-a-single-geo-project"},{"title":"Rename a GEO project or relink its brand identity","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json patch /v1/projects/{projectId}","href":"/api-reference/geo/rename-a-geo-project-or-relink-its-brand-identity"},{"title":"Delete a GEO project and all of its GEO data","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json delete /v1/projects/{projectId}","href":"/api-reference/geo/delete-a-geo-project-and-all-of-its-geo-data"}]},{"group":"Settings","expanded":true,"pages":[{"title":"Get a project's GEO settings","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects/{projectId}/geo/settings","href":"/api-reference/geo/get-a-projects-geo-settings"},{"title":"List the answer engines a project can track","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects/{projectId}/geo/engines","href":"/api-reference/geo/list-the-answer-engines-a-project-can-track"},{"title":"Replace a project's GEO settings","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json patch /v1/projects/{projectId}/geo/settings","href":"/api-reference/geo/replace-a-projects-geo-settings"}]},{"group":"Prompts","expanded":true,"pages":[{"title":"List tracked GEO prompts","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects/{projectId}/geo/prompts","href":"/api-reference/geo/list-tracked-geo-prompts"},{"title":"Track a new GEO prompt","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json post /v1/projects/{projectId}/geo/prompts","href":"/api-reference/geo/track-a-new-geo-prompt"},{"title":"Update a tracked GEO prompt","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json patch /v1/projects/{projectId}/geo/prompts/{promptId}","href":"/api-reference/geo/update-a-tracked-geo-prompt"},{"title":"Stop tracking a GEO prompt","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json delete /v1/projects/{projectId}/geo/prompts/{promptId}","href":"/api-reference/geo/stop-tracking-a-geo-prompt"},{"title":"Bulk import GEO prompts","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json post /v1/projects/{projectId}/geo/prompts/import","href":"/api-reference/geo/bulk-import-geo-prompts"},{"title":"Get the stored check history for one prompt","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects/{projectId}/geo/prompts/{promptId}/history","href":"/api-reference/geo/get-the-stored-check-history-for-one-prompt"},{"title":"List prompt suggestions","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects/{projectId}/geo/prompts/suggestions","href":"/api-reference/geo/list-prompt-suggestions"},{"title":"Accept a prompt suggestion","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json post /v1/projects/{projectId}/geo/prompts/suggestions/{suggestionId}/accept","href":"/api-reference/geo/accept-a-prompt-suggestion"},{"title":"Dismiss a prompt suggestion","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json post /v1/projects/{projectId}/geo/prompts/suggestions/{suggestionId}/dismiss","href":"/api-reference/geo/dismiss-a-prompt-suggestion"}]},{"group":"Sequences","expanded":true,"pages":[{"title":"List GEO prompt sequences","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects/{projectId}/geo/sequences","href":"/api-reference/geo/list-geo-prompt-sequences"},{"title":"Create a GEO prompt sequence","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json post /v1/projects/{projectId}/geo/sequences","href":"/api-reference/geo/create-a-geo-prompt-sequence"},{"title":"Update a GEO prompt sequence","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json patch /v1/projects/{projectId}/geo/sequences/{sequenceId}","href":"/api-reference/geo/update-a-geo-prompt-sequence"},{"title":"Delete a GEO prompt sequence","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json delete /v1/projects/{projectId}/geo/sequences/{sequenceId}","href":"/api-reference/geo/delete-a-geo-prompt-sequence"},{"title":"Run a GEO prompt sequence now","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json post /v1/projects/{projectId}/geo/sequences/{sequenceId}/run","href":"/api-reference/geo/run-a-geo-prompt-sequence-now"}]},{"group":"Personas","expanded":true,"pages":[{"title":"List GEO personas","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects/{projectId}/geo/personas","href":"/api-reference/geo/list-geo-personas"},{"title":"Generate GEO personas","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json post /v1/projects/{projectId}/geo/personas/generate","href":"/api-reference/geo/generate-geo-personas"},{"title":"Get the GEO persona generation status","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects/{projectId}/geo/personas/generation","href":"/api-reference/geo/get-the-geo-persona-generation-status"},{"title":"Get GEO persona activity","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects/{projectId}/geo/personas/activity","href":"/api-reference/geo/get-geo-persona-activity"},{"title":"Update a GEO persona","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json patch /v1/projects/{projectId}/geo/personas/{personaId}","href":"/api-reference/geo/update-a-geo-persona"},{"title":"Archive a GEO persona","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json delete /v1/projects/{projectId}/geo/personas/{personaId}","href":"/api-reference/geo/archive-a-geo-persona"},{"title":"Restore an archived GEO persona","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json post /v1/projects/{projectId}/geo/personas/{personaId}/restore","href":"/api-reference/geo/restore-an-archived-geo-persona"},{"title":"Run a GEO persona now","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json post /v1/projects/{projectId}/geo/personas/{personaId}/run","href":"/api-reference/geo/run-a-geo-persona-now"},{"title":"Get a GEO persona's conversation results","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects/{projectId}/geo/personas/{personaId}/results","href":"/api-reference/geo/get-a-geo-personas-conversation-results"}]},{"group":"Competitors","expanded":true,"pages":[{"title":"List tracked GEO competitors","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects/{projectId}/geo/competitors","href":"/api-reference/geo/list-tracked-geo-competitors"},{"title":"Create or update a tracked GEO competitor","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json put /v1/projects/{projectId}/geo/competitors","href":"/api-reference/geo/create-or-update-a-tracked-geo-competitor"},{"title":"Suggest GEO competitors for a domain","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects/{projectId}/geo/competitors/suggestions","href":"/api-reference/geo/suggest-geo-competitors-for-a-domain"},{"title":"Stop tracking a GEO competitor","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json delete /v1/projects/{projectId}/geo/competitors/{name}","href":"/api-reference/geo/stop-tracking-a-geo-competitor"},{"title":"Bulk import GEO competitors","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json post /v1/projects/{projectId}/geo/competitors/import","href":"/api-reference/geo/bulk-import-geo-competitors"}]},{"group":"Scans","expanded":true,"pages":[{"title":"Trigger a GEO scan","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json post /v1/projects/{projectId}/geo/scans","href":"/api-reference/geo/trigger-a-geo-scan"},{"title":"List GEO scans","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects/{projectId}/geo/scans","href":"/api-reference/geo/list-geo-scans"},{"title":"Get a single GEO scan","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects/{projectId}/geo/scans/{scanId}","href":"/api-reference/geo/get-a-single-geo-scan"},{"title":"Rescan a single GEO prompt","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json post /v1/projects/{projectId}/geo/scans/prompts/{promptId}","href":"/api-reference/geo/rescan-a-single-geo-prompt"},{"title":"Compare the two latest GEO scans","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects/{projectId}/geo/changes","href":"/api-reference/geo/compare-the-two-latest-geo-scans"}]},{"group":"Visibility","expanded":true,"pages":[{"title":"Get mention rates per engine","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects/{projectId}/geo/visibility/overview","href":"/api-reference/geo/get-mention-rates-per-engine"},{"title":"Get daily mention counts per engine","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects/{projectId}/geo/visibility/timeseries","href":"/api-reference/geo/get-daily-mention-counts-per-engine"},{"title":"Get the latest answer per prompt and engine","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects/{projectId}/geo/visibility/prompt-results","href":"/api-reference/geo/get-the-latest-answer-per-prompt-and-engine"},{"title":"List compact prompt result summaries","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects/{projectId}/geo/visibility/prompt-results/summaries","href":"/api-reference/geo/list-compact-prompt-result-summaries"},{"title":"Get one full prompt result","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects/{projectId}/geo/visibility/prompt-results/{checkId}","href":"/api-reference/geo/get-one-full-prompt-result"},{"title":"Get share of voice across tracked brands","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects/{projectId}/geo/visibility/competitor-share","href":"/api-reference/geo/get-share-of-voice-across-tracked-brands"},{"title":"Get mention rates per tracked language","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects/{projectId}/geo/visibility/language-share","href":"/api-reference/geo/get-mention-rates-per-tracked-language"},{"title":"Get one competitor's mention history","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects/{projectId}/geo/visibility/competitors/{brand}","href":"/api-reference/geo/get-one-competitors-mention-history"},{"title":"List stored GEO shelf sources","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects/{projectId}/geo/shelf-sources","href":"/api-reference/geo/list-stored-geo-shelf-sources"}]},{"group":"Sentiment","expanded":true,"pages":[{"title":"Get aggregate GEO sentiment","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects/{projectId}/geo/sentiment","href":"/api-reference/geo/get-aggregate-geo-sentiment"},{"title":"Get the stored GEO sentiment analysis","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects/{projectId}/geo/sentiment/analysis","href":"/api-reference/geo/get-the-stored-geo-sentiment-analysis"},{"title":"List answers used as sentiment evidence","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects/{projectId}/geo/sentiment/evidence","href":"/api-reference/geo/list-answers-used-as-sentiment-evidence"}]},{"group":"Content Gaps and Briefs","expanded":true,"pages":[{"title":"List content gaps","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects/{projectId}/geo/gaps","href":"/api-reference/geo/list-content-gaps"},{"title":"Ignore or restore a content gap","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json patch /v1/projects/{projectId}/geo/gaps/{promptId}","href":"/api-reference/geo/ignore-or-restore-a-content-gap"},{"title":"List content briefs","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects/{projectId}/geo/briefs","href":"/api-reference/geo/list-content-briefs"},{"title":"Plan a content brief","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json post /v1/projects/{projectId}/geo/briefs","href":"/api-reference/geo/plan-a-content-brief"},{"title":"Get a single content brief","description":null,"deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects/{projectId}/geo/briefs/{briefId}","href":"/api-reference/geo/get-a-single-content-brief"},{"title":"Update a content brief","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json patch /v1/projects/{projectId}/geo/briefs/{briefId}","href":"/api-reference/geo/update-a-content-brief"},{"title":"Approve a brief and start the writer","description":"Claims the brief and queues the writer with the Notra dashboard. Only briefs in `draft` or `failed` can be approved; anything else returns 409.","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json post /v1/projects/{projectId}/geo/briefs/{briefId}/approve","href":"/api-reference/geo/approve-a-brief-and-start-the-writer"}]},{"group":"Agent Readiness","expanded":true,"pages":[{"title":"Get the latest agent readiness report","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects/{projectId}/geo/agent-readiness","href":"/api-reference/geo/get-the-latest-agent-readiness-report"},{"title":"Start an agent readiness scan","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json post /v1/projects/{projectId}/geo/agent-readiness/scan","href":"/api-reference/geo/start-an-agent-readiness-scan"}]},{"group":"Traffic","expanded":true,"pages":[{"title":"Get AI traffic totals and sources","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects/{projectId}/geo/traffic/overview","href":"/api-reference/geo/get-ai-traffic-totals-and-sources"},{"title":"Get recent AI traffic events","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects/{projectId}/geo/traffic/log","href":"/api-reference/geo/get-recent-ai-traffic-events"},{"title":"List AI traffic journeys","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects/{projectId}/geo/traffic/journeys","href":"/api-reference/geo/list-ai-traffic-journeys"},{"title":"Get one journey's events","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects/{projectId}/geo/traffic/journeys/{journeyId}","href":"/api-reference/geo/get-one-journeys-events"},{"title":"Get AI journey statistics","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects/{projectId}/geo/traffic/journey-stats","href":"/api-reference/geo/get-ai-journey-statistics"},{"title":"List the most visited pages","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects/{projectId}/geo/traffic/pages","href":"/api-reference/geo/list-the-most-visited-pages"},{"title":"Get MCP server analytics","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects/{projectId}/geo/traffic/mcp","href":"/api-reference/geo/get-mcp-server-analytics"},{"title":"Get one MCP tool's analytics","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects/{projectId}/geo/traffic/mcp/tools/{toolName}","href":"/api-reference/geo/get-one-mcp-tools-analytics"}]},{"group":"Website Analytics","expanded":true,"pages":[{"title":"Get website analytics totals and trend","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects/{projectId}/geo/traffic/web","href":"/api-reference/geo/get-website-analytics-totals-and-trend"},{"title":"Get website analytics breakdowns","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects/{projectId}/geo/traffic/web/breakdowns","href":"/api-reference/geo/get-website-analytics-breakdowns"},{"title":"Get website sessions by UTM parameter","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects/{projectId}/geo/traffic/web/utm","href":"/api-reference/geo/get-website-sessions-by-utm-parameter"},{"title":"List history imports","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects/{projectId}/geo/traffic/imports","href":"/api-reference/geo/list-history-imports"}]},{"group":"Traffic Ingest","expanded":true,"pages":[{"title":"Get the install snippets","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/geo/ingest/setup","href":"/api-reference/geo/get-the-install-snippets"},{"title":"Issue the tracking token","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json post /v1/geo/ingest/token","href":"/api-reference/geo/issue-the-tracking-token"},{"title":"Rotate the tracking token","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json post /v1/geo/ingest/rotate-token","href":"/api-reference/geo/rotate-the-tracking-token"}]}]},{"group":"Agent","expanded":true,"pages":[{"title":"Start a durable agent session","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json post /v2/eve/v1/session","href":"/api-reference/agent/start-a-durable-agent-session"},{"title":"Send a follow-up message or answer a pending input request","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json post /v2/eve/v1/session/{sessionId}","href":"/api-reference/agent/send-a-follow-up-message-or-answer-a-pending-input-request"},{"title":"Stream an agent session's events","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v2/eve/v1/session/{sessionId}/stream","href":"/api-reference/agent/stream-an-agent-sessions-events"},{"title":"List agent sessions","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v2/agent-chats","href":"/api-reference/agent/list-agent-sessions"}]}]}]}]},"basePath":"","title":"Update a content brief - Notra Documentation","buildId":"dpl_6PxPD4Fj1JDU9BJxEHvfdUmxKThw","deploymentId":"dpl_6PxPD4Fj1JDU9BJxEHvfdUmxKThw","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CASS2Vpq.js","utils-4k9fyWRu.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-UU-UueZb.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-BgJ0LOYq.js","snippetPresets-CMgzlMR-.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BzEJegkK.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CZuQIZdk.js","shallow-Bw5arfMA.js","getApiPlaygroundDisplay-Ds834aVN.js","CodeSnippet-CKzmjw9L.js","CodeSnippets-BRpgomdp.js","Page-DvEUoD2H.js","getPastedJson-B0N-Tn76.js","icon-DASMs9nC.js","MethodPill-BA6DBLqx.js","DuplicateIcon-BMT5qfbJ.js","createIcon-CNfwVWPx.js","DynamicMarkdown-JYyBNlrJ.js","SectionHeading-BbZnmz8a.js","axios-vUo_bRtp.js","Markdown-LUU0YLpA.js","clsx-Di4ek5Ae.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-VEVWQCR4.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-CPszyu99.js"]}