Optional. The brief's updated_at from your last read. If the brief changed since then, nothing is updated, so a newer edit is not overwritten: read it again and reapply the change.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Cognizo Docs","description":"Cognizo API and MCP Documentation. Track and grow your brand's visibility, share of voice, and sentiment across AI search engines like ChatGPT, Claude, Perplexity, and Google AI Overviews.","colors":{"primary":"#6C4CF1","light":"#8A6EF5","dark":"#4A2FD0"},"logo":{"light":"https://mintcdn.com/cognizo/x-lz_CTiDXjk7exn/images/cognizo-logo.png?fit=max\u0026auto=format\u0026n=x-lz_CTiDXjk7exn\u0026q=85\u0026s=beb92c1c8994be1c625caf4c4840ba0b","dark":"https://mintcdn.com/cognizo/x-lz_CTiDXjk7exn/images/cognizo-logo-dark.png?fit=max\u0026auto=format\u0026n=x-lz_CTiDXjk7exn\u0026q=85\u0026s=afa66996adab115482c97e8d5ba5ecd9","href":"https://docs.cognizo.ai"},"favicon":"https://mintcdn.com/cognizo/aQn_f7JfezHrAXFA/favicon.png?fit=max\u0026auto=format\u0026n=aQn_f7JfezHrAXFA\u0026q=85\u0026s=a77aea5ad0f9e341aa31106b5363b783","background":{"color":{"dark":"#0B081C"}},"navbar":{"links":[{"href":"https://cognizo.ai","label":"Website"},{"href":"https://help.cognizo.ai","label":"Help Center"},{"href":"https://www.cognizo.ai/blog","label":"Blog"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.cognizo.ai"}},"footer":{"socials":{"website":"https://cognizo.ai","linkedin":"https://linkedin.com/company/cognizo"}},"seo":{"indexing":"all"},"fonts":{"family":"Geist"},"icons":{"library":"fontawesome"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"cognizo","hasAudioNarration":false,"actualSubdomain":"cognizo","customDomains":["docs.cognizo.ai"],"gitSource":{"type":"github","owner":"cognizo-ai","repo":"cognizo-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"collectionId":"29cee2e4-9777-4d4c-b42a-474cddc0af33","liveDeploymentHistoryId":"6ae4ed2bafc3f6fb7305af70","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae4ed2bafc3f6fb7305af70"},"feedback":{"thumbs":false},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6ae4ed2bafc3f6fb7305af70","clientVersion":"0.0.4054","searchFilterCounts":[{"language":"default","tag":"API Reference","count":79},{"language":"default","tag":"ContentStudio","count":13},{"language":"default","tag":"Guides","count":12},{"language":"default","tag":"Citations","count":8},{"language":"default","tag":"Prompts","count":8},{"language":"default","tag":"BrandActions","count":6},{"language":"default","tag":"Technical audit","count":6},{"language":"default","tag":"Brands","count":5},{"language":"default","tag":"Opportunities","count":5},{"language":"default","tag":"Topics","count":5}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[],"page":{"pagePath":"api-reference/contentstudio/rename-a-content-brief","slug":"/api-reference/contentstudio/rename-a-content-brief","pageMetadata":{"title":"Rename a content brief","description":null,"deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /api/v2/brands/{brand_id}/content_studio/briefs/{id}","href":"/api-reference/contentstudio/rename-a-content-brief","autogeneratedByOpenApi":true},"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":{"title":"Rename a content brief","description":null,"deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /api/v2/brands/{brand_id}/content_studio/briefs/{id}","href":"/api-reference/contentstudio/rename-a-content-brief","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Rename a content brief","tags":["ContentStudio"],"parameters":[],"responses":{"200":"94d2f386-5a11-44b2-a05c-09e2fa2812d7","403":"e883409a-335b-4947-8029-34a806ab7915","404":"e9bcd155-f2dd-4d2b-80f8-7c60066bca51","409":"174c4989-d5ee-4c07-ba60-033180d06fd8","422":"93fc8fb1-b486-4c07-a6f5-7c010a5737a1","500":"c7d8c4c1-b588-440d-b1c0-71358761f3b9"},"requestBody":"d935d4ed-2dda-4269-b291-21185fd90239","operationId":"update_brand_content_studio_brief","method":"patch","type":"path","servers":["1a28411b-53fb-41ce-be43-58f79ba80bcf"],"security":["5b6dc2ab-64a5-4379-9221-a06e2aded3ed"],"path":"/api/v2/brands/{brand_id}/content_studio/briefs/{id}","baseUrlOptions":["https://core.cognizo.ai"],"title":"Rename a content brief","description":"","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"0840e011-3a31-4b81-a5b8-b6c5dc27f98d":{"name":"brand_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"","typeLabel":"string\u003cuuid>"}},"bc0a8f2f-47c3-480d-96d7-556faf1aed96":{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"","typeLabel":"string\u003cuuid>"}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"expected_updated_at":{"oneOf":[{"type":"string","format":"date-time","description":"Optional. The brief's `updated_at` from your last read. If the brief changed since then, nothing is updated, so a newer edit is not overwritten: read it again and reapply the change.","uniqueKey":"expected_updated_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"Optional. The brief's `updated_at` from your last read. If the brief changed since then, nothing is updated, so a newer edit is not overwritten: read it again and reapply the change.","uniqueKey":"expected_updated_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"expected_updated_at","typeLabel":"string\u003cdate-time> | null"}},"required":["title"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"title":"\u003cstring>","expected_updated_at":"2023-11-07T05:31:56Z"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"94d2f386-5a11-44b2-a05c-09e2fa2812d7":{"description":"title saved","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"data.id","typeLabel":"string\u003cuuid>"},"brand_id":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"data.brand_id","typeLabel":"string\u003cuuid>"},"audience_id":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"data.audience_id","typeLabel":"string\u003cuuid>"},"format":{"type":"string","enum":["how_to_guide","comparison","product_review","listicle","case_study","pricing_breakdown","alternative","article","opinion_piece","news_article","glossary_page","technical","features","documentation","service_page","product_page"],"isRequired":true,"uniqueKey":"data.format","typeLabel":"enum\u003cstring>"},"outline":{"type":"object","additionalProperties":true,"description":"{ sections: [{title, purpose, key_points[], target_words, uses_required_element, answers_queries[], delivers_table}] }","isRequired":true,"uniqueKey":"data.outline","typeLabel":"object"},"metadata":{"type":"object","additionalProperties":true,"description":"Pipeline scratchpad: weights snapshot, sources, tool-call trace, enhancements","isRequired":true,"uniqueKey":"data.metadata","typeLabel":"object"},"state":{"type":"string","enum":["new","brief_generating","brief_ready","article_generating","article_ready","failed"],"isRequired":true,"uniqueKey":"data.state","typeLabel":"enum\u003cstring>"},"workflow_status":{"type":"string","enum":["generating_brief","reviewing_brief","generating_article","review_and_publish","scheduled","published","failed"],"description":"User-facing workflow label derived from state + publication signals. `scheduled` means the article is booked into a publish slot — nothing is waiting on the customer and the deck deals no card for it; `published` wins over a held slot, because a live article can hold one for its next refresh.","isRequired":true,"uniqueKey":"data.workflow_status","typeLabel":"enum\u003cstring>"},"progress_pct":{"type":"integer","isRequired":true,"uniqueKey":"data.progress_pct","typeLabel":"integer"},"auto_generated":{"type":"boolean","description":"True when the content autopilot created this brief rather than a person — the contents list marks these \"Auto-generated by Cognizo\".","isRequired":true,"uniqueKey":"data.auto_generated","typeLabel":"boolean"},"unlockable":{"type":"boolean","description":"True when the brief may be unlocked: its article is finished (or failed) and nothing is published. Unlocking deletes the article and returns the brief to brief_ready; regeneration afterwards is free.","isRequired":true,"uniqueKey":"data.unlockable","typeLabel":"boolean"},"audience_name":{"oneOf":[{"type":"string","uniqueKey":"data.audience_name.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.audience_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.audience_name","typeLabel":"string | null"},"topic_id":{"oneOf":[{"type":"string","format":"uuid","description":"Anchor topic — DERIVED server-side from the selected prompts (most-covered topic); null for rewrite/legacy briefs","uniqueKey":"data.topic_id.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","format":"uuid","description":"Anchor topic — DERIVED server-side from the selected prompts (most-covered topic); null for rewrite/legacy briefs","uniqueKey":"data.topic_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.topic_id","typeLabel":"string\u003cuuid> | null"},"topic_name":{"oneOf":[{"type":"string","uniqueKey":"data.topic_name.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.topic_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.topic_name","typeLabel":"string | null"},"target_prompts":{"type":"array","description":"Resolved target prompts with display data (Inputs panel). Populated from the brief's generator-stamped prompt universe, falling back to the prompts the create wizard recorded, so a wizard or boosted brief resolves before generation runs.","items":{"type":"object","properties":{"prompt_id":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"data.target_prompts.items.[INDEX].prompt_id","typeLabel":"string\u003cuuid>"},"prompt":{"type":"string","isRequired":true,"uniqueKey":"data.target_prompts.items.[INDEX].prompt","typeLabel":"string"},"region_id":{"oneOf":[{"type":"string","format":"uuid","description":"The prompt's canonical region for this brand (its oldest tracked variety) — every prompt read is per-region, so the prompt panel needs this to open. Null when the brand no longer tracks the prompt.","isRequired":true,"uniqueKey":"data.target_prompts.items.[INDEX].region_id.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","format":"uuid","description":"The prompt's canonical region for this brand (its oldest tracked variety) — every prompt read is per-region, so the prompt panel needs this to open. Null when the brand no longer tracks the prompt.","isRequired":true,"uniqueKey":"data.target_prompts.items.[INDEX].region_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.target_prompts.items.[INDEX].region_id","typeLabel":"string\u003cuuid> | null"},"country_codes":{"type":"array","items":{"type":"string","uniqueKey":"data.target_prompts.items.[INDEX].country_codes.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"data.target_prompts.items.[INDEX].country_codes","typeLabel":"string[]"},"volume_range":{"type":"string","enum":["\u003c10","10-50","50-150","150-250","250-500","500-1k","1k-2.5k","2.5k-5k","5k-15k","15k-50k","50k-150k","150k-500k","500k-1m","1m+"],"description":"Monthly search volume bracket for the prompt's canonical region, the same bucket the prompts page shows. Never null: a prompt with no stored estimate falls back to the smallest bucket.","isRequired":true,"uniqueKey":"data.target_prompts.items.[INDEX].volume_range","typeLabel":"enum\u003cstring>"}},"required":["prompt_id","prompt","region_id","country_codes","volume_range"],"uniqueKey":"data.target_prompts.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.target_prompts","typeLabel":"object[]"},"recommendation_id":{"oneOf":[{"type":"string","format":"uuid","uniqueKey":"data.recommendation_id.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","format":"uuid","uniqueKey":"data.recommendation_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.recommendation_id","typeLabel":"string\u003cuuid> | null"},"recommendation":{"oneOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid","uniqueKey":"data.recommendation.oneOf.0.id","typeLabel":"string\u003cuuid>"},"type":{"type":"string","enum":["social_post","earned_3rd_party","owned_create","owned_refresh","no_action","social","earned","owned"],"uniqueKey":"data.recommendation.oneOf.0.type","typeLabel":"enum\u003cstring>"},"suggested_title":{"oneOf":[{"type":"string","uniqueKey":"data.recommendation.oneOf.0.suggested_title.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.recommendation.oneOf.0.suggested_title.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.recommendation.oneOf.0.suggested_title","typeLabel":"string | null"},"state":{"type":"string","enum":["new","saved","done","dismissed"],"description":"Lifecycle state — lets the source-rec chip open the matching inbox tab","uniqueKey":"data.recommendation.oneOf.0.state","typeLabel":"enum\u003cstring>"}},"uniqueKey":"data.recommendation.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"id":{"type":"string","format":"uuid"},"type":{"type":"string","enum":["social_post","earned_3rd_party","owned_create","owned_refresh","no_action","social","earned","owned"]},"suggested_title":{"oneOf":[{"type":"string"},{"type":"null"}]},"state":{"type":"string","enum":["new","saved","done","dismissed"],"description":"Lifecycle state — lets the source-rec chip open the matching inbox tab"}},"uniqueKey":"data.recommendation.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.recommendation","typeLabel":"object | null"},"title":{"oneOf":[{"type":"string","description":"Null until brief_ready when created without one (derived from research)","uniqueKey":"data.title.oneOf.0","typeLabel":"string"},{"type":"null","description":"Null until brief_ready when created without one (derived from research)","uniqueKey":"data.title.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.title","typeLabel":"string | null"},"mode":{"type":"string","enum":["create","rewrite"],"description":"rewrite briefs replace an existing owned page's content","uniqueKey":"data.mode","typeLabel":"enum\u003cstring>"},"source_url":{"oneOf":[{"type":"string","description":"The owned page being rewritten; null on create-mode briefs","uniqueKey":"data.source_url.oneOf.0","typeLabel":"string"},{"type":"null","description":"The owned page being rewritten; null on create-mode briefs","uniqueKey":"data.source_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.source_url","typeLabel":"string | null"},"target_word_count":{"oneOf":[{"type":"integer","uniqueKey":"data.target_word_count.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"data.target_word_count.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.target_word_count","typeLabel":"integer | null"},"additional_instructions":{"oneOf":[{"type":"string","description":"User's free-text steering from the wizard's advanced settings","uniqueKey":"data.additional_instructions.oneOf.0","typeLabel":"string"},{"type":"null","description":"User's free-text steering from the wizard's advanced settings","uniqueKey":"data.additional_instructions.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.additional_instructions","typeLabel":"string | null"},"brief_text":{"oneOf":[{"type":"string","description":"Markdown brief — the article writer's primary input; null until brief_ready","uniqueKey":"data.brief_text.oneOf.0","typeLabel":"string"},{"type":"null","description":"Markdown brief — the article writer's primary input; null until brief_ready","uniqueKey":"data.brief_text.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.brief_text","typeLabel":"string | null"},"article":{"oneOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid","uniqueKey":"data.article.oneOf.0.id","typeLabel":"string\u003cuuid>"},"state":{"type":"string","uniqueKey":"data.article.oneOf.0.state","typeLabel":"string"},"progress_pct":{"type":"integer","uniqueKey":"data.article.oneOf.0.progress_pct","typeLabel":"integer"},"published_url":{"oneOf":[{"type":"string","description":"Live URL on the customer's own site — auto-captured by the coverage-crawl title matcher","uniqueKey":"data.article.oneOf.0.published_url.oneOf.0","typeLabel":"string"},{"type":"null","description":"Live URL on the customer's own site — auto-captured by the coverage-crawl title matcher","uniqueKey":"data.article.oneOf.0.published_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.article.oneOf.0.published_url","typeLabel":"string | null"}},"description":"Stub when an article exists — fetch the body via GET /articles/{id}","uniqueKey":"data.article.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"id":{"type":"string","format":"uuid"},"state":{"type":"string"},"progress_pct":{"type":"integer"},"published_url":{"oneOf":[{"type":"string","description":"Live URL on the customer's own site — auto-captured by the coverage-crawl title matcher"},{"type":"null","description":"Live URL on the customer's own site — auto-captured by the coverage-crawl title matcher"}]}},"description":"Stub when an article exists — fetch the body via GET /articles/{id}","uniqueKey":"data.article.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.article","typeLabel":"object | null"},"generation_error":{"oneOf":[{"type":"string","uniqueKey":"data.generation_error.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.generation_error.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.generation_error","typeLabel":"string | null"},"created_at":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"data.created_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"data.created_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.created_at","typeLabel":"string\u003cdate-time> | null"},"updated_at":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"data.updated_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"data.updated_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.updated_at","typeLabel":"string\u003cdate-time> | null"},"deleted_at":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"data.deleted_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"data.deleted_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.deleted_at","typeLabel":"string\u003cdate-time> | null"}},"required":["id","brand_id","audience_id","format","state","workflow_status","progress_pct","outline","metadata","auto_generated","unlockable"],"isRequired":true,"uniqueKey":"data","typeLabel":"object"}},"required":["data"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"data":{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","brand_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","audience_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","format":"how_to_guide","outline":{},"metadata":{},"state":"new","workflow_status":"generating_brief","progress_pct":123,"auto_generated":true,"unlockable":true,"audience_name":"\u003cstring>","topic_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","topic_name":"\u003cstring>","target_prompts":[{"prompt_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","prompt":"\u003cstring>","region_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","country_codes":["\u003cstring>"],"volume_range":"\u003c10"}],"recommendation_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","recommendation":{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","type":"social_post","suggested_title":"\u003cstring>","state":"new"},"title":"\u003cstring>","mode":"create","source_url":"\u003cstring>","target_word_count":123,"additional_instructions":"\u003cstring>","brief_text":"\u003cstring>","article":{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","state":"\u003cstring>","progress_pct":123,"published_url":"\u003cstring>"},"generation_error":"\u003cstring>","created_at":"2023-11-07T05:31:56Z","updated_at":"2023-11-07T05:31:56Z","deleted_at":"2023-11-07T05:31:56Z"}}}},"exampleType":"generated"}},"exampleType":"generated"},"e883409a-335b-4947-8029-34a806ab7915":{"description":"organization access revoked (ORGANIZATION_ACCESS_REVOKED): the access token's organization is no longer one of the user's memberships (they left, were removed, or the organization was deleted). The session itself is still valid: drop the organization's client state and refresh the session, which moves it to another organization.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","description":"Stable machine-readable reason; see `error_code`.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"error.details.items.[INDEX].field.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"error.details.items.[INDEX].field.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error.details.items.[INDEX].field","typeLabel":"string | null"},"code":{"type":"string","isRequired":true,"uniqueKey":"error.details.items.[INDEX].code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.details.items.[INDEX].message","typeLabel":"string"}},"required":["code","message","field"],"uniqueKey":"error.details.items.[INDEX]","typeLabel":"object"},"uniqueKey":"error.details","typeLabel":"object[]"}},"required":["code","message"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","details":[{"field":"\u003cstring>","code":"\u003cstring>","message":"\u003cstring>"}]}}}},"exampleType":"generated"}},"exampleType":"generated"},"e9bcd155-f2dd-4d2b-80f8-7c60066bca51":{"description":"brief not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","description":"Stable machine-readable reason; see `error_code`.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"error.details.items.[INDEX].field.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"error.details.items.[INDEX].field.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error.details.items.[INDEX].field","typeLabel":"string | null"},"code":{"type":"string","isRequired":true,"uniqueKey":"error.details.items.[INDEX].code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.details.items.[INDEX].message","typeLabel":"string"}},"required":["code","message","field"],"uniqueKey":"error.details.items.[INDEX]","typeLabel":"object"},"uniqueKey":"error.details","typeLabel":"object[]"}},"required":["code","message"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","details":[{"field":"\u003cstring>","code":"\u003cstring>","message":"\u003cstring>"}]}}}},"exampleType":"generated"}},"exampleType":"generated"},"174c4989-d5ee-4c07-ba60-033180d06fd8":{"description":"brief mid-generation or stale expected_updated_at (VERSION_CONFLICT)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","description":"Stable machine-readable reason; see `error_code`.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"error.details.items.[INDEX].field.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"error.details.items.[INDEX].field.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error.details.items.[INDEX].field","typeLabel":"string | null"},"code":{"type":"string","isRequired":true,"uniqueKey":"error.details.items.[INDEX].code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.details.items.[INDEX].message","typeLabel":"string"}},"required":["code","message","field"],"uniqueKey":"error.details.items.[INDEX]","typeLabel":"object"},"uniqueKey":"error.details","typeLabel":"object[]"}},"required":["code","message"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","details":[{"field":"\u003cstring>","code":"\u003cstring>","message":"\u003cstring>"}]}}}},"exampleType":"generated"}},"exampleType":"generated"},"93fc8fb1-b486-4c07-a6f5-7c010a5737a1":{"description":"blank title","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","description":"Stable machine-readable reason; see `error_code`.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"error.details.items.[INDEX].field.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"error.details.items.[INDEX].field.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error.details.items.[INDEX].field","typeLabel":"string | null"},"code":{"type":"string","isRequired":true,"uniqueKey":"error.details.items.[INDEX].code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.details.items.[INDEX].message","typeLabel":"string"}},"required":["code","message","field"],"uniqueKey":"error.details.items.[INDEX]","typeLabel":"object"},"uniqueKey":"error.details","typeLabel":"object[]"}},"required":["code","message"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","details":[{"field":"\u003cstring>","code":"\u003cstring>","message":"\u003cstring>"}]}}}},"exampleType":"generated"}},"exampleType":"generated"},"c7d8c4c1-b588-440d-b1c0-71358761f3b9":{"description":"unexpected error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","description":"Stable machine-readable reason; see `error_code`.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"error.details.items.[INDEX].field.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"error.details.items.[INDEX].field.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error.details.items.[INDEX].field","typeLabel":"string | null"},"code":{"type":"string","isRequired":true,"uniqueKey":"error.details.items.[INDEX].code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.details.items.[INDEX].message","typeLabel":"string"}},"required":["code","message","field"],"uniqueKey":"error.details.items.[INDEX]","typeLabel":"object"},"uniqueKey":"error.details","typeLabel":"object[]"}},"required":["code","message"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","details":[{"field":"\u003cstring>","code":"\u003cstring>","message":"\u003cstring>"}]}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"5b6dc2ab-64a5-4379-9221-a06e2aded3ed":{"apiKey":{"type":"apiKey","in":"header","name":"X-API-KEY","scopes":[],"schemeName":"apiKey"}}},"servers":{"1a28411b-53fb-41ce-be43-58f79ba80bcf":{"url":"https://core.cognizo.ai"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-API-KEY","scopes":[],"schemeName":"apiKey"},"schema":{"title":"X-API-KEY","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"apiKey","name":"X-API-KEY"}],"title":"apiKey"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"cognizo","siteName":"Cognizo Docs","title":"Rename a content brief - Cognizo Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-30T19:17:05.425Z","originalFileLocation":"api-reference/contentstudio/rename-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=\"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=\"application-name\" content=\"Cognizo 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/cognizo/gUxCvqimeXGJ3dX1/_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/cognizo/gUxCvqimeXGJ3dX1/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/cognizo/gUxCvqimeXGJ3dX1/_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/cognizo/gUxCvqimeXGJ3dX1/_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/cognizo/gUxCvqimeXGJ3dX1/_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/cognizo/gUxCvqimeXGJ3dX1/_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/cognizo/gUxCvqimeXGJ3dX1/_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/cognizo/gUxCvqimeXGJ3dX1/_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/cognizo/gUxCvqimeXGJ3dX1/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Rename a content brief - Cognizo Docs\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Cognizo Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.cognizo.ai/api-reference/contentstudio/rename-a-content-brief\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://cognizo.mintlify.app/_mintlify/api/og/v2?division=ContentStudio\u0026amp;title=Rename+a+content+brief\u0026amp;theme=ba2aed5c62369492a9ac6532\u0026amp;signature=13df140efd31015e0e1c04c1bd9a42a36fba1932db1ab6474015db72f55d2d98\">\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=\"Rename a content brief - Cognizo Docs\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://cognizo.mintlify.app/_mintlify/api/og/v2?division=ContentStudio\u0026amp;title=Rename+a+content+brief\u0026amp;theme=ba2aed5c62369492a9ac6532\u0026amp;signature=13df140efd31015e0e1c04c1bd9a42a36fba1932db1ab6474015db72f55d2d98\">\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/cognizo/gUxCvqimeXGJ3dX1/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Cognizo Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#6C4CF1\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.cognizo.ai/api-reference/contentstudio/rename-a-content-brief\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/contentstudio/rename-a-content-brief.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.cognizo.ai/#organization\",\"name\":\"Cognizo Docs\",\"url\":\"https://docs.cognizo.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/cognizo/x-lz_CTiDXjk7exn/images/cognizo-logo.png?fit=max\u0026auto=format\u0026n=x-lz_CTiDXjk7exn\u0026q=85\u0026s=beb92c1c8994be1c625caf4c4840ba0b\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.cognizo.ai#website\",\"name\":\"Cognizo Docs\",\"url\":\"https://docs.cognizo.ai\",\"publisher\":{\"@id\":\"https://docs.cognizo.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.cognizo.ai/api-reference/contentstudio/rename-a-content-brief#webpage\",\"url\":\"https://docs.cognizo.ai/api-reference/contentstudio/rename-a-content-brief\",\"name\":\"Rename a content brief\",\"dateModified\":\"2026-10-30T19:17:05.425Z\",\"isPartOf\":{\"@id\":\"https://docs.cognizo.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.cognizo.ai/api-reference/contentstudio/rename-a-content-brief#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.cognizo.ai/api-reference/contentstudio/rename-a-content-brief#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"ContentStudio\",\"item\":\"https://docs.cognizo.ai/api-reference/contentstudio/list-content-recommendations\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Rename a content brief\",\"item\":\"https://docs.cognizo.ai/api-reference/contentstudio/rename-a-content-brief\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.cognizo.ai/api-reference/contentstudio/rename-a-content-brief#apireference\",\"headline\":\"Rename a content brief\",\"name\":\"Rename a content brief\",\"url\":\"https://docs.cognizo.ai/api-reference/contentstudio/rename-a-content-brief\",\"mainEntityOfPage\":{\"@id\":\"https://docs.cognizo.ai/api-reference/contentstudio/rename-a-content-brief#webpage\"},\"dateModified\":\"2026-10-30T19:17:05.425Z\",\"publisher\":{\"@id\":\"https://docs.cognizo.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.cognizo.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Cognizo Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Cognizo Docs","nav":{"global":null,"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":""}]},{"tab":"API Reference","groups":[{"group":"Overview","pages":[{"title":"API Reference","href":"/api-reference/introduction"}]},{"group":"Brands","pages":[{"title":"List brands","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v2/brands","href":"/api-reference/brands/list-brands"},{"title":"Create (or reactivate) a brand","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v2/brands","href":"/api-reference/brands/create-or-reactivate-a-brand"},{"title":"Get a brand","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v2/brands/{brand_id}","href":"/api-reference/brands/get-a-brand"},{"title":"Soft-delete a brand","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/v2/brands/{brand_id}","href":"/api-reference/brands/soft-delete-a-brand"},{"title":"Update a brand","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /api/v2/brands/{brand_id}","href":"/api-reference/brands/update-a-brand"}]},{"group":"Metrics","pages":[{"title":"Brand-level visibility (aggregate + time series)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v2/brands/{brand_id}/visibility","href":"/api-reference/metrics/brand-level-visibility-aggregate-+-time-series"},{"title":"Brand-level share of voice (aggregate + time series)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v2/brands/{brand_id}/share_of_voice","href":"/api-reference/metrics/brand-level-share-of-voice-aggregate-+-time-series"},{"title":"Brand-level sentiment (aggregate + time series)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v2/brands/{brand_id}/sentiment","href":"/api-reference/metrics/brand-level-sentiment-aggregate-+-time-series"},{"title":"Brand-level average position (aggregate + time series)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v2/brands/{brand_id}/average_position","href":"/api-reference/metrics/brand-level-average-position-aggregate-+-time-series"}]},{"group":"Topics","pages":[{"title":"List a brand's topics with their metrics and prompt counts","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v2/brands/{brand_id}/topics","href":"/api-reference/topics/list-a-brands-topics-with-their-metrics-and-prompt-counts"},{"title":"Bulk-create topics (reactivates soft-deleted names)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v2/brands/{brand_id}/topics","href":"/api-reference/topics/bulk-create-topics-reactivates-soft-deleted-names"},{"title":"Get one topic with extended metrics","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v2/brands/{brand_id}/topics/{topic_id}","href":"/api-reference/topics/get-one-topic-with-extended-metrics"},{"title":"Soft-delete a topic and deactivate its prompts","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/v2/brands/{brand_id}/topics/{topic_id}","href":"/api-reference/topics/soft-delete-a-topic-and-deactivate-its-prompts"},{"title":"Rename / soft-delete a topic","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /api/v2/brands/{brand_id}/topics/{topic_id}","href":"/api-reference/topics/rename-soft-delete-a-topic"}]},{"group":"Prompts","pages":[{"title":"List a brand's prompts with their metrics","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v2/brands/{brand_id}/prompts","href":"/api-reference/prompts/list-a-brands-prompts-with-their-metrics"},{"title":"Bulk-add prompts to a brand","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v2/brands/{brand_id}/prompts","href":"/api-reference/prompts/bulk-add-prompts-to-a-brand"},{"title":"Bulk-edit prompts (move topic / soft delete / reactivate)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /api/v2/brands/{brand_id}/prompts","href":"/api-reference/prompts/bulk-edit-prompts-move-topic-soft-delete-reactivate"},{"title":"Get a single prompt's metrics row","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v2/brands/{brand_id}/prompts/{prompt_id}/{region_id}","href":"/api-reference/prompts/get-a-single-prompts-metrics-row"},{"title":"Prompt-level visibility (aggregate + time series)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v2/brands/{brand_id}/prompts/{prompt_id}/{region_id}/visibility","href":"/api-reference/prompts/prompt-level-visibility-aggregate-+-time-series"},{"title":"Prompt-level share of voice (aggregate + time series)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v2/brands/{brand_id}/prompts/{prompt_id}/{region_id}/share_of_voice","href":"/api-reference/prompts/prompt-level-share-of-voice-aggregate-+-time-series"},{"title":"Prompt-level sentiment (aggregate + time series)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v2/brands/{brand_id}/prompts/{prompt_id}/{region_id}/sentiment","href":"/api-reference/prompts/prompt-level-sentiment-aggregate-+-time-series"},{"title":"Prompt-level average position (aggregate + time series)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v2/brands/{brand_id}/prompts/{prompt_id}/{region_id}/average_position","href":"/api-reference/prompts/prompt-level-average-position-aggregate-+-time-series"}]},{"group":"Citations","pages":[{"title":"Most-cited domains","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v2/brands/{brand_id}/citations/domains","href":"/api-reference/citations/most-cited-domains"},{"title":"Domain-level share overview (citation/mention series + type breakdown)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v2/brands/{brand_id}/citations/domains/overview","href":"/api-reference/citations/domain-level-share-overview-citationmention-series-+-type-breakdown"},{"title":"Most-cited pages","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v2/brands/{brand_id}/citations/pages","href":"/api-reference/citations/most-cited-pages"},{"title":"Page-level share overview (citation/mention series + page-type breakdown)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v2/brands/{brand_id}/citations/pages/overview","href":"/api-reference/citations/page-level-share-overview-citationmention-series-+-page-type-breakdown"},{"title":"Citations overview (summary stats, distributions, top growing)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v2/brands/{brand_id}/citations/overview","href":"/api-reference/citations/citations-overview-summary-stats-distributions-top-growing"},{"title":"Citation summary by domain type","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v2/brands/{brand_id}/citations/summary","href":"/api-reference/citations/citation-summary-by-domain-type"},{"title":"Owned-citation share time series","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v2/brands/{brand_id}/citations/citation_share","href":"/api-reference/citations/owned-citation-share-time-series"},{"title":"Brand-mention share time series","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v2/brands/{brand_id}/citations/mention_share","href":"/api-reference/citations/brand-mention-share-time-series"}]},{"group":"Competitors","pages":[{"title":"List tracked competitors","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v2/brands/{brand_id}/competitors","href":"/api-reference/competitors/list-tracked-competitors"},{"title":"Track a competitor directly","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v2/brands/{brand_id}/competitors","href":"/api-reference/competitors/track-a-competitor-directly"},{"title":"Untrack a competitor","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/v2/brands/{brand_id}/competitors/{competitor_id}","href":"/api-reference/competitors/untrack-a-competitor"}]},{"group":"Competitor Suggestions","pages":[{"title":"List pending suggestions (last week, ranked by visibility)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v2/brands/{brand_id}/competitor_suggestions","href":"/api-reference/competitor-suggestions/list-pending-suggestions-last-week-ranked-by-visibility"},{"title":"Reject a suggestion","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/v2/brands/{brand_id}/competitor_suggestions/{suggestion_id}","href":"/api-reference/competitor-suggestions/reject-a-suggestion"},{"title":"Accept a suggestion and track the competitor","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v2/brands/{brand_id}/competitor_suggestions/{suggestion_id}/accept","href":"/api-reference/competitor-suggestions/accept-a-suggestion-and-track-the-competitor"}]},{"group":"Ads","pages":[{"title":"List ads (distinct creatives) running on a brand's prompts","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v2/brands/{brand_id}/ads","href":"/api-reference/ads/list-ads-distinct-creatives-running-on-a-brands-prompts"},{"title":"Ad-visibility breakdown by dimension","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v2/brands/{brand_id}/ads/breakdown","href":"/api-reference/ads/ad-visibility-breakdown-by-dimension"},{"title":"Single ad detail (with copy)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v2/brands/{brand_id}/ads/{ad_id}","href":"/api-reference/ads/single-ad-detail-with-copy"}]},{"group":"Advertisers","pages":[{"title":"List advertisers running ads on a brand's prompts","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v2/brands/{brand_id}/advertisers","href":"/api-reference/advertisers/list-advertisers-running-ads-on-a-brands-prompts"},{"title":"Advertiser summary","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v2/brands/{brand_id}/advertisers/{advertiser_id}","href":"/api-reference/advertisers/advertiser-summary"},{"title":"Ads an advertiser ran","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v2/brands/{brand_id}/advertisers/{advertiser_id}/ads","href":"/api-reference/advertisers/ads-an-advertiser-ran"}]},{"group":"Filters","pages":[{"title":"List available regions with their ids and country codes","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v2/regions","href":"/api-reference/filters/list-available-regions-with-their-ids-and-country-codes"}]},{"group":"ContentStudio","pages":[{"title":"List content recommendations","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v2/brands/{brand_id}/content_studio/recommendations","href":"/api-reference/contentstudio/list-content-recommendations"},{"title":"List content briefs","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v2/brands/{brand_id}/content_studio/briefs","href":"/api-reference/contentstudio/list-content-briefs"},{"title":"Create a custom brief (triggers async brief generation)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v2/brands/{brand_id}/content_studio/briefs","href":"/api-reference/contentstudio/create-a-custom-brief-triggers-async-brief-generation"},{"title":"Show one brief","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v2/brands/{brand_id}/content_studio/briefs/{id}","href":"/api-reference/contentstudio/show-one-brief"},{"title":"Soft-delete a brief","description":null,"deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/v2/brands/{brand_id}/content_studio/briefs/{id}","href":"/api-reference/contentstudio/soft-delete-a-brief"},{"title":"Rename a content brief","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /api/v2/brands/{brand_id}/content_studio/briefs/{id}","href":"/api-reference/contentstudio/rename-a-content-brief"},{"title":"Trigger async article generation from the finalized brief","description":null,"deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v2/brands/{brand_id}/content_studio/briefs/{id}/generate_article","href":"/api-reference/contentstudio/trigger-async-article-generation-from-the-finalized-brief"},{"title":"Show one article","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v2/brands/{brand_id}/content_studio/articles/{id}","href":"/api-reference/contentstudio/show-one-article"},{"title":"Update an article's content","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /api/v2/brands/{brand_id}/content_studio/articles/{id}","href":"/api-reference/contentstudio/update-an-articles-content"},{"title":"Soft-delete an article","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/v2/brands/{brand_id}/content_studio/articles/{id}","href":"/api-reference/contentstudio/soft-delete-an-article"},{"title":"Get the brand's content guideline document","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v2/brands/{brand_id}/content_studio/brand_guidelines","href":"/api-reference/contentstudio/get-the-brands-content-guideline-document"},{"title":"Update one or more sections of the brand guidelines","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /api/v2/brands/{brand_id}/content_studio/brand_guidelines","href":"/api-reference/contentstudio/update-one-or-more-sections-of-the-brand-guidelines"},{"title":"List a brand's feed leads (paginated, newest-first)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v2/brands/{brand_id}/content_studio/feed_leads","href":"/api-reference/contentstudio/list-a-brands-feed-leads-paginated-newest-first"}]},{"group":"Opportunities","pages":[{"title":"List opportunities for a brand (filterable, paginated, sortable)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v2/brands/{brand_id}/opportunities","href":"/api-reference/opportunities/list-opportunities-for-a-brand-filterable-paginated-sortable"},{"title":"Detail payload for a single opportunity","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v2/brands/{brand_id}/opportunities/{id}","href":"/api-reference/opportunities/detail-payload-for-a-single-opportunity"},{"title":"Replace the opportunity's strategy-list memberships (multi-list)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /api/v2/brands/{brand_id}/opportunities/{id}/lists","href":"/api-reference/opportunities/replace-the-opportunitys-strategy-list-memberships-multi-list"},{"title":"Current compute-worker state + daily quota snapshot","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v2/brands/{brand_id}/opportunities/compute","href":"/api-reference/opportunities/current-compute-worker-state-+-daily-quota-snapshot"},{"title":"Enqueue a per-brand opportunity recompute","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v2/brands/{brand_id}/opportunities/compute","href":"/api-reference/opportunities/enqueue-a-per-brand-opportunity-recompute"}]},{"group":"Opportunity Lists","pages":[{"title":"List the brand's strategy lists","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v2/brands/{brand_id}/opportunity_lists","href":"/api-reference/opportunity-lists/list-the-brands-strategy-lists"},{"title":"Create a new strategy list","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v2/brands/{brand_id}/opportunity_lists","href":"/api-reference/opportunity-lists/create-a-new-strategy-list"},{"title":"Delete a strategy list","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/v2/brands/{brand_id}/opportunity_lists/{id}","href":"/api-reference/opportunity-lists/delete-a-strategy-list"},{"title":"Rename / recolor / reorder a strategy list","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /api/v2/brands/{brand_id}/opportunity_lists/{id}","href":"/api-reference/opportunity-lists/rename-recolor-reorder-a-strategy-list"}]},{"group":"BrandActions","pages":[{"title":"List this week's open decision cards","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v2/brands/{brand_id}/weekly_actions","href":"/api-reference/brandactions/list-this-weeks-open-decision-cards"},{"title":"The card's evidence pane — generic blocks behind the one-line description","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v2/brands/{brand_id}/weekly_actions/{action_id}/details","href":"/api-reference/brandactions/the-cards-evidence-pane-—-generic-blocks-behind-the-one-line-description"},{"title":"Dismiss an action (the (type, source) pair never returns)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v2/brands/{brand_id}/weekly_actions/{action_id}/dismiss","href":"/api-reference/brandactions/dismiss-an-action-the-type-source-pair-never-returns"},{"title":"Complete an action (informational cards' \"Got it\")","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v2/brands/{brand_id}/weekly_actions/{action_id}/complete","href":"/api-reference/brandactions/complete-an-action-informational-cards-\"got-it\""},{"title":"Snooze an action to next week (\"Later\")","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v2/brands/{brand_id}/weekly_actions/{action_id}/snooze","href":"/api-reference/brandactions/snooze-an-action-to-next-week-\"later\""},{"title":"Restore a snoozed or dismissed action back onto the deck","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v2/brands/{brand_id}/weekly_actions/{action_id}/restore","href":"/api-reference/brandactions/restore-a-snoozed-or-dismissed-action-back-onto-the-deck"}]},{"group":"WeeklyTasks","pages":[{"title":"List this week's tasks — work in motion and work done","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v2/brands/{brand_id}/weekly_tasks","href":"/api-reference/weeklytasks/list-this-weeks-tasks-—-work-in-motion-and-work-done"}]},{"group":"Technical audit","pages":[{"title":"Technical audit summary for one domain: counts, the top problems to fix, and any run in progress","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v2/brands/{brand_id}/technical_audit","href":"/api-reference/technical-audit/technical-audit-summary-for-one-domain:-counts-the-top-problems-to-fix-and-any-run-in-progress"},{"title":"Start a technical audit on one domain; uses the monthly audit quota, then poll the summary until running is null","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v2/brands/{brand_id}/technical_audit","href":"/api-reference/technical-audit/start-a-technical-audit-on-one-domain;-uses-the-monthly-audit-quota-then-poll-the-summary-until-running-is-null"},{"title":"List the websites the brand can audit, with each one's latest technical audit","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v2/brands/{brand_id}/technical_audit/domains","href":"/api-reference/technical-audit/list-the-websites-the-brand-can-audit-with-each-ones-latest-technical-audit"},{"title":"Add a website to audit (any site, e.g. a docs or regional site) without making it a brand domain","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v2/brands/{brand_id}/technical_audit/domains","href":"/api-reference/technical-audit/add-a-website-to-audit-any-site-eg-a-docs-or-regional-site-without-making-it-a-brand-domain"},{"title":"Every check of a domain's latest technical audit, with what was found and how to fix it","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v2/brands/{brand_id}/technical_audit/checks","href":"/api-reference/technical-audit/every-check-of-a-domains-latest-technical-audit-with-what-was-found-and-how-to-fix-it"},{"title":"Pages a technical audit check flagged, most important first, with each page's fix","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v2/brands/{brand_id}/technical_audit/checks/{check_key}/pages","href":"/api-reference/technical-audit/pages-a-technical-audit-check-flagged-most-important-first-with-each-pages-fix"}]}]},{"tab":"MCP","pages":[{"title":"MCP","href":"/mcp/overview"}]}]},"basePath":"","title":"Rename a content brief - Cognizo Docs","buildId":"dpl_345ReqzYaAjzS9QpeJemsKdb7KDj","deploymentId":"dpl_345ReqzYaAjzS9QpeJemsKdb7KDj","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-C8RPHPxo.js","utils-0BK-9q6z.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DfjzsUJT.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-B4v9psJ4.js","snippetPresets-CpTQv-Ez.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-BNP-Fvr0.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BSgu6h1D.js","shallow-Biv1i9Gs.js","getApiPlaygroundDisplay-BoGOXhtF.js","CodeSnippet-DvQoT18_.js","CodeSnippets-Dnpa15xT.js","Page-Buji1S4J.js","getPastedJson-xAIyhUFE.js","icon-S6FBih11.js","MethodPill-SaYeUZyk.js","DuplicateIcon-Cs-p3v2Q.js","createIcon-DjCFEoHq.js","DynamicMarkdown-BcnBltEQ.js","SectionHeading-BUBl0eEF.js","axios-vUo_bRtp.js","Markdown-h4cOoD8d.js","clsx-B2v50t8t.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-DJnKvr0g.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BHrrjR1K.js"]}