{"components":{"headers":{"RateLimit":{"description":"Remaining quota `r` and seconds `t` until the window resets, for example `\"org\";r=57;t=30`. Sent when the request was counted against your organization's limit.","schema":{"type":"string"}},"RateLimit-Limit":{"description":"Requests allowed per window. Sent when the request was counted against your organization's limit.","schema":{"minimum":0,"type":"integer"}},"RateLimit-Policy":{"description":"The quota this request counts against, for example `\"org\";q=120;w=60`: `q` requests per `w`-second fixed window, shared by every API key and agent token in your organization. Sent when the request was counted against your organization's limit.","schema":{"type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window. Sent when the request was counted against your organization's limit.","schema":{"minimum":0,"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets. Sent when the request was counted against your organization's limit.","schema":{"minimum":0,"type":"integer"}},"Retry-After":{"description":"Seconds to wait before retrying, on a per-organization rate-limit 429. Allowance-exhaustion 429s carry no Retry-After; do not retry those.","schema":{"minimum":0,"type":"integer"}}},"schemas":{"ArticleElement":{"description":"The article elements a spec can require, allow or turn off.","enum":["citations","stats","key_takeaways","quotes","faq","comparison_table","steps","toc","relevant_links","products"],"title":"ArticleElement","type":"string"},"ArticleHeadingRole":{"enum":["introduction","overview","entry","step","comparison","conclusion"],"title":"ArticleHeadingRole","type":"string"},"ArticleReadingLevel":{"description":"The reader the article is written for.","enum":["beginner","practitioner","executive"],"title":"ArticleReadingLevel","type":"string"},"ArticleSourceOrigin":{"description":"Who supplied a cited source of a v2 article (public ``origin``).","enum":["research","supplied"],"title":"ArticleSourceOrigin","type":"string"},"ArticleSpec":{"additionalProperties":false,"description":"What the article must contain, may contain, or must leave out.\n\nEvery key is optional and an absent key takes its default, so ``{}`` asks\nfor nothing beyond the standard article. ``elements`` names only the\nelements you change; the rest keep their defaults (citations, stats, key\ntakeaways, quotes, FAQ, relevant links and products optional; comparison\ntable, steps and table of contents off). Citations cannot be off; steps\nand comparison tables accept required, optional and off.\n\n``elements`` wins over a detail section: an element set to ``off`` ignores\nits details (``faq.questions``, ``products``, ``relevant_links``, ``stats``),\nwhich are kept so switching the element back on restores them. For\nproducts and relevant links, the element mode is only the default for new\nitems; each item's own ``requirement`` is what applies while the element is\non. ``reading_level.requirement: off`` means the level is not judged, the\nsame as leaving ``level`` empty.","properties":{"citations":{"$ref":"#/components/schemas/CitationsSpec"},"elements":{"additionalProperties":{"$ref":"#/components/schemas/ElementRequirement"},"description":"Per-element mode for the elements you change (sparse).","propertyNames":{"$ref":"#/components/schemas/ArticleElement"},"title":"Elements","type":"object"},"faq":{"$ref":"#/components/schemas/FaqSpec"},"length":{"$ref":"#/components/schemas/LengthSpec"},"products":{"items":{"$ref":"#/components/schemas/ProductSpec"},"maxItems":10,"title":"Products","type":"array"},"reading_level":{"$ref":"#/components/schemas/ReadingLevelSpec"},"relevant_links":{"items":{"$ref":"#/components/schemas/RelevantLinkSpec"},"maxItems":10,"title":"Relevant Links","type":"array"},"schema_version":{"const":1,"default":1,"title":"Schema Version","type":"integer"},"stats":{"$ref":"#/components/schemas/StatsSpec"},"voice":{"$ref":"#/components/schemas/VoiceSpec"}},"title":"ArticleSpec","type":"object"},"ArticleTemplateKey":{"enum":["standard","listicle","how_to","comparison"],"title":"ArticleTemplateKey","type":"string"},"ArticleTemplatePage":{"properties":{"has_more":{"title":"Has More","type":"boolean"},"items":{"items":{"$ref":"#/components/schemas/ArticleTemplateRecord"},"title":"Items","type":"array"},"limit":{"title":"Limit","type":"integer"},"offset":{"title":"Offset","type":"integer"}},"required":["items","has_more","offset","limit"],"title":"ArticleTemplatePage","type":"object"},"ArticleTemplateRecord":{"additionalProperties":false,"properties":{"archived":{"default":false,"title":"Archived","type":"boolean"},"article_spec":{"additionalProperties":true,"type":"object"},"base_key":{"$ref":"#/components/schemas/ArticleTemplateKey"},"created_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Created At"},"default_target_words":{"default":1500,"maximum":10000,"minimum":100,"title":"Default Target Words","type":"integer"},"id":{"anyOf":[{"$ref":"#/components/schemas/ArticleTemplateKey"},{"format":"uuid","type":"string"}],"title":"Id"},"name":{"maxLength":120,"minLength":1,"pattern":"^\\S(?:[^\\r\\n]*\\S)?$","title":"Name","type":"string"},"outline_skeleton":{"items":{"$ref":"#/components/schemas/ArticleHeadingRole"},"maxItems":100,"title":"Outline Skeleton","type":"array"},"structure":{"$ref":"#/components/schemas/ArticleTemplateStructure"},"updated_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Updated At"}},"required":["base_key","outline_skeleton","name","id"],"title":"ArticleTemplateRecord","type":"object"},"ArticleTemplateStructure":{"additionalProperties":false,"description":"Deterministic shape parameters; never instructions or heading prose.","properties":{"minimum_entries":{"default":0,"maximum":100,"minimum":0,"title":"Minimum Entries","type":"integer"},"numbered_entry_headings":{"default":false,"title":"Numbered Entry Headings","type":"boolean"},"required_heading_roles":{"default":[],"items":{"$ref":"#/components/schemas/ArticleHeadingRole"},"title":"Required Heading Roles","type":"array"}},"title":"ArticleTemplateStructure","type":"object"},"ArticleV2ReviewReason":{"description":"Why a v2 run or draft needs a person.","enum":["held_for_review","review_expired","checker_review_hold"],"title":"ArticleV2ReviewReason","type":"string"},"BrandGuidelinesSummary":{"additionalProperties":false,"properties":{"audience_notes":{"anyOf":[{"maxLength":400,"type":"string"},{"type":"null"}],"title":"Audience Notes"},"category":{"const":"brand_guidelines","default":"brand_guidelines","title":"Category","type":"string"},"example_sentences_off_brand":{"default":[],"items":{"maxLength":300,"minLength":1,"type":"string"},"maxItems":8,"title":"Example Sentences Off Brand","type":"array"},"example_sentences_on_brand":{"default":[],"items":{"maxLength":300,"minLength":1,"type":"string"},"maxItems":8,"title":"Example Sentences On Brand","type":"array"},"formatting_rules":{"default":[],"items":{"maxLength":200,"minLength":1,"type":"string"},"maxItems":10,"title":"Formatting Rules","type":"array"},"terminology":{"default":[],"items":{"$ref":"#/components/schemas/BrandTerm"},"maxItems":20,"title":"Terminology","type":"array"},"tone_rules":{"default":[],"items":{"maxLength":200,"minLength":1,"type":"string"},"maxItems":10,"title":"Tone Rules","type":"array"},"voice_descriptors":{"items":{"maxLength":80,"minLength":1,"type":"string"},"maxItems":10,"minItems":1,"title":"Voice Descriptors","type":"array"},"words_to_avoid":{"default":[],"items":{"maxLength":60,"minLength":1,"type":"string"},"maxItems":30,"title":"Words To Avoid","type":"array"},"words_to_use":{"default":[],"items":{"maxLength":60,"minLength":1,"type":"string"},"maxItems":30,"title":"Words To Use","type":"array"}},"required":["voice_descriptors"],"title":"BrandGuidelinesSummary","type":"object"},"BrandProjectionFields":{"additionalProperties":false,"properties":{"description":{"maxLength":24000,"minLength":1,"pattern":"\\S","title":"Description","type":"string"},"mission_statement":{"maxLength":24000,"minLength":1,"pattern":"\\S","title":"Mission Statement","type":"string"},"name":{"maxLength":255,"minLength":1,"pattern":"\\S","title":"Name","type":"string"},"personality_traits":{"items":{"maxLength":255,"minLength":1,"pattern":"\\S","type":"string"},"maxItems":32,"title":"Personality Traits","type":"array"},"tagline":{"maxLength":24000,"minLength":1,"pattern":"\\S","title":"Tagline","type":"string"},"voice_directive":{"maxLength":24000,"minLength":1,"pattern":"\\S","title":"Voice Directive","type":"string"}},"title":"BrandProjectionFields","type":"object"},"BrandProjectionParams":{"additionalProperties":false,"properties":{"expected_revision":{"minimum":0,"title":"Expected Revision","type":"integer"},"fields":{"$ref":"#/components/schemas/BrandProjectionFields"},"source":{"$ref":"#/components/schemas/BrandProjectionSource"},"website_url":{"format":"uri","maxLength":2083,"minLength":1,"title":"Website Url","type":"string"}},"required":["website_url","expected_revision","source","fields"],"title":"BrandProjectionParams","type":"object"},"BrandProjectionResult":{"properties":{"applied":{"title":"Applied","type":"boolean"},"brand_id":{"format":"uuid","title":"Brand Id","type":"string"},"changes":{"additionalProperties":true,"title":"Changes","type":"object"},"fields":{"additionalProperties":true,"title":"Fields","type":"object"},"receipt_id":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Receipt Id"},"revision":{"title":"Revision","type":"integer"},"rollback_receipt_id":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Rollback Receipt Id"},"source":{"anyOf":[{"$ref":"#/components/schemas/BrandProjectionSource"},{"type":"null"}]},"website_url":{"title":"Website Url","type":"string"}},"required":["brand_id","revision","website_url","source","fields","changes","receipt_id","applied"],"title":"BrandProjectionResult","type":"object"},"BrandProjectionRollbackParams":{"additionalProperties":false,"properties":{"expected_revision":{"minimum":0,"title":"Expected Revision","type":"integer"},"receipt_id":{"format":"uuid","title":"Receipt Id","type":"string"},"website_url":{"format":"uri","maxLength":2083,"minLength":1,"title":"Website Url","type":"string"}},"required":["website_url","expected_revision","receipt_id"],"title":"BrandProjectionRollbackParams","type":"object"},"BrandProjectionSnapshot":{"properties":{"brand_id":{"format":"uuid","title":"Brand Id","type":"string"},"fields":{"additionalProperties":true,"title":"Fields","type":"object"},"revision":{"title":"Revision","type":"integer"},"rollback_receipt_id":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Rollback Receipt Id"},"source":{"anyOf":[{"$ref":"#/components/schemas/BrandProjectionSource"},{"type":"null"}]},"website_url":{"title":"Website Url","type":"string"}},"required":["brand_id","revision","website_url","source","fields"],"title":"BrandProjectionSnapshot","type":"object"},"BrandProjectionSource":{"additionalProperties":false,"properties":{"commit":{"pattern":"^[a-f0-9]{40}$","title":"Commit","type":"string"},"path":{"maxLength":512,"minLength":1,"pattern":"^[A-Za-z0-9_./-]+$","title":"Path","type":"string"},"repository":{"pattern":"^https://github.com/[A-Za-z0-9_.-]+/[A-Za-z0-9_.-]+$","title":"Repository","type":"string"},"sha256":{"pattern":"^[a-f0-9]{64}$","title":"Sha256","type":"string"}},"required":["repository","commit","path","sha256"],"title":"BrandProjectionSource","type":"object"},"BrandSourcePolicy":{"additionalProperties":false,"properties":{"revision":{"default":0,"minimum":0,"title":"Revision","type":"integer"},"rules":{"default":[],"items":{"$ref":"#/components/schemas/ReviewedSourceRule"},"title":"Rules","type":"array"},"strict":{"default":false,"title":"Strict","type":"boolean"}},"title":"BrandSourcePolicy","type":"object"},"BrandSourcePolicyUpdate":{"additionalProperties":false,"properties":{"expected_revision":{"minimum":0,"title":"Expected Revision","type":"integer"},"rules":{"items":{"$ref":"#/components/schemas/ReviewedSourceRule"},"title":"Rules","type":"array"},"strict":{"title":"Strict","type":"boolean"}},"required":["expected_revision","strict","rules"],"title":"BrandSourcePolicyUpdate","type":"object"},"BrandTerm":{"additionalProperties":false,"description":"Controlled-vocabulary entry: preferred or avoided term + meaning.","properties":{"definition":{"maxLength":200,"minLength":1,"title":"Definition","type":"string"},"term":{"maxLength":80,"minLength":1,"title":"Term","type":"string"},"usage_note":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"title":"Usage Note"}},"required":["term","definition"],"title":"BrandTerm","type":"object"},"BrandTone":{"description":"Brand voice tone values used on brand read/write surfaces.","enum":["professional","casual","friendly","authoritative","playful","empathetic","technical","conversational"],"title":"BrandTone","type":"string"},"CaseStudyQuote":{"additionalProperties":false,"description":"A quote pulled from a case study for citation.","properties":{"attribution_name":{"anyOf":[{"maxLength":120,"type":"string"},{"type":"null"}],"title":"Attribution Name"},"attribution_role":{"anyOf":[{"maxLength":120,"type":"string"},{"type":"null"}],"title":"Attribution Role"},"text":{"maxLength":400,"minLength":1,"title":"Text","type":"string"}},"required":["text"],"title":"CaseStudyQuote","type":"object"},"CaseStudySummary":{"additionalProperties":false,"properties":{"category":{"const":"case_study","default":"case_study","title":"Category","type":"string"},"citation_url":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"title":"Citation Url"},"customer_industry":{"anyOf":[{"maxLength":120,"type":"string"},{"type":"null"}],"title":"Customer Industry"},"customer_name":{"maxLength":160,"minLength":1,"title":"Customer Name","type":"string"},"customer_size_descriptor":{"anyOf":[{"maxLength":120,"type":"string"},{"type":"null"}],"title":"Customer Size Descriptor"},"problem":{"maxLength":600,"minLength":1,"title":"Problem","type":"string"},"products_used":{"default":[],"items":{"maxLength":160,"minLength":1,"type":"string"},"maxItems":8,"title":"Products Used","type":"array"},"qualitative_outcomes":{"default":[],"items":{"maxLength":240,"minLength":1,"type":"string"},"maxItems":8,"title":"Qualitative Outcomes","type":"array"},"quantitative_outcomes":{"default":[],"items":{"maxLength":240,"minLength":1,"type":"string"},"maxItems":8,"title":"Quantitative Outcomes","type":"array"},"quotes":{"default":[],"items":{"$ref":"#/components/schemas/CaseStudyQuote"},"maxItems":4,"title":"Quotes","type":"array"},"solution_summary":{"maxLength":800,"minLength":1,"title":"Solution Summary","type":"string"},"timeline_description":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"title":"Timeline Description"}},"required":["customer_name","problem","solution_summary"],"title":"CaseStudySummary","type":"object"},"CategoryStatus":{"description":"Status for categories.","enum":["active","archived"],"title":"CategoryStatus","type":"string"},"ChannelType":{"description":"Publishing channel/platform type.","enum":["blog","linkedin","twitter","newsletter","youtube","podcast"],"title":"ChannelType","type":"string"},"CitationMode":{"description":"Whether the published article body shows source citations.\n\n``STRUCTURED_ONLY`` (default) strips inline links to clean prose; the used\nsources are still captured as metadata. ``INLINE`` keeps the links and\nappends a ``## Sources`` section.","enum":["structured_only","inline"],"title":"CitationMode","type":"string"},"CitationStyle":{"description":"How an article body shows its sources.\n\n``bottom_only`` keeps prose free of links and appends a numbered sources\nlist; ``inline_only`` keeps inline links and appends no list.","enum":["bottom_only","inline_only"],"title":"CitationStyle","type":"string"},"CitationsSpec":{"additionalProperties":false,"description":"How many distinct source URLs the article cites, and which ones.","properties":{"max_sources":{"anyOf":[{"maximum":30,"minimum":1,"type":"integer"},{"type":"null"}],"description":"Most distinct source URLs the article may cite. null uses the workspace's max citations per article.","title":"Max Sources"},"min_sources":{"anyOf":[{"maximum":30,"minimum":1,"type":"integer"},{"type":"null"}],"description":"Fewest distinct source URLs the article must cite when citations are required. null means 1. At most max_sources.","title":"Min Sources"},"required_source_urls":{"description":"Sources the article must cite at least once. Each must also be in the brief's source_urls.","items":{"type":"string"},"maxItems":10,"title":"Required Source Urls","type":"array"}},"title":"CitationsSpec","type":"object"},"ClerkOrganizationRole":{"description":"Canonical Clerk organization roles used by backend APIs.","enum":["org:admin","org:member"],"title":"ClerkOrganizationRole","type":"string"},"ContentCreateIntent":{"description":"A kit client requests writer admission before committing a slot.","enum":["kit"],"title":"ContentCreateIntent","type":"string"},"ContentFormat":{"description":"Output format for content generation.","enum":["blog_post","landing_page","linkedin_post","linkedin_article","twitter_post","twitter_thread","newsletter","video_script","podcast_outline","case_study","whitepaper","ebook","infographic","webinar","email_sequence"],"title":"ContentFormat","type":"string"},"ContentKitComponentKind":{"enum":["faq","quote","stat","sources","comparison_table","key_takeaways","steps"],"title":"ContentKitComponentKind","type":"string"},"ContentKitDecisionActor":{"description":"Who decided the kit's current status: the approval gate, a user, or\nan agent (OAuth) acting for a user.","enum":["user","gate","agent"],"title":"ContentKitDecisionActor","type":"string"},"ContentKitStatus":{"enum":["draft","needs_review","approved"],"title":"ContentKitStatus","type":"string"},"ContentKitWriteState":{"enum":["owes_write","run_active","written","no_waiting_run"],"title":"ContentKitWriteState","type":"string"},"ContentLength":{"enum":["brief","standard","in_depth"],"title":"ContentLength","type":"string"},"ContentQuality":{"enum":["quick","standard","high"],"title":"ContentQuality","type":"string"},"ContentStatus":{"description":"Lifecycle status for content entities.","enum":["active","paused","archived"],"title":"ContentStatus","type":"string"},"ContentStructure":{"enum":["how_to","framework","deep_dive","opinion"],"title":"ContentStructure","type":"string"},"ContentTone":{"enum":["confident","operational","bold"],"title":"ContentTone","type":"string"},"CustomerPersonaSummary":{"additionalProperties":false,"properties":{"category":{"const":"customer_persona","default":"customer_persona","title":"Category","type":"string"},"demographics":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"title":"Demographics"},"goals":{"default":[],"items":{"maxLength":200,"minLength":1,"type":"string"},"maxItems":8,"title":"Goals","type":"array"},"is_default":{"default":false,"title":"Is Default","type":"boolean"},"jobs_to_be_done":{"items":{"maxLength":200,"minLength":1,"type":"string"},"maxItems":8,"minItems":1,"title":"Jobs To Be Done","type":"array"},"name":{"maxLength":80,"minLength":1,"title":"Name","type":"string"},"objections":{"default":[],"items":{"maxLength":200,"minLength":1,"type":"string"},"maxItems":8,"title":"Objections","type":"array"},"pain_points":{"items":{"maxLength":200,"minLength":1,"type":"string"},"maxItems":8,"minItems":1,"title":"Pain Points","type":"array"},"preferred_channels":{"default":[],"items":{"maxLength":80,"minLength":1,"type":"string"},"maxItems":6,"title":"Preferred Channels","type":"array"},"role_or_title":{"anyOf":[{"maxLength":120,"type":"string"},{"type":"null"}],"title":"Role Or Title"},"vocabulary_examples":{"default":[],"items":{"maxLength":120,"minLength":1,"type":"string"},"maxItems":10,"title":"Vocabulary Examples","type":"array"}},"required":["name","jobs_to_be_done","pain_points"],"title":"CustomerPersonaSummary","type":"object"},"DecisionBand":{"description":"Opportunity-engine editorial routing band.","enum":["auto_brief","light_review","expert_review","reject_or_hold"],"title":"DecisionBand","type":"string"},"DecisionRole":{"description":"Role in B2B buying process.","enum":["end_user","influencer","decision_maker","economic_buyer","technical_buyer"],"title":"DecisionRole","type":"string"},"DocumentCategory":{"description":"Top-level category chosen by the user at upload time (Q6/Q7).\n\nNo automatic classification: the value here is canonical and chosen\nby the human uploader. Reclassification is delete + re-upload.","enum":["brand_guidelines","product_service","customer_persona","marketing_material","case_study","technical_spec","other"],"title":"DocumentCategory","type":"string"},"DocumentFailedStage":{"description":"Which document pipeline stage failed when ``status`` is ``failed``.\n\nUseful for stage-appropriate retry or support messaging.","enum":["extract","summarize","finalize"],"title":"DocumentFailedStage","type":"string"},"DocumentStatus":{"description":"Lifecycle states for a knowledge-library document.\n\nTypical happy path:\n``uploaded → extracting → summarizing → ready``.\n\nAny stage may transition to ``failed`` (see ``failed_stage`` for which\nstage failed). ``ready → archived`` soft-removes the document from the\nlibrary while retaining the row for audit; archived documents are\nexcluded from list and detail reads.","enum":["uploaded","extracting","summarizing","ready","failed","archived"],"title":"DocumentStatus","type":"string"},"EditorialCheckOutcome":{"description":"Per-check verdict, including never computed.","enum":["pass","fail","unknown","not_applicable"],"title":"EditorialCheckOutcome","type":"string"},"EditorialCheckRequest":{"additionalProperties":false,"properties":{"expected_base_version_id":{"format":"uuid","title":"Expected Base Version Id","type":"string"},"request_id":{"format":"uuid","title":"Request Id","type":"string"}},"required":["expected_base_version_id","request_id"],"title":"EditorialCheckRequest","type":"object"},"EditorialCheckSeverity":{"description":"Whether a failing or unknown check blocks publish.","enum":["hard","soft"],"title":"EditorialCheckSeverity","type":"string"},"EditorialCheckType":{"description":"Typed review-card check family.","enum":["brand_fit","geo_draft_score","unverified_claims","missing_sources","regulated_findings","required_coverage"],"title":"EditorialCheckType","type":"string"},"EditorialDiffResponse":{"properties":{"from_markdown":{"title":"From Markdown","type":"string"},"from_version_id":{"format":"uuid","title":"From Version Id","type":"string"},"to_markdown":{"title":"To Markdown","type":"string"},"to_version_id":{"format":"uuid","title":"To Version Id","type":"string"}},"required":["from_version_id","to_version_id","from_markdown","to_markdown"],"title":"EditorialDiffResponse","type":"object"},"EditorialEditRequest":{"additionalProperties":false,"properties":{"expected_base_version_id":{"format":"uuid","title":"Expected Base Version Id","type":"string"},"markdown_body":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Markdown Body"},"replacement":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Replacement"},"request_id":{"format":"uuid","title":"Request Id","type":"string"},"target":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target"}},"required":["expected_base_version_id","request_id"],"title":"EditorialEditRequest","type":"object"},"EditorialHeadingSection":{"properties":{"end":{"title":"End","type":"integer"},"id":{"title":"Id","type":"string"},"start":{"title":"Start","type":"integer"},"text":{"title":"Text","type":"string"},"title":{"title":"Title","type":"string"}},"required":["id","title","start","end","text"],"title":"EditorialHeadingSection","type":"object"},"EditorialJobAccepted":{"properties":{"content_item_id":{"format":"uuid","title":"Content Item Id","type":"string"},"job_id":{"format":"uuid","title":"Job Id","type":"string"},"status":{"title":"Status","type":"string"}},"required":["job_id","content_item_id","status"],"title":"EditorialJobAccepted","type":"object"},"EditorialRestoreRequest":{"additionalProperties":false,"properties":{"expected_base_version_id":{"format":"uuid","title":"Expected Base Version Id","type":"string"},"request_id":{"format":"uuid","title":"Request Id","type":"string"},"source_version_id":{"format":"uuid","title":"Source Version Id","type":"string"}},"required":["expected_base_version_id","request_id","source_version_id"],"title":"EditorialRestoreRequest","type":"object"},"EditorialReview":{"properties":{"assignment_revision":{"default":0,"title":"Assignment Revision","type":"integer"},"assignments":{"items":{"$ref":"#/components/schemas/ReviewAssignment"},"title":"Assignments","type":"array"},"body_sha256":{"title":"Body Sha256","type":"string"},"content_item_id":{"format":"uuid","title":"Content Item Id","type":"string"},"content_version_id":{"format":"uuid","title":"Content Version Id","type":"string"},"created_at":{"format":"date-time","title":"Created At","type":"string"},"decisions":{"items":{"$ref":"#/components/schemas/ReviewDecision"},"title":"Decisions","type":"array"},"id":{"format":"uuid","title":"Id","type":"string"},"is_current":{"title":"Is Current","type":"boolean"},"organization_id":{"title":"Organization Id","type":"string"},"reviewer_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reviewer Id"},"status":{"$ref":"#/components/schemas/ReviewStatus"}},"required":["id","organization_id","content_item_id","content_version_id","body_sha256","reviewer_id","status","created_at","is_current"],"title":"EditorialReview","type":"object"},"EditorialReviewCard":{"properties":{"checks":{"items":{"$ref":"#/components/schemas/EditorialReviewCheck"},"title":"Checks","type":"array"},"content_item_id":{"format":"uuid","title":"Content Item Id","type":"string"},"content_version_id":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Content Version Id"}},"required":["content_item_id","checks"],"title":"EditorialReviewCard","type":"object"},"EditorialReviewCheck":{"properties":{"body_matches":{"title":"Body Matches","type":"boolean"},"body_sha256":{"title":"Body Sha256","type":"string"},"check_type":{"$ref":"#/components/schemas/EditorialCheckType"},"computed_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Computed At"},"evidence":{"additionalProperties":true,"title":"Evidence","type":"object"},"explanation":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Explanation"},"is_current":{"title":"Is Current","type":"boolean"},"outcome":{"$ref":"#/components/schemas/EditorialCheckOutcome"},"remediation":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Remediation"},"severity":{"$ref":"#/components/schemas/EditorialCheckSeverity"}},"required":["check_type","outcome","severity","body_sha256","is_current","body_matches"],"title":"EditorialReviewCheck","type":"object"},"EditorialRewriteRequest":{"additionalProperties":false,"properties":{"allow_broader_repair":{"default":false,"title":"Allow Broader Repair","type":"boolean"},"expected_base_version_id":{"format":"uuid","title":"Expected Base Version Id","type":"string"},"instructions":{"anyOf":[{"maxLength":5000,"type":"string"},{"type":"null"}],"title":"Instructions"},"scope":{"$ref":"#/components/schemas/EditorialRewriteScope","default":"full"},"section_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Section Id"},"target_length":{"anyOf":[{"minimum":1,"type":"integer"},{"type":"null"}],"title":"Target Length"},"tone":{"anyOf":[{"maxLength":128,"type":"string"},{"type":"null"}],"title":"Tone"}},"required":["expected_base_version_id"],"title":"EditorialRewriteRequest","type":"object"},"EditorialRewriteScope":{"enum":["section","full"],"title":"EditorialRewriteScope","type":"string"},"EditorialVersionReceipt":{"properties":{"content_item_id":{"format":"uuid","title":"Content Item Id","type":"string"},"created_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Created At"},"id":{"format":"uuid","title":"Id","type":"string"},"markdown_body":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Markdown Body"},"request_id":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Request Id"},"restoration_of_version_id":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Restoration Of Version Id"},"version_number":{"title":"Version Number","type":"integer"}},"required":["id","content_item_id","version_number","markdown_body"],"title":"EditorialVersionReceipt","type":"object"},"ElementRequirement":{"description":"How strongly the brief asks for an article element.\n\n``required``: the article must contain it. ``optional``: include it when\nthe evidence supports it. ``off``: never include it.","enum":["required","optional","off"],"title":"ElementRequirement","type":"string"},"EntityStatus":{"description":"Generic status for first-class entities.","enum":["active","inactive","archived"],"title":"EntityStatus","type":"string"},"FactFetchFailure":{"additionalProperties":false,"description":"A sanitized diagnostic. An HTTP status is present only when observed.","properties":{"http_status":{"anyOf":[{"maximum":599,"minimum":100,"type":"integer"},{"type":"null"}],"title":"Http Status"},"reason":{"$ref":"#/components/schemas/FactFetchFailureReason"}},"required":["reason"],"title":"FactFetchFailure","type":"object"},"FactFetchFailureReason":{"description":"Observed reason a source read failed to yield a page for verification.","enum":["pass_deadline","timeout","transport_error","target_status","empty_body","refused_url","unreadable_response"],"title":"FactFetchFailureReason","type":"string"},"FactSourceOutcome":{"description":"What checking a supplied fact's source URL found. Only a verified URL\nis cited.","enum":["verified","no_url","unsafe_url","ineligible_url","fetch_failed","not_on_page","removed_source"],"title":"FactSourceOutcome","type":"string"},"FaqSpec":{"additionalProperties":false,"description":"Questions the article's FAQ answers first.","properties":{"questions":{"items":{"type":"string"},"maxItems":10,"title":"Questions","type":"array"}},"title":"FaqSpec","type":"object"},"FunnelStage":{"description":"Marketing funnel position.","enum":["tofu","mofu","bofu"],"title":"FunnelStage","type":"string"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"title":"Detail","type":"array"}},"title":"HTTPValidationError","type":"object"},"HumanizationUnavailableReason":{"description":"Why humanization is not available to an org right now.","enum":["release_disabled","not_configured","paused"],"title":"HumanizationUnavailableReason","type":"string"},"JobStatus":{"description":"Status of a background job.\n\nTerminal states: ``completed``, ``completed_with_errors``, ``failed``,\n``cancelled``. Active (in-progress) states: ``queued``, ``running``.\n\n``awaiting_review`` is a third class: not terminal (work may resume after a\nhuman action) and not active (no automatic progress is being made). Pollers\nshould treat it as stop-and-review rather than keep waiting for a terminal\nstatus. It is intentionally in neither ``is_terminal`` nor ``is_active``.","enum":["pending","queued","running","awaiting_review","completed","completed_with_errors","failed","cancelled"],"title":"JobStatus","type":"string"},"KitMode":{"description":"How the v2 approval gate treats the kit of one generation.","enum":["auto","hold_for_review"],"title":"KitMode","type":"string"},"KitSlotRecovery":{"description":"One returned content slot in its original period, with billing review status.","properties":{"charge_started_at":{"format":"date-time","title":"Charge Started At","type":"string"},"held_job_id":{"format":"uuid","title":"Held Job Id","type":"string"},"needs_billing_reconciliation":{"title":"Needs Billing Reconciliation","type":"boolean"},"readmitted_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Readmitted At"},"reason":{"$ref":"#/components/schemas/KitSlotRecoveryReason"},"recovered_at":{"format":"date-time","title":"Recovered At","type":"string"}},"required":["held_job_id","reason","charge_started_at","recovered_at","readmitted_at","needs_billing_reconciliation"],"title":"KitSlotRecovery","type":"object"},"KitSlotRecoveryReason":{"enum":["write_refused","attempts_exhausted"],"title":"KitSlotRecoveryReason","type":"string"},"LengthSpec":{"additionalProperties":false,"description":"How closely the article must meet the brief's target word count.","properties":{"requirement":{"$ref":"#/components/schemas/ElementRequirement","default":"optional"},"tolerance_pct":{"default":20,"maximum":50,"minimum":5,"title":"Tolerance Pct","type":"integer"}},"title":"LengthSpec","type":"object"},"MarketingAssetType":{"description":"Asset-type sub-categorization for marketing-material summaries.","enum":["email","landing_page","ad","social_post","blog_post","video_script","white_paper","other"],"title":"MarketingAssetType","type":"string"},"MarketingMaterialSummary":{"additionalProperties":false,"properties":{"asset_type":{"$ref":"#/components/schemas/MarketingAssetType"},"category":{"const":"marketing_material","default":"marketing_material","title":"Category","type":"string"},"channel":{"anyOf":[{"maxLength":80,"type":"string"},{"type":"null"}],"title":"Channel"},"ctas":{"default":[],"items":{"maxLength":120,"minLength":1,"type":"string"},"maxItems":6,"title":"Ctas","type":"array"},"exemplar_excerpts":{"items":{"maxLength":400,"minLength":1,"type":"string"},"maxItems":6,"minItems":1,"title":"Exemplar Excerpts","type":"array"},"format_notes":{"default":[],"items":{"maxLength":200,"minLength":1,"type":"string"},"maxItems":10,"title":"Format Notes","type":"array"},"key_phrases_used":{"default":[],"items":{"maxLength":120,"minLength":1,"type":"string"},"maxItems":15,"title":"Key Phrases Used","type":"array"},"primary_message":{"maxLength":400,"minLength":1,"title":"Primary Message","type":"string"},"target_audience":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"title":"Target Audience"},"title":{"maxLength":200,"minLength":1,"title":"Title","type":"string"},"voice_observations":{"default":[],"items":{"maxLength":200,"minLength":1,"type":"string"},"maxItems":8,"title":"Voice Observations","type":"array"}},"required":["asset_type","title","primary_message","exemplar_excerpts"],"title":"MarketingMaterialSummary","type":"object"},"MultiOrgScope":{"enum":["robowrite:organizations:read","robowrite:content:all_orgs","robowrite:publish:all_orgs"],"title":"MultiOrgScope","type":"string"},"MultiOrgScopePermissions":{"description":"Grant/security permissions, not quota, ownership or publication approval.","properties":{"content":{"title":"Content","type":"boolean"},"publication":{"title":"Publication","type":"boolean"}},"required":["content","publication"],"title":"MultiOrgScopePermissions","type":"object"},"OrgMember":{"description":"Organization member from Clerk.","properties":{"clerk_user_id":{"title":"Clerk User Id","type":"string"},"email":{"title":"Email","type":"string"},"first_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"First Name"},"full_name":{"title":"Full Name","type":"string"},"image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Image Url"},"last_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Name"},"role":{"$ref":"#/components/schemas/ClerkOrganizationRole"}},"required":["clerk_user_id","email","full_name","role"],"title":"OrgMember","type":"object"},"OrganizationAccess":{"properties":{"eligibility":{"$ref":"#/components/schemas/OrganizationEligibility"},"granted_scopes":{"items":{"type":"string"},"title":"Granted Scopes","type":"array"},"name":{"title":"Name","type":"string"},"operation_readiness":{"additionalProperties":{"$ref":"#/components/schemas/OrganizationOperationReadiness"},"propertyNames":{"$ref":"#/components/schemas/OrganizationOperation"},"title":"Operation Readiness","type":"object"},"organization_id":{"title":"Organization Id","type":"string"},"requires_account_check_before_work":{"const":true,"default":true,"title":"Requires Account Check Before Work","type":"boolean"},"role":{"anyOf":[{"$ref":"#/components/schemas/ClerkOrganizationRole"},{"type":"string"}],"description":"Current workspace role. Unrecognized roles do not authorize content work.","title":"Role"},"scope_permissions":{"$ref":"#/components/schemas/MultiOrgScopePermissions"},"user_id":{"title":"User Id","type":"string"},"workspace_checks":{"$ref":"#/components/schemas/WorkspaceAccessChecks"}},"required":["organization_id","name","role","eligibility","workspace_checks","user_id","granted_scopes","scope_permissions","operation_readiness"],"title":"OrganizationAccess","type":"object"},"OrganizationCard":{"properties":{"eligibility":{"$ref":"#/components/schemas/OrganizationEligibility"},"name":{"title":"Name","type":"string"},"organization_id":{"title":"Organization Id","type":"string"},"role":{"anyOf":[{"$ref":"#/components/schemas/ClerkOrganizationRole"},{"type":"string"}],"description":"Current workspace role. Unrecognized roles do not authorize content work.","title":"Role"},"workspace_checks":{"$ref":"#/components/schemas/WorkspaceAccessChecks"}},"required":["organization_id","name","role","eligibility","workspace_checks"],"title":"OrganizationCard","type":"object"},"OrganizationDiscovery":{"properties":{"granted_scopes":{"items":{"$ref":"#/components/schemas/MultiOrgScope"},"title":"Granted Scopes","type":"array"},"has_more":{"title":"Has More","type":"boolean"},"items":{"items":{"$ref":"#/components/schemas/OrganizationCard"},"title":"Items","type":"array"},"limit":{"maximum":100,"minimum":1,"title":"Limit","type":"integer"},"offset":{"minimum":0,"title":"Offset","type":"integer"},"total":{"minimum":0,"title":"Total","type":"integer"}},"required":["granted_scopes","items","total","limit","offset","has_more"],"title":"OrganizationDiscovery","type":"object"},"OrganizationEligibility":{"enum":["eligible","enterprise_policy_unproven","enterprise_identity_unproven","security_policy_unknown","role_unproven","organization_deleting","user_unavailable"],"title":"OrganizationEligibility","type":"string"},"OrganizationOperation":{"enum":["read","edit","generation","publication"],"title":"OrganizationOperation","type":"string"},"OrganizationOperationReadiness":{"description":"Advisory inspection, never an authorization receipt or a quota promise.","properties":{"missing_scopes":{"items":{"$ref":"#/components/schemas/MultiOrgScope"},"title":"Missing Scopes","type":"array"},"request_checks":{"description":"Checks still left to the actual account/resource request, as applicable to that operation. Discovery has not evaluated them; edits consume allowance only when their concrete operation does.","items":{"$ref":"#/components/schemas/OrganizationRequestCheck"},"title":"Request Checks","type":"array"},"status":{"$ref":"#/components/schemas/OrganizationReadinessStatus"},"workspace_eligibility":{"$ref":"#/components/schemas/OrganizationEligibility"}},"required":["status","workspace_eligibility","missing_scopes","request_checks"],"title":"OrganizationOperationReadiness","type":"object"},"OrganizationReadinessStatus":{"enum":["blocked","request_checks_required"],"title":"OrganizationReadinessStatus","type":"string"},"OrganizationRequestCheck":{"enum":["account","resource_ownership","allowance","service_availability","version_concurrency","publication_capability","exact_version_review","destination_policy"],"title":"OrganizationRequestCheck","type":"string"},"OrganizationSelection":{"properties":{"eligibility":{"$ref":"#/components/schemas/OrganizationEligibility"},"explicit_organization_required_on_subsequent_calls":{"const":true,"default":true,"title":"Explicit Organization Required On Subsequent Calls","type":"boolean"},"granted_scopes":{"items":{"type":"string"},"title":"Granted Scopes","type":"array"},"name":{"title":"Name","type":"string"},"operation_readiness":{"additionalProperties":{"$ref":"#/components/schemas/OrganizationOperationReadiness"},"propertyNames":{"$ref":"#/components/schemas/OrganizationOperation"},"title":"Operation Readiness","type":"object"},"organization_id":{"title":"Organization Id","type":"string"},"requires_account_check_before_work":{"const":true,"default":true,"title":"Requires Account Check Before Work","type":"boolean"},"role":{"anyOf":[{"$ref":"#/components/schemas/ClerkOrganizationRole"},{"type":"string"}],"description":"Current workspace role. Unrecognized roles do not authorize content work.","title":"Role"},"scope_permissions":{"$ref":"#/components/schemas/MultiOrgScopePermissions"},"selection_verified":{"const":true,"default":true,"title":"Selection Verified","type":"boolean"},"user_id":{"title":"User Id","type":"string"},"workspace_checks":{"$ref":"#/components/schemas/WorkspaceAccessChecks"}},"required":["organization_id","name","role","eligibility","workspace_checks","user_id","granted_scopes","scope_permissions","operation_readiness"],"title":"OrganizationSelection","type":"object"},"OtherSummary":{"additionalProperties":false,"properties":{"category":{"const":"other","default":"other","title":"Category","type":"string"},"freeform_summary":{"maxLength":1200,"minLength":1,"title":"Freeform Summary","type":"string"},"key_facts":{"items":{"maxLength":240,"minLength":1,"type":"string"},"maxItems":15,"minItems":1,"title":"Key Facts","type":"array"},"notable_excerpts":{"default":[],"items":{"maxLength":400,"minLength":1,"type":"string"},"maxItems":5,"title":"Notable Excerpts","type":"array"},"one_liner":{"maxLength":300,"minLength":1,"title":"One Liner","type":"string"},"relevant_topics":{"default":[],"items":{"maxLength":120,"minLength":1,"type":"string"},"maxItems":10,"title":"Relevant Topics","type":"array"},"title":{"maxLength":240,"minLength":1,"title":"Title","type":"string"}},"required":["title","one_liner","key_facts","freeform_summary"],"title":"OtherSummary","type":"object"},"PillarGoal":{"description":"Business goal the pillar supports.","enum":["awareness","consideration","decision","retention","advocacy"],"title":"PillarGoal","type":"string"},"PointOfView":{"enum":["you","we","neutral"],"title":"PointOfView","type":"string"},"ProductBenefit":{"additionalProperties":false,"description":"One product benefit/feature: short headline + optional detail.","properties":{"detail":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"title":"Detail"},"headline":{"maxLength":120,"minLength":1,"title":"Headline","type":"string"}},"required":["headline"],"title":"ProductBenefit","type":"object"},"ProductServiceSummary":{"additionalProperties":false,"properties":{"category":{"const":"product_service","default":"product_service","title":"Category","type":"string"},"differentiators":{"default":[],"items":{"maxLength":240,"minLength":1,"type":"string"},"maxItems":8,"title":"Differentiators","type":"array"},"key_features":{"default":[],"items":{"$ref":"#/components/schemas/ProductBenefit"},"maxItems":12,"title":"Key Features","type":"array"},"name":{"maxLength":120,"minLength":1,"title":"Name","type":"string"},"one_liner":{"maxLength":240,"minLength":1,"title":"One Liner","type":"string"},"pricing_summary":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"title":"Pricing Summary"},"primary_audience":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"title":"Primary Audience"},"proof_points":{"default":[],"items":{"maxLength":240,"minLength":1,"type":"string"},"maxItems":8,"title":"Proof Points","type":"array"},"use_cases":{"default":[],"items":{"maxLength":200,"minLength":1,"type":"string"},"maxItems":10,"title":"Use Cases","type":"array"},"value_propositions":{"items":{"$ref":"#/components/schemas/ProductBenefit"},"maxItems":8,"minItems":1,"title":"Value Propositions","type":"array"}},"required":["name","one_liner","value_propositions"],"title":"ProductServiceSummary","type":"object"},"ProductSpec":{"additionalProperties":false,"description":"A product the article should name.","properties":{"name":{"maxLength":80,"minLength":1,"title":"Name","type":"string"},"requirement":{"$ref":"#/components/schemas/ElementRequirement","default":"optional"},"usage":{"default":"","maxLength":200,"title":"Usage","type":"string"}},"required":["name"],"title":"ProductSpec","type":"object"},"PropertyPurpose":{"description":"Primary business purpose of the property.","enum":["thought_leadership","lead_generation","brand_awareness","community","support","sales_enablement"],"title":"PropertyPurpose","type":"string"},"PropertyRole":{"description":"Strategic role of property in content ecosystem.","enum":["primary","secondary","experimental"],"title":"PropertyRole","type":"string"},"PublicAccount":{"description":"Bootstrap context for the API key: org, brands, monthly quota + overage,\nand secret-free optional-action capabilities.","properties":{"brands":{"items":{"$ref":"#/components/schemas/PublicAccountBrand"},"title":"Brands","type":"array"},"capabilities":{"$ref":"#/components/schemas/PublicAccountCapabilities"},"organization":{"$ref":"#/components/schemas/PublicAccountOrganization"},"quota":{"$ref":"#/components/schemas/PublicAccountQuota"}},"required":["organization","brands","quota","capabilities"],"title":"PublicAccount","type":"object"},"PublicAccountBrand":{"description":"Slim brand ref for account bootstrap (full detail via ``GET /brands/{id}``).","properties":{"id":{"format":"uuid","title":"Id","type":"string"},"name":{"title":"Name","type":"string"},"status":{"$ref":"#/components/schemas/EntityStatus"}},"required":["id","name","status"],"title":"PublicAccountBrand","type":"object"},"PublicAccountCapabilities":{"description":"Org-level optional actions and whether each is available now.","properties":{"humanization":{"$ref":"#/components/schemas/PublicHumanizationCapability"}},"required":["humanization"],"title":"PublicAccountCapabilities","type":"object"},"PublicAccountOrganization":{"description":"Org identity bound to the authenticated API key.","properties":{"id":{"title":"Id","type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"}},"required":["id"],"title":"PublicAccountOrganization","type":"object"},"PublicAccountQuota":{"description":"Billing-period quota snapshot for public integrators.","properties":{"period_end":{"format":"date-time","title":"Period End","type":"string"},"period_start":{"format":"date-time","title":"Period Start","type":"string"},"plan_code":{"title":"Plan Code","type":"string"},"resources":{"items":{"$ref":"#/components/schemas/PublicQuotaResource"},"title":"Resources","type":"array"}},"required":["plan_code","period_start","period_end","resources"],"title":"PublicAccountQuota","type":"object"},"PublicAccountQuotaResourceType":{"description":"Monthly resources exposed on GET /account.\n\nPublic surface only: ``content``, ``topics``, ``revisions``, ``briefs``,\nand ``pillar_strategy``.","enum":["content","topics","revisions","briefs","pillar_strategy"],"title":"PublicAccountQuotaResourceType","type":"string"},"PublicArticleSource":{"description":"One research source actually cited in a generated article's final body. Projected from the version's persisted ``used_sources`` metadata (captured at generation time, link-based). ``marker`` is the 1-indexed first-appearance ordinal, so an integrator can line these up with inline citation order.","properties":{"marker":{"title":"Marker","type":"integer"},"origin":{"anyOf":[{"$ref":"#/components/schemas/ArticleSourceOrigin"},{"type":"null"}],"default":"research","description":"research: found by platform research. supplied: only facts you supplied cite this URL (its page was fetched and checked). null: unknown, for a v2 version saved before supplied-fact provenance was recorded on it whose content kit has since changed."},"source_name":{"title":"Source Name","type":"string"},"source_url":{"title":"Source Url","type":"string"}},"required":["marker","source_name","source_url"],"title":"PublicArticleSource","type":"object"},"PublicAssertionProvenance":{"description":"One generator-declared sentence→URL attribution (per-assertion provenance).\n\nCaptured at generation time from the inline-linked body before rendering,\nso it survives output modes that strip the links from the shipped\nmarkdown. On a v1 version ``sentence`` is the surface text with markdown\nlink syntax reduced to labels and whitespace collapsed — the same\nnormalization the publish-time gate applies, so a gate can match body\ncitations to this receipt by exact string comparison. On a v2 article\nversion ``sentence`` is the sentence exactly as it appears in\n``markdown_body`` (list, quote and heading markers dropped; inline links\nkept on an ``inline_only`` body; never re-spaced), so it is a substring of\nthe published body. ``sentence_index`` is the 0-based ordinal of the\nsentence span within the body; ``marker`` mirrors the first-appearance\ncitation marker of ``sources``.","properties":{"marker":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Marker"},"origin":{"anyOf":[{"$ref":"#/components/schemas/ArticleSourceOrigin"},{"type":"null"}],"default":"research"},"sentence":{"title":"Sentence","type":"string"},"sentence_index":{"title":"Sentence Index","type":"integer"},"url":{"title":"Url","type":"string"}},"required":["sentence","sentence_index","url"],"title":"PublicAssertionProvenance","type":"object"},"PublicAudience":{"description":"A brand audience (response).","properties":{"brand_id":{"format":"uuid","title":"Brand Id","type":"string"},"created_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Created At"},"decision_role":{"anyOf":[{"$ref":"#/components/schemas/DecisionRole"},{"type":"null"}]},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"goals":{"items":{"$ref":"#/components/schemas/PublicAudienceGoal"},"title":"Goals","type":"array"},"id":{"format":"uuid","title":"Id","type":"string"},"name":{"title":"Name","type":"string"},"pain_points":{"items":{"$ref":"#/components/schemas/PublicAudiencePainPoint"},"title":"Pain Points","type":"array"},"sophistication_level":{"anyOf":[{"$ref":"#/components/schemas/SophisticationLevel"},{"type":"null"}]},"status":{"$ref":"#/components/schemas/EntityStatus"},"technical_depth":{"anyOf":[{"$ref":"#/components/schemas/TechnicalDepth"},{"type":"null"}]}},"required":["id","brand_id","name","status"],"title":"PublicAudience","type":"object"},"PublicAudienceCreate":{"additionalProperties":false,"description":"Create an audience for a brand you own.","properties":{"brand_id":{"format":"uuid","title":"Brand Id","type":"string"},"decision_role":{"anyOf":[{"$ref":"#/components/schemas/DecisionRole"},{"type":"null"}]},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"goals":{"items":{"$ref":"#/components/schemas/PublicAudienceGoal"},"title":"Goals","type":"array"},"name":{"maxLength":255,"minLength":1,"title":"Name","type":"string"},"pain_points":{"items":{"$ref":"#/components/schemas/PublicAudiencePainPoint"},"title":"Pain Points","type":"array"},"sophistication_level":{"anyOf":[{"$ref":"#/components/schemas/SophisticationLevel"},{"type":"null"}]},"status":{"$ref":"#/components/schemas/EntityStatus","default":"active"},"technical_depth":{"anyOf":[{"$ref":"#/components/schemas/TechnicalDepth"},{"type":"null"}]}},"required":["brand_id","name"],"title":"PublicAudienceCreate","type":"object"},"PublicAudienceGoal":{"additionalProperties":false,"description":"A goal stored on an audience.","properties":{"goal":{"minLength":1,"title":"Goal","type":"string"},"priority":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Priority"},"timeline":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timeline"}},"required":["goal"],"title":"PublicAudienceGoal","type":"object"},"PublicAudiencePainPoint":{"additionalProperties":false,"description":"A pain point stored on an audience.","properties":{"current_solution":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Current Solution"},"pain_point":{"minLength":1,"title":"Pain Point","type":"string"},"severity":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Severity"}},"required":["pain_point"],"title":"PublicAudiencePainPoint","type":"object"},"PublicAudienceUpdate":{"additionalProperties":false,"description":"Patch an audience (only set fields are applied).","properties":{"decision_role":{"anyOf":[{"$ref":"#/components/schemas/DecisionRole"},{"type":"null"}]},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"goals":{"anyOf":[{"items":{"$ref":"#/components/schemas/PublicAudienceGoal"},"type":"array"},{"type":"null"}],"title":"Goals"},"name":{"maxLength":255,"minLength":1,"title":"Name","type":"string"},"pain_points":{"anyOf":[{"items":{"$ref":"#/components/schemas/PublicAudiencePainPoint"},"type":"array"},{"type":"null"}],"title":"Pain Points"},"sophistication_level":{"anyOf":[{"$ref":"#/components/schemas/SophisticationLevel"},{"type":"null"}]},"status":{"$ref":"#/components/schemas/EntityStatus","title":"Status"},"technical_depth":{"anyOf":[{"$ref":"#/components/schemas/TechnicalDepth"},{"type":"null"}]}},"title":"PublicAudienceUpdate","type":"object"},"PublicAuthor":{"description":"An author (response). Identity and bio only — no per-author content counts.","properties":{"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Avatar Url"},"bio":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bio"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"},"id":{"format":"uuid","title":"Id","type":"string"},"is_external":{"default":true,"title":"Is External","type":"boolean"},"name":{"title":"Name","type":"string"},"slug":{"title":"Slug","type":"string"},"status":{"$ref":"#/components/schemas/EntityStatus"}},"required":["id","name","slug","status"],"title":"PublicAuthor","type":"object"},"PublicAuthorCreate":{"additionalProperties":false,"description":"Create an author.","properties":{"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Avatar Url"},"bio":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bio"},"email":{"anyOf":[{"maxLength":255,"type":"string"},{"type":"null"}],"title":"Email"},"name":{"maxLength":255,"minLength":1,"title":"Name","type":"string"},"slug":{"anyOf":[{"maxLength":255,"minLength":1,"pattern":"^[a-z0-9-]+$","type":"string"},{"type":"null"}],"title":"Slug"}},"required":["name"],"title":"PublicAuthorCreate","type":"object"},"PublicAuthorUpdate":{"additionalProperties":false,"description":"Patch an author (only set fields are applied).\n\nExplicit ``null`` on an omit-only key (``PublicAuthorUpdateOmitOnlyField``:\nname/slug/status) returns **422**; the clearable keys\n(``PublicAuthorUpdateClearableField``: email/bio/avatar_url) may be cleared\nwith ``null``.","properties":{"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Avatar Url"},"bio":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bio"},"email":{"anyOf":[{"maxLength":255,"type":"string"},{"type":"null"}],"title":"Email"},"name":{"maxLength":255,"minLength":1,"title":"Name","type":"string"},"slug":{"maxLength":255,"minLength":1,"pattern":"^[a-z0-9-]+$","title":"Slug","type":"string"},"status":{"$ref":"#/components/schemas/EntityStatus","title":"Status"}},"title":"PublicAuthorUpdate","type":"object"},"PublicBrand":{"description":"A brand the org owns (discovery + voice read-back).\n\nBrand-scoped endpoints take a ``brand_id``. Voice fields\n(``description``, ``mission_statement``, ``tone``, ``phrases_to_avoid``,\n``dos``, ``donts``) match the allow-list that ``PATCH /brands/{brand_id}``\ncan edit, so clients can read back what they wrote.","properties":{"created_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Created At"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"donts":{"items":{"type":"string"},"title":"Donts","type":"array"},"dos":{"items":{"type":"string"},"title":"Dos","type":"array"},"id":{"format":"uuid","title":"Id","type":"string"},"industry":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Industry"},"logo_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Logo Url"},"mission_statement":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Mission Statement"},"name":{"title":"Name","type":"string"},"phrases_to_avoid":{"items":{"type":"string"},"title":"Phrases To Avoid","type":"array"},"status":{"$ref":"#/components/schemas/EntityStatus"},"tagline":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tagline"},"tone":{"$ref":"#/components/schemas/BrandTone"},"website_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Website Url"}},"required":["id","name","status","tone"],"title":"PublicBrand","type":"object"},"PublicBrandSetup":{"properties":{"brand_id":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Brand Id"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"},"job_id":{"format":"uuid","title":"Job Id","type":"string"},"setup_id":{"format":"uuid","title":"Setup Id","type":"string"},"status":{"$ref":"#/components/schemas/PublicBrandSetupStatus"},"suggestions":{"anyOf":[{"$ref":"#/components/schemas/PublicBrandSetupSuggestions"},{"type":"null"}]}},"required":["setup_id","job_id","status"],"title":"PublicBrandSetup","type":"object"},"PublicBrandSetupConfirm":{"additionalProperties":false,"description":"Reviewed edits to research suggestions. Omit a field to keep its suggestion.","properties":{"description":{"anyOf":[{"maxLength":4000,"type":"string"},{"type":"null"}],"title":"Description"},"donts":{"items":{"maxLength":300,"type":"string"},"maxItems":30,"title":"Donts","type":"array"},"dos":{"items":{"maxLength":300,"type":"string"},"maxItems":30,"title":"Dos","type":"array"},"industry":{"maxLength":100,"minLength":1,"title":"Industry","type":"string"},"mission_statement":{"anyOf":[{"maxLength":4000,"type":"string"},{"type":"null"}],"title":"Mission Statement"},"name":{"maxLength":255,"minLength":1,"title":"Name","type":"string"},"phrases_to_avoid":{"items":{"maxLength":300,"type":"string"},"maxItems":30,"title":"Phrases To Avoid","type":"array"},"tagline":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"title":"Tagline"},"tone":{"$ref":"#/components/schemas/BrandTone","title":"Tone"}},"title":"PublicBrandSetupConfirm","type":"object"},"PublicBrandSetupCreate":{"additionalProperties":false,"description":"Start research for one website without creating or changing a brand.","properties":{"website_url":{"maxLength":2048,"minLength":1,"title":"Website Url","type":"string"}},"required":["website_url"],"title":"PublicBrandSetupCreate","type":"object"},"PublicBrandSetupStarted":{"properties":{"job_id":{"format":"uuid","title":"Job Id","type":"string"},"setup_id":{"format":"uuid","title":"Setup Id","type":"string"}},"required":["setup_id","job_id"],"title":"PublicBrandSetupStarted","type":"object"},"PublicBrandSetupStatus":{"description":"Research progress; ready requires review and explicit confirmation.","enum":["pending","running","ready","failed","confirmed"],"title":"PublicBrandSetupStatus","type":"string"},"PublicBrandSetupSuggestions":{"description":"Bounded identity and voice suggestions for review.","properties":{"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"donts":{"items":{"type":"string"},"title":"Donts","type":"array"},"dos":{"items":{"type":"string"},"title":"Dos","type":"array"},"industry":{"title":"Industry","type":"string"},"mission_statement":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Mission Statement"},"name":{"title":"Name","type":"string"},"phrases_to_avoid":{"items":{"type":"string"},"title":"Phrases To Avoid","type":"array"},"tagline":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tagline"},"tone":{"$ref":"#/components/schemas/BrandTone"},"website_url":{"title":"Website Url","type":"string"}},"required":["name","industry","website_url","tone"],"title":"PublicBrandSetupSuggestions","type":"object"},"PublicBrandUpdate":{"additionalProperties":false,"description":"Partial update of a brand's voice fields.\n\nClosed allowlist: ``description``, ``tone``, ``phrases_to_avoid``,\n``donts``, ``dos``, ``mission_statement``. Unknown keys return **422**.\n\nOmitted keys are left unchanged. ``description`` and ``mission_statement``\naccept ``null`` to clear. ``tone`` and the arrays reject ``null`` (**422**);\nsend ``[]`` to clear an array. Does not regenerate an AI voice directive.","properties":{"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"donts":{"items":{"type":"string"},"title":"Donts","type":"array"},"dos":{"items":{"type":"string"},"title":"Dos","type":"array"},"mission_statement":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Mission Statement"},"phrases_to_avoid":{"items":{"type":"string"},"title":"Phrases To Avoid","type":"array"},"tone":{"$ref":"#/components/schemas/BrandTone","title":"Tone"}},"title":"PublicBrandUpdate","type":"object"},"PublicBrief":{"description":"Brief read model (response).\n\nContent and keyword fields only — lifecycle ownership metadata and deferred\nresearch inputs are not included.","properties":{"article_spec":{"$ref":"#/components/schemas/ArticleSpec"},"article_template":{"anyOf":[{"$ref":"#/components/schemas/ArticleTemplateKey"},{"format":"uuid","type":"string"},{"type":"null"}],"title":"Article Template"},"attached_document_ids":{"items":{"format":"uuid","type":"string"},"title":"Attached Document Ids","type":"array"},"audience_details":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Audience Details"},"brand_id":{"format":"uuid","title":"Brand Id","type":"string"},"competitor_urls":{"items":{"type":"string"},"title":"Competitor Urls","type":"array"},"content_goal":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Content Goal"},"content_hash_version":{"anyOf":[{"const":1,"type":"integer"},{"type":"null"}],"title":"Content Hash Version"},"content_sha256":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Content Sha256"},"created_at":{"format":"date-time","title":"Created At","type":"string"},"cta":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cta"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"example_urls":{"items":{"type":"string"},"title":"Example Urls","type":"array"},"facts":{"items":{"$ref":"#/components/schemas/PublicBriefFact"},"title":"Facts","type":"array"},"format":{"$ref":"#/components/schemas/ContentFormat"},"funnel_stage":{"anyOf":[{"$ref":"#/components/schemas/FunnelStage"},{"type":"null"}]},"id":{"format":"uuid","title":"Id","type":"string"},"linked_content":{"anyOf":[{"$ref":"#/components/schemas/PublicPage_PublicContentSummary_"},{"type":"null"}]},"must_avoid":{"items":{"type":"string"},"title":"Must Avoid","type":"array"},"must_cover":{"items":{"type":"string"},"title":"Must Cover","type":"array"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes"},"outline":{"items":{"type":"string"},"title":"Outline","type":"array"},"pillar_id":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Pillar Id"},"primary_keyword":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Primary Keyword"},"property_id":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Property Id"},"search_intent":{"anyOf":[{"$ref":"#/components/schemas/SearchIntent"},{"type":"null"}]},"secondary_keywords":{"items":{"type":"string"},"title":"Secondary Keywords","type":"array"},"source_topic_id":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Source Topic Id"},"source_urls":{"items":{"type":"string"},"title":"Source Urls","type":"array"},"status":{"$ref":"#/components/schemas/TaskStatus"},"summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Summary"},"target_word_count":{"anyOf":[{"maximum":3500,"type":"integer"},{"type":"null"}],"title":"Target Word Count"},"template_snapshot":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Template Snapshot"},"title":{"title":"Title","type":"string"},"tone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tone"},"updated_at":{"format":"date-time","title":"Updated At","type":"string"},"version_id":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Version Id"}},"required":["id","brand_id","title","format","status","created_at","updated_at"],"title":"PublicBrief","type":"object"},"PublicBriefCreate":{"additionalProperties":false,"description":"Developer-authored brief spec (request).\n\nSupply an explicit owned ``brand_id``. ``status`` is server-set. ``outline``\nis an ordered list of H2 titles; supply plain strings, not Markdown.","properties":{"article_spec":{"$ref":"#/components/schemas/ArticleSpec","description":"What the article must, may or must not contain. Omit it (or send {}) for the standard article. A required source must also be in source_urls (422 article_spec_required_source_not_in_brief)."},"article_template":{"anyOf":[{"$ref":"#/components/schemas/ArticleTemplateKey"},{"format":"uuid","type":"string"},{"type":"null"}],"title":"Article Template"},"attached_document_ids":{"description":"Document library IDs pinned to this brief for prompt-injection (AD-0075).","items":{"format":"uuid","type":"string"},"maxItems":10,"title":"Attached Document Ids","type":"array"},"audience_details":{"anyOf":[{"maxLength":5000,"type":"string"},{"type":"null"}],"title":"Audience Details"},"brand_id":{"format":"uuid","title":"Brand Id","type":"string"},"competitor_urls":{"items":{"type":"string"},"maxItems":20,"title":"Competitor Urls","type":"array"},"content_goal":{"anyOf":[{"maxLength":5000,"type":"string"},{"type":"null"}],"title":"Content Goal"},"cta":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"title":"Cta"},"description":{"anyOf":[{"maxLength":5000,"type":"string"},{"type":"null"}],"title":"Description"},"example_urls":{"description":"Inspiration-only reference URLs. Never used as source-verification input.","items":{"type":"string"},"maxItems":20,"title":"Example Urls","type":"array"},"facts":{"description":"Facts the article cites as supplied claims. Requires the v2 article pipeline (409 article_pipeline_not_v2 otherwise).","items":{"$ref":"#/components/schemas/PublicBriefFactInput"},"maxItems":20,"title":"Facts","type":"array"},"format":{"$ref":"#/components/schemas/ContentFormat","default":"blog_post"},"funnel_stage":{"anyOf":[{"$ref":"#/components/schemas/FunnelStage"},{"type":"null"}]},"must_avoid":{"items":{"type":"string"},"maxItems":20,"title":"Must Avoid","type":"array"},"must_cover":{"items":{"type":"string"},"maxItems":20,"title":"Must Cover","type":"array"},"notes":{"anyOf":[{"maxLength":5000,"type":"string"},{"type":"null"}],"title":"Notes"},"outline":{"description":"Ordered H2 titles. Mapped to structured brief sections.","items":{"type":"string"},"maxItems":20,"title":"Outline","type":"array"},"pillar_id":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Pillar Id"},"primary_keyword":{"anyOf":[{"maxLength":255,"type":"string"},{"type":"null"}],"title":"Primary Keyword"},"search_intent":{"anyOf":[{"$ref":"#/components/schemas/SearchIntent"},{"type":"null"}]},"secondary_keywords":{"items":{"type":"string"},"maxItems":20,"title":"Secondary Keywords","type":"array"},"source_topic_id":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Source Topic Id"},"source_urls":{"description":"Reference URLs threaded into generation as citable source material.","items":{"type":"string"},"maxItems":20,"title":"Source Urls","type":"array"},"summary":{"anyOf":[{"maxLength":5000,"type":"string"},{"type":"null"}],"title":"Summary"},"target_word_count":{"anyOf":[{"maximum":3500,"minimum":100,"type":"integer"},{"type":"null"}],"title":"Target Word Count"},"title":{"maxLength":500,"minLength":1,"title":"Title","type":"string"},"tone":{"anyOf":[{"$ref":"#/components/schemas/ContentTone"},{"type":"null"}]}},"required":["title","brand_id"],"title":"PublicBriefCreate","type":"object"},"PublicBriefFact":{"description":"A supplied fact on a brief (response). ``claim_id`` is the id the\nfact carries in the content kit's claims.","properties":{"attribution":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Attribution"},"claim_id":{"title":"Claim Id","type":"string"},"priority":{"$ref":"#/components/schemas/UserFactPriority","default":"normal"},"source_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Url"},"text":{"title":"Text","type":"string"}},"required":["claim_id","text"],"title":"PublicBriefFact","type":"object"},"PublicBriefFactInput":{"additionalProperties":false,"description":"A fact you supply for the article to cite (request).\n\nOne line of plain text, at most 200 characters, with no Markdown, HTML,\nlinks or ``[[``/``]]``. ``source_url`` is optional: its page is fetched\nat generation and the fact is cited to it only when the page states every\nfigure and name in the fact; otherwise the fact is used without a link\n(a regulated workspace leaves it out). A ``source_url`` the brand source\npolicy or the workspace's blocked hosts refuse is a 422\n(``user_fact_source_url_ineligible``), and workspaces with\nregulated-content settings must supply one (422\n``user_fact_source_url_required``). Generation applies these rules again\nand leaves out a fact that no longer meets them. At most 20 facts, at\nmost 5 with ``priority=must_use``.","properties":{"attribution":{"anyOf":[{"maxLength":120,"type":"string"},{"type":"null"}],"title":"Attribution"},"priority":{"$ref":"#/components/schemas/UserFactPriority","default":"normal"},"source_url":{"anyOf":[{"maxLength":2048,"type":"string"},{"type":"null"}],"title":"Source Url"},"text":{"maxLength":200,"minLength":1,"title":"Text","type":"string"}},"required":["text"],"title":"PublicBriefFactInput","type":"object"},"PublicBriefSection":{"description":"A structured section of a brief (response).","properties":{"brief_id":{"format":"uuid","title":"Brief Id","type":"string"},"created_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Created At"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"id":{"format":"uuid","title":"Id","type":"string"},"is_required":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Required"},"section_type":{"title":"Section Type","type":"string"},"sort_order":{"title":"Sort Order","type":"integer"},"source":{"title":"Source","type":"string"},"source_detail":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Source Detail"},"title":{"title":"Title","type":"string"},"updated_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Updated At"}},"required":["id","brief_id","title","section_type","source","sort_order"],"title":"PublicBriefSection","type":"object"},"PublicBriefUpdate":{"additionalProperties":false,"description":"Partial update for a developer-authored brief.\n\nEvery field is optional; only supplied fields are patched. Brand and\nstatus are not editable here. Omitting a key leaves it unchanged. An\nexplicit ``null`` clears a nullable field. ``secondary_keywords``,\n``outline``, ``must_cover``, ``must_avoid``, ``source_urls``,\n``example_urls``, ``competitor_urls``, and ``attached_document_ids`` also\naccept ``[]`` to empty the set. Editing any field that affects generation\non an already-approved brief moves its status back to ``draft`` so the\nnext generation re-enters review. Explicit ``null`` is rejected with a\n**422** on ``title`` and ``format``.","properties":{"article_spec":{"anyOf":[{"$ref":"#/components/schemas/ArticleSpec"},{"type":"null"}],"description":"Replaces the whole article spec; null resets it to the standard article. Editing it on an approved brief moves the brief back to draft."},"article_template":{"anyOf":[{"$ref":"#/components/schemas/ArticleTemplateKey"},{"format":"uuid","type":"string"},{"type":"null"}],"title":"Article Template"},"attached_document_ids":{"anyOf":[{"items":{"format":"uuid","type":"string"},"maxItems":10,"type":"array"},{"type":"null"}],"title":"Attached Document Ids"},"audience_details":{"anyOf":[{"maxLength":5000,"type":"string"},{"type":"null"}],"title":"Audience Details"},"competitor_urls":{"anyOf":[{"items":{"type":"string"},"maxItems":20,"type":"array"},{"type":"null"}],"title":"Competitor Urls"},"content_goal":{"anyOf":[{"maxLength":5000,"type":"string"},{"type":"null"}],"title":"Content Goal"},"cta":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"title":"Cta"},"description":{"anyOf":[{"maxLength":5000,"type":"string"},{"type":"null"}],"title":"Description"},"example_urls":{"anyOf":[{"items":{"type":"string"},"maxItems":20,"type":"array"},{"type":"null"}],"title":"Example Urls"},"facts":{"anyOf":[{"items":{"$ref":"#/components/schemas/PublicBriefFactInput"},"maxItems":20,"type":"array"},{"type":"null"}],"title":"Facts"},"format":{"$ref":"#/components/schemas/ContentFormat","title":"Format"},"funnel_stage":{"anyOf":[{"$ref":"#/components/schemas/FunnelStage"},{"type":"null"}]},"must_avoid":{"anyOf":[{"items":{"type":"string"},"maxItems":20,"type":"array"},{"type":"null"}],"title":"Must Avoid"},"must_cover":{"anyOf":[{"items":{"type":"string"},"maxItems":20,"type":"array"},{"type":"null"}],"title":"Must Cover"},"notes":{"anyOf":[{"maxLength":5000,"type":"string"},{"type":"null"}],"title":"Notes"},"outline":{"anyOf":[{"items":{"type":"string"},"maxItems":20,"type":"array"},{"type":"null"}],"title":"Outline"},"pillar_id":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Pillar Id"},"primary_keyword":{"anyOf":[{"maxLength":255,"type":"string"},{"type":"null"}],"title":"Primary Keyword"},"search_intent":{"anyOf":[{"$ref":"#/components/schemas/SearchIntent"},{"type":"null"}]},"secondary_keywords":{"anyOf":[{"items":{"type":"string"},"maxItems":20,"type":"array"},{"type":"null"}],"title":"Secondary Keywords"},"source_urls":{"anyOf":[{"items":{"type":"string"},"maxItems":20,"type":"array"},{"type":"null"}],"title":"Source Urls"},"summary":{"anyOf":[{"maxLength":5000,"type":"string"},{"type":"null"}],"title":"Summary"},"target_word_count":{"anyOf":[{"maximum":3500,"minimum":100,"type":"integer"},{"type":"null"}],"title":"Target Word Count"},"title":{"maxLength":500,"minLength":1,"title":"Title","type":"string"},"tone":{"anyOf":[{"$ref":"#/components/schemas/ContentTone"},{"type":"null"}]}},"title":"PublicBriefUpdate","type":"object"},"PublicCategory":{"description":"A category (response).","properties":{"brand_id":{"format":"uuid","title":"Brand Id","type":"string"},"color":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Color"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"icon":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Icon"},"id":{"format":"uuid","title":"Id","type":"string"},"name":{"title":"Name","type":"string"},"parent_id":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Parent Id"},"slug":{"title":"Slug","type":"string"},"sort_order":{"default":0,"title":"Sort Order","type":"integer"},"status":{"$ref":"#/components/schemas/CategoryStatus"},"usage_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":0,"title":"Usage Count"}},"required":["id","brand_id","name","slug","status"],"title":"PublicCategory","type":"object"},"PublicCategoryCreate":{"additionalProperties":false,"description":"Create a category.","properties":{"brand_id":{"format":"uuid","title":"Brand Id","type":"string"},"color":{"anyOf":[{"pattern":"^#[0-9A-Fa-f]{6}$","type":"string"},{"type":"null"}],"title":"Color"},"description":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"title":"Description"},"icon":{"anyOf":[{"maxLength":50,"type":"string"},{"type":"null"}],"title":"Icon"},"name":{"maxLength":100,"minLength":1,"title":"Name","type":"string"},"parent_id":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Parent Id"},"slug":{"anyOf":[{"maxLength":100,"minLength":1,"pattern":"^[a-z0-9-]+$","type":"string"},{"type":"null"}],"title":"Slug"},"sort_order":{"default":0,"title":"Sort Order","type":"integer"}},"required":["brand_id","name"],"title":"PublicCategoryCreate","type":"object"},"PublicCategoryUpdate":{"additionalProperties":false,"description":"Patch a category (only set fields are applied).\n\nExplicit ``null`` on an omit-only key\n(``PublicCategoryUpdateOmitOnlyField``: name/slug/sort_order/status)\nreturns **422**; the clearable keys\n(``PublicCategoryUpdateClearableField``: description/parent_id/icon/color)\nmay be cleared with ``null``.","properties":{"color":{"anyOf":[{"pattern":"^#[0-9A-Fa-f]{6}$","type":"string"},{"type":"null"}],"title":"Color"},"description":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"title":"Description"},"icon":{"anyOf":[{"maxLength":50,"type":"string"},{"type":"null"}],"title":"Icon"},"name":{"maxLength":100,"minLength":1,"title":"Name","type":"string"},"parent_id":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Parent Id"},"slug":{"maxLength":100,"minLength":1,"pattern":"^[a-z0-9-]+$","title":"Slug","type":"string"},"sort_order":{"title":"Sort Order","type":"integer"},"status":{"$ref":"#/components/schemas/CategoryStatus","title":"Status"}},"title":"PublicCategoryUpdate","type":"object"},"PublicComplianceFinding":{"description":"One regulated-content policy finding on a content version.\n\nPresent when the org configures regulated industries and the detail\nrequest includes ``?include=compliance``. ``kind`` is a stable enum\n(``unsourced_figure``, ``advice_tone``, ``off_brand_promotion``,\n``missing_disclaimer``) so clients can branch without parsing\n``message``. ``excerpt`` is the offending body span for text findings,\nor null for structural findings such as ``missing_disclaimer``.","properties":{"excerpt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Excerpt"},"kind":{"$ref":"#/components/schemas/RegulatedPolicyFindingKind"},"message":{"title":"Message","type":"string"}},"required":["kind","message"],"title":"PublicComplianceFinding","type":"object"},"PublicContentItem":{"description":"A content item plus a page of its versions (download).\n\n``versions`` is a ``PublicPage`` envelope (not a bare list). Default window\nis newest-first with ``limit``/``offset`` on the GET; use ``latest_only`` /\n``version`` to pin without paging the full history.","properties":{"author_id":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Author Id"},"brand_id":{"format":"uuid","title":"Brand Id","type":"string"},"brief_id":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Brief Id"},"created_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Created At"},"failed_draft_archived_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"description":"Archived after 30 days with no saved version. Restore this item by ID to list it again.","title":"Failed Draft Archived At"},"format":{"anyOf":[{"$ref":"#/components/schemas/ContentFormat"},{"type":"null"}]},"id":{"format":"uuid","title":"Id","type":"string"},"latest_attempt":{"anyOf":[{"$ref":"#/components/schemas/PublicJobSummary"},{"type":"null"}]},"latest_version":{"anyOf":[{"$ref":"#/components/schemas/PublicContentVersionSummary"},{"type":"null"}]},"pillar_id":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Pillar Id"},"property_id":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Property Id"},"published_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Published Url"},"slug":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Slug"},"source_topic_id":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Source Topic Id"},"status":{"$ref":"#/components/schemas/TaskStatus"},"title":{"title":"Title","type":"string"},"updated_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Updated At"},"version_count":{"default":0,"minimum":0,"title":"Version Count","type":"integer"},"versions":{"$ref":"#/components/schemas/PublicPage_PublicContentVersion_"}},"required":["id","title","status","brand_id","versions"],"title":"PublicContentItem","type":"object"},"PublicContentItemCreate":{"additionalProperties":false,"description":"Bind a brief to a publishing property (request).\n\n``property_id`` is required — the caller chooses the publication target.","properties":{"brief_id":{"format":"uuid","title":"Brief Id","type":"string"},"expected_brief_content_sha256":{"pattern":"^[0-9a-f]{64}$","title":"Expected Brief Content Sha256","type":"string"},"expected_brief_version_id":{"format":"uuid","title":"Expected Brief Version Id","type":"string"},"format":{"$ref":"#/components/schemas/ContentFormat","default":"blog_post"},"intent":{"anyOf":[{"$ref":"#/components/schemas/ContentCreateIntent"},{"type":"null"}],"description":"Send kit when creating an item for kit generation to check writer readiness before consuming a slot."},"property_id":{"format":"uuid","title":"Property Id","type":"string"},"title":{"maxLength":500,"minLength":1,"title":"Title","type":"string"}},"required":["brief_id","property_id","title"],"title":"PublicContentItemCreate","type":"object"},"PublicContentItemDetail":{"description":"A content item without version bodies (list/create/patch response).\n\nFor full version payloads use the content download endpoints that return\n``versions[]``.","properties":{"brand_id":{"format":"uuid","title":"Brand Id","type":"string"},"brief_id":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Brief Id"},"created_at":{"format":"date-time","title":"Created At","type":"string"},"format":{"$ref":"#/components/schemas/ContentFormat"},"id":{"format":"uuid","title":"Id","type":"string"},"property_id":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Property Id"},"published_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Published Url"},"slug":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Slug"},"status":{"$ref":"#/components/schemas/TaskStatus"},"title":{"title":"Title","type":"string"},"updated_at":{"format":"date-time","title":"Updated At","type":"string"}},"required":["id","brand_id","format","title","status","created_at","updated_at"],"title":"PublicContentItemDetail","type":"object"},"PublicContentItemUpdate":{"additionalProperties":false,"description":"Partial update for a content item.\n\nEvery field is optional; omitting a key leaves it unchanged. Unknown keys\nreturn **422**. Explicit ``null`` on omit-only keys\n(``PublicContentItemUpdateOmitOnlyField``: title/format/status/author_id/slug)\nreturns **422**; ``published_url``\n(``PublicContentItemUpdateClearableField``) may be cleared with ``null``.","properties":{"author_id":{"format":"uuid","title":"Author Id","type":"string"},"format":{"$ref":"#/components/schemas/ContentFormat","title":"Format"},"published_url":{"anyOf":[{"maxLength":2048,"type":"string"},{"type":"null"}],"title":"Published Url"},"slug":{"minLength":1,"title":"Slug","type":"string"},"status":{"$ref":"#/components/schemas/TaskStatus","title":"Status"},"title":{"maxLength":500,"minLength":1,"title":"Title","type":"string"}},"title":"PublicContentItemUpdate","type":"object"},"PublicContentKit":{"description":"The content kit of a content item.\n\n``kit_revision`` changes on every save; send it back as\n``expected_kit_revision`` (or the ``Expected-Kit-Revision`` header on a\nDELETE) so a write never overwrites a newer kit (409 when stale).\n``status=needs_review`` holds the article until the kit is approved.","properties":{"auto_approved":{"default":false,"title":"Auto Approved","type":"boolean"},"brief_id":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Brief Id"},"claims":{"items":{"$ref":"#/components/schemas/PublicKitClaim"},"title":"Claims","type":"array"},"components":{"items":{"$ref":"#/components/schemas/PublicKitComponent"},"title":"Components","type":"array"},"content_item_id":{"format":"uuid","title":"Content Item Id","type":"string"},"decided_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Decided At"},"decided_by":{"anyOf":[{"$ref":"#/components/schemas/ContentKitDecisionActor"},{"type":"null"}]},"evidence":{"anyOf":[{"$ref":"#/components/schemas/PublicKitEvidence"},{"type":"null"}]},"kit_revision":{"title":"Kit Revision","type":"string"},"outline":{"items":{"$ref":"#/components/schemas/PublicKitOutlineItem"},"title":"Outline","type":"array"},"primary_keyword":{"default":"","title":"Primary Keyword","type":"string"},"review_findings":{"description":"What the review gate found. Each item is one of: a low-confidence requirement or claim (item_id, kind, confidence, threshold, reason); a component that failed verification (component_id, kind, reason, claim_id); a kit element or citation rule the brief's article spec requires that the kit cannot provide (element, reason, detail; approving the kit waives it); or an article spec note that never holds the kit (advisory, element, component_id).","items":{"additionalProperties":true,"type":"object"},"title":"Review Findings","type":"array"},"status":{"$ref":"#/components/schemas/ContentKitStatus"},"title":{"default":"","title":"Title","type":"string"},"updated_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Updated At"}},"required":["content_item_id","status","kit_revision"],"title":"PublicContentKit","type":"object"},"PublicContentKitRead":{"properties":{"allowance_recovery":{"anyOf":[{"$ref":"#/components/schemas/KitSlotRecovery"},{"type":"null"}]},"auto_approved":{"default":false,"title":"Auto Approved","type":"boolean"},"brief_id":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Brief Id"},"claims":{"items":{"$ref":"#/components/schemas/PublicKitClaim"},"title":"Claims","type":"array"},"components":{"items":{"$ref":"#/components/schemas/PublicKitComponent"},"title":"Components","type":"array"},"content_item_id":{"format":"uuid","title":"Content Item Id","type":"string"},"decided_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Decided At"},"decided_by":{"anyOf":[{"$ref":"#/components/schemas/ContentKitDecisionActor"},{"type":"null"}]},"evidence":{"anyOf":[{"$ref":"#/components/schemas/PublicKitEvidence"},{"type":"null"}]},"kit_revision":{"title":"Kit Revision","type":"string"},"outline":{"items":{"$ref":"#/components/schemas/PublicKitOutlineItem"},"title":"Outline","type":"array"},"primary_keyword":{"default":"","title":"Primary Keyword","type":"string"},"review_findings":{"description":"What the review gate found. Each item is one of: a low-confidence requirement or claim (item_id, kind, confidence, threshold, reason); a component that failed verification (component_id, kind, reason, claim_id); a kit element or citation rule the brief's article spec requires that the kit cannot provide (element, reason, detail; approving the kit waives it); or an article spec note that never holds the kit (advisory, element, component_id).","items":{"additionalProperties":true,"type":"object"},"title":"Review Findings","type":"array"},"status":{"$ref":"#/components/schemas/ContentKitStatus"},"title":{"default":"","title":"Title","type":"string"},"updated_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Updated At"},"write_state":{"$ref":"#/components/schemas/ContentKitWriteState","description":"Availability of the held generation's write on this item. Read again after a write attempt."}},"required":["content_item_id","status","kit_revision","write_state"],"title":"PublicContentKitRead","type":"object"},"PublicContentScoring":{"description":"Opt-in quality signals projected from a version's persisted metadata. Every field is nullable/empty by default so a partial or absent metadata blob never breaks the contract. Populated only when the detail request asks for it (``GET /content/{id}?include=scoring``); otherwise the version's ``scoring`` stays ``None``.","properties":{"draft_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Draft Label"},"draft_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Draft Score"},"geo_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Geo Label"},"geo_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Geo Score"},"recommended_actions":{"items":{"additionalProperties":true,"type":"object"},"title":"Recommended Actions","type":"array"},"research_content_degraded":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Research Content Degraded"},"research_quality":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Research Quality"},"scoring_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Scoring Source"},"warnings":{"items":{"type":"string"},"title":"Warnings","type":"array"}},"title":"PublicContentScoring","type":"object"},"PublicContentSummary":{"description":"A content item in list form (no body).","properties":{"author_id":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Author Id"},"brand_id":{"format":"uuid","title":"Brand Id","type":"string"},"brief_id":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Brief Id"},"created_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Created At"},"failed_draft_archived_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"description":"Archived after 30 days with no saved version. Restore this item by ID to list it again.","title":"Failed Draft Archived At"},"format":{"$ref":"#/components/schemas/ContentFormat"},"id":{"format":"uuid","title":"Id","type":"string"},"latest_attempt":{"anyOf":[{"$ref":"#/components/schemas/PublicJobSummary"},{"type":"null"}]},"latest_version":{"anyOf":[{"$ref":"#/components/schemas/PublicContentVersionSummary"},{"type":"null"}]},"pillar_id":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Pillar Id"},"property_id":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Property Id"},"published_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Published Url"},"slug":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Slug"},"source_topic_id":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Source Topic Id"},"status":{"$ref":"#/components/schemas/TaskStatus"},"title":{"title":"Title","type":"string"},"updated_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Updated At"},"version_count":{"default":0,"minimum":0,"title":"Version Count","type":"integer"}},"required":["id","brand_id","title","status","format"],"title":"PublicContentSummary","type":"object"},"PublicContentVersion":{"description":"One content version (download).","properties":{"assertion_provenance":{"anyOf":[{"items":{"$ref":"#/components/schemas/PublicAssertionProvenance"},"type":"array"},{"type":"null"}],"title":"Assertion Provenance"},"brief_version_id":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Brief Version Id"},"categories":{"items":{"type":"string"},"title":"Categories","type":"array"},"compliance":{"anyOf":[{"items":{"$ref":"#/components/schemas/PublicComplianceFinding"},"type":"array"},{"type":"null"}],"title":"Compliance"},"created_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Created At"},"excerpt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Excerpt"},"id":{"format":"uuid","title":"Id","type":"string"},"markdown_body":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Markdown Body"},"producing_job":{"anyOf":[{"$ref":"#/components/schemas/PublicJobSummary"},{"type":"null"}]},"scoring":{"anyOf":[{"$ref":"#/components/schemas/PublicContentScoring"},{"type":"null"}]},"seo_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Seo Description"},"seo_keywords":{"items":{"type":"string"},"title":"Seo Keywords","type":"array"},"seo_title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Seo Title"},"sources":{"anyOf":[{"items":{"$ref":"#/components/schemas/PublicArticleSource"},"type":"array"},{"type":"null"}],"title":"Sources"},"supplied_facts":{"anyOf":[{"items":{"$ref":"#/components/schemas/PublicSuppliedFact"},"type":"array"},{"type":"null"}],"title":"Supplied Facts"},"tags":{"items":{"type":"string"},"title":"Tags","type":"array"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"version_number":{"title":"Version Number","type":"integer"},"word_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Word Count"}},"required":["id","version_number"],"title":"PublicContentVersion","type":"object"},"PublicContentVersionSummary":{"description":"Actual saved revision; null on the item when no revision exists.","properties":{"brief_version_id":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Brief Version Id"},"created_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Created At"},"id":{"format":"uuid","title":"Id","type":"string"},"producing_job":{"anyOf":[{"$ref":"#/components/schemas/PublicJobSummary"},{"type":"null"}]},"version_number":{"title":"Version Number","type":"integer"},"word_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Word Count"}},"required":["id","version_number"],"title":"PublicContentVersionSummary","type":"object"},"PublicDirection":{"additionalProperties":false,"description":"Optional writing-direction knobs for item generation (all optional).","properties":{"content_length":{"anyOf":[{"$ref":"#/components/schemas/ContentLength"},{"type":"null"}]},"content_structure":{"anyOf":[{"$ref":"#/components/schemas/ContentStructure"},{"type":"null"}]},"point_of_view":{"anyOf":[{"$ref":"#/components/schemas/PointOfView"},{"type":"null"}]},"reading_level":{"anyOf":[{"$ref":"#/components/schemas/ReadingLevel"},{"type":"null"}]},"tone":{"anyOf":[{"$ref":"#/components/schemas/ContentTone"},{"type":"null"}]}},"title":"PublicDirection","type":"object"},"PublicDocument":{"description":"A knowledge-library document the organization has uploaded.\n\nMetadata only — no extracted text body.","properties":{"byte_size":{"title":"Byte Size","type":"integer"},"category":{"$ref":"#/components/schemas/DocumentCategory"},"created_at":{"format":"date-time","title":"Created At","type":"string"},"failed_stage":{"anyOf":[{"$ref":"#/components/schemas/DocumentFailedStage"},{"type":"null"}]},"failure_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Failure Reason"},"id":{"format":"uuid","title":"Id","type":"string"},"is_default":{"default":false,"title":"Is Default","type":"boolean"},"mime_type":{"title":"Mime Type","type":"string"},"original_filename":{"title":"Original Filename","type":"string"},"status":{"$ref":"#/components/schemas/DocumentStatus"},"structured_summary":{"anyOf":[{"discriminator":{"mapping":{"brand_guidelines":"#/components/schemas/BrandGuidelinesSummary","case_study":"#/components/schemas/CaseStudySummary","customer_persona":"#/components/schemas/CustomerPersonaSummary","marketing_material":"#/components/schemas/MarketingMaterialSummary","other":"#/components/schemas/OtherSummary","product_service":"#/components/schemas/ProductServiceSummary","technical_spec":"#/components/schemas/TechnicalSpecSummary"},"propertyName":"category"},"oneOf":[{"$ref":"#/components/schemas/BrandGuidelinesSummary"},{"$ref":"#/components/schemas/ProductServiceSummary"},{"$ref":"#/components/schemas/CustomerPersonaSummary"},{"$ref":"#/components/schemas/MarketingMaterialSummary"},{"$ref":"#/components/schemas/CaseStudySummary"},{"$ref":"#/components/schemas/TechnicalSpecSummary"},{"$ref":"#/components/schemas/OtherSummary"}]},{"type":"null"}],"title":"Structured Summary"},"summary_token_count":{"default":0,"title":"Summary Token Count","type":"integer"},"updated_at":{"format":"date-time","title":"Updated At","type":"string"},"version":{"default":1,"title":"Version","type":"integer"}},"required":["id","original_filename","mime_type","byte_size","category","status","created_at","updated_at"],"title":"PublicDocument","type":"object"},"PublicDraftInventoryRestore":{"description":"Identity of the failed draft returned to the content inventory.","properties":{"content_item_id":{"format":"uuid","title":"Content Item Id","type":"string"}},"required":["content_item_id"],"title":"PublicDraftInventoryRestore","type":"object"},"PublicErrorBody":{"description":"Error envelope on public-API failure responses.\n\nShape is ``{\"detail\": \"...\"}`` so declared error responses (e.g. 404)\ncarry a typed body and generated clients can read the ``detail`` string.","properties":{"detail":{"title":"Detail","type":"string"}},"required":["detail"],"title":"PublicErrorBody","type":"object"},"PublicGenerateItemRequest":{"additionalProperties":false,"description":"Optional per-generation styling for item-generate (request).","properties":{"citation_mode":{"anyOf":[{"$ref":"#/components/schemas/CitationMode"},{"type":"null"}]},"citation_style":{"anyOf":[{"$ref":"#/components/schemas/CitationStyle"},{"type":"null"}]},"content_quality":{"anyOf":[{"$ref":"#/components/schemas/ContentQuality"},{"type":"null"}]},"direction":{"anyOf":[{"$ref":"#/components/schemas/PublicDirection"},{"type":"null"}]},"expected_brief_content_sha256":{"pattern":"^[0-9a-f]{64}$","title":"Expected Brief Content Sha256","type":"string"},"expected_brief_version_id":{"format":"uuid","title":"Expected Brief Version Id","type":"string"},"kit_mode":{"anyOf":[{"$ref":"#/components/schemas/KitMode"},{"type":"null"}]},"prohibited_phrases":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Prohibited Phrases"},"source_verification_failure_mode":{"anyOf":[{"$ref":"#/components/schemas/SourceVerificationFailureMode"},{"type":"null"}]}},"title":"PublicGenerateItemRequest","type":"object"},"PublicGenerateRequest":{"additionalProperties":false,"description":"Kick off generation for an existing topic.\n\nOptional ``property_id`` selects the publishing property; it must belong\nto the topic's brand. Omit it to use the organization default property\n(when it is on the topic's brand) or the brand's only property.","properties":{"content_quality":{"anyOf":[{"$ref":"#/components/schemas/ContentQuality"},{"type":"null"}]},"prohibited_phrases":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Prohibited Phrases"},"property_id":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Property Id"},"source_verification_failure_mode":{"anyOf":[{"$ref":"#/components/schemas/SourceVerificationFailureMode"},{"type":"null"}]},"topic_id":{"format":"uuid","title":"Topic Id","type":"string"}},"required":["topic_id"],"title":"PublicGenerateRequest","type":"object"},"PublicGenerateResponse":{"description":"Accepted-generation envelope; poll the job for completion.\n\n``status`` is typically ``running`` at kickoff, or ``queued`` when the run\nis accepted but not yet assigned.","properties":{"content_quality":{"$ref":"#/components/schemas/ContentQuality","default":"standard"},"job_id":{"format":"uuid","title":"Job Id","type":"string"},"status":{"$ref":"#/components/schemas/JobStatus"},"workflow_id":{"title":"Workflow Id","type":"string"}},"required":["job_id","workflow_id","status"],"title":"PublicGenerateResponse","type":"object"},"PublicGenerationWarning":{"description":"Public code and stage of a recorded generation warning.","properties":{"code":{"title":"Code","type":"string"},"stage":{"title":"Stage","type":"string"}},"required":["code","stage"],"title":"PublicGenerationWarning","type":"object"},"PublicHumanizationCapability":{"description":"Whether this org can start optional StealthGPT humanization (D4).\n\nDerived from the global release gate + the org's integration being\nenabled + a stored key. ``reason`` is set exactly when unavailable. It\nexposes no key, key hash, Vault id or provider account data, and a stale\nread never authorizes a run (intake re-checks).","properties":{"available":{"title":"Available","type":"boolean"},"reason":{"anyOf":[{"$ref":"#/components/schemas/HumanizationUnavailableReason"},{"type":"null"}]}},"required":["available"],"title":"PublicHumanizationCapability","type":"object"},"PublicImportedContent":{"description":"A CMS-synced imported content item (summary).","properties":{"brief_id":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Brief Id"},"content_type":{"title":"Content Type","type":"string"},"has_brief":{"default":false,"title":"Has Brief","type":"boolean"},"id":{"format":"uuid","title":"Id","type":"string"},"imported_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Imported At"},"status":{"title":"Status","type":"string"},"title":{"title":"Title","type":"string"}},"required":["id","title","content_type","status"],"title":"PublicImportedContent","type":"object"},"PublicImportedContentDetail":{"description":"A CMS-synced imported content item with body + metadata.","properties":{"author_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Author Name"},"brief_id":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Brief Id"},"categories":{"items":{"type":"string"},"title":"Categories","type":"array"},"content_type":{"title":"Content Type","type":"string"},"excerpt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Excerpt"},"featured_image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Featured Image Url"},"has_brief":{"default":false,"title":"Has Brief","type":"boolean"},"id":{"format":"uuid","title":"Id","type":"string"},"imported_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Imported At"},"markdown_body":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Markdown Body"},"pillar_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pillar Name"},"published_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Published At"},"seo_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Seo Description"},"seo_title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Seo Title"},"slug":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Slug"},"status":{"title":"Status","type":"string"},"tags":{"items":{"type":"string"},"title":"Tags","type":"array"},"title":{"title":"Title","type":"string"}},"required":["id","title","content_type","status"],"title":"PublicImportedContentDetail","type":"object"},"PublicJobStatus":{"description":"Job poll result. ``content_item_id`` populates once the run targets or\ncreates an item. Reads persisted job state only (no live backend sync on\nread). Failed jobs may include ``error`` and machine-readable ``error_type``.","properties":{"brand_id":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Brand Id"},"brief_id":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Brief Id"},"content_item_id":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Content Item Id"},"content_version_id":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Content Version Id"},"created_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Created At"},"elapsed_seconds":{"anyOf":[{"minimum":0,"type":"number"},{"type":"null"}],"title":"Elapsed Seconds"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"},"error_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Type"},"finished_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Finished At"},"generation_warnings":{"items":{"$ref":"#/components/schemas/PublicGenerationWarning"},"title":"Generation Warnings","type":"array"},"job_id":{"format":"uuid","title":"Job Id","type":"string"},"kit_confidence":{"anyOf":[{"maximum":1,"minimum":0,"type":"number"},{"type":"null"}],"title":"Kit Confidence"},"kit_revision":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Kit Revision"},"kit_status":{"anyOf":[{"$ref":"#/components/schemas/ContentKitStatus"},{"type":"null"}]},"property_id":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Property Id"},"queued_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Queued At"},"result":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Result"},"review_holds":{"items":{"$ref":"#/components/schemas/PublicReviewHold"},"title":"Review Holds","type":"array"},"review_reasons":{"items":{"$ref":"#/components/schemas/ArticleV2ReviewReason"},"title":"Review Reasons","type":"array"},"started_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Started At"},"status":{"$ref":"#/components/schemas/JobStatus"},"type":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Stored job-type name, preserved verbatim including retired types.","title":"Type"}},"required":["job_id","status"],"title":"PublicJobStatus","type":"object"},"PublicJobSummary":{"description":"Persisted, organization-scoped recovery state without internal payloads.","properties":{"brand_id":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Brand Id"},"brief_id":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Brief Id"},"content_item_id":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Content Item Id"},"content_version_id":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Content Version Id"},"created_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Created At"},"elapsed_seconds":{"anyOf":[{"minimum":0,"type":"number"},{"type":"null"}],"title":"Elapsed Seconds"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"},"error_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Type"},"finished_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Finished At"},"job_id":{"format":"uuid","title":"Job Id","type":"string"},"property_id":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Property Id"},"queued_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Queued At"},"started_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Started At"},"status":{"$ref":"#/components/schemas/JobStatus"},"type":{"description":"Stored job-type name, preserved verbatim including retired types.","title":"Type","type":"string"}},"required":["job_id","type","status"],"title":"PublicJobSummary","type":"object"},"PublicKeyword":{"description":"A keyword in the org's curated strategy (narrow projection).","properties":{"canonical_keyword":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Canonical Keyword"},"id":{"format":"uuid","title":"Id","type":"string"},"intent":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Intent"},"keyword":{"title":"Keyword","type":"string"},"metrics":{"$ref":"#/components/schemas/PublicKeywordMetrics"},"source":{"title":"Source","type":"string"},"status":{"title":"Status","type":"string"}},"required":["id","keyword","status","source"],"title":"PublicKeyword","type":"object"},"PublicKeywordCluster":{"description":"A keyword cluster (topic grouping) in the org's strategy.\n\nIncludes member keywords and roll-up counts, including how many topic\nrecommendations are linked to the cluster.","properties":{"active_keyword_count":{"default":0,"title":"Active Keyword Count","type":"integer"},"archived_keyword_count":{"default":0,"title":"Archived Keyword Count","type":"integer"},"id":{"format":"uuid","title":"Id","type":"string"},"keywords":{"items":{"$ref":"#/components/schemas/PublicKeyword"},"title":"Keywords","type":"array"},"name":{"title":"Name","type":"string"},"opportunity_summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Opportunity Summary"},"pillar_id":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Pillar Id"},"rejected_keyword_count":{"default":0,"title":"Rejected Keyword Count","type":"integer"},"source":{"title":"Source","type":"string"},"status":{"title":"Status","type":"string"},"suggested_keyword_count":{"default":0,"title":"Suggested Keyword Count","type":"integer"},"topic_recommendation_count":{"default":0,"title":"Topic Recommendation Count","type":"integer"}},"required":["id","name","status","source"],"title":"PublicKeywordCluster","type":"object"},"PublicKeywordInventory":{"description":"A brand's curated keyword strategy: clusters, keywords, and counts.\n\nRead of your stored keyword plan only — no third-party provider calls.","properties":{"brand_id":{"format":"uuid","title":"Brand Id","type":"string"},"clusters":{"items":{"$ref":"#/components/schemas/PublicKeywordCluster"},"title":"Clusters","type":"array"},"counts":{"$ref":"#/components/schemas/PublicKeywordInventoryCounts"}},"required":["brand_id"],"title":"PublicKeywordInventory","type":"object"},"PublicKeywordInventoryCounts":{"description":"Roll-up counts for a brand's keyword inventory.","properties":{"clusters":{"default":0,"title":"Clusters","type":"integer"},"keywords":{"default":0,"title":"Keywords","type":"integer"},"topic_recommendations":{"default":0,"title":"Topic Recommendations","type":"integer"}},"title":"PublicKeywordInventoryCounts","type":"object"},"PublicKeywordMetrics":{"description":"Provider-derived metrics for a keyword (the org's own cached values). Sourced from stored keyword data — no live provider call is made to serve this. Any field may be null when metrics have not been fetched/resolved.","properties":{"competition":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Competition"},"cpc":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Cpc"},"keyword_difficulty":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Keyword Difficulty"},"metrics_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Metrics Status"},"search_volume":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Search Volume"}},"title":"PublicKeywordMetrics","type":"object"},"PublicKeywordSegment":{"additionalProperties":false,"description":"Request-side seed scoping for keyword inventory. v1 accepts seeds only.","properties":{"seeds":{"items":{"type":"string"},"title":"Seeds","type":"array"}},"title":"PublicKeywordSegment","type":"object"},"PublicKitApproval":{"description":"The approved kit plus what happened to the article write.","properties":{"auto_approved":{"default":false,"title":"Auto Approved","type":"boolean"},"brief_id":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Brief Id"},"claims":{"items":{"$ref":"#/components/schemas/PublicKitClaim"},"title":"Claims","type":"array"},"components":{"items":{"$ref":"#/components/schemas/PublicKitComponent"},"title":"Components","type":"array"},"content_item_id":{"format":"uuid","title":"Content Item Id","type":"string"},"decided_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Decided At"},"decided_by":{"anyOf":[{"$ref":"#/components/schemas/ContentKitDecisionActor"},{"type":"null"}]},"evidence":{"anyOf":[{"$ref":"#/components/schemas/PublicKitEvidence"},{"type":"null"}]},"kit_revision":{"title":"Kit Revision","type":"string"},"outline":{"items":{"$ref":"#/components/schemas/PublicKitOutlineItem"},"title":"Outline","type":"array"},"primary_keyword":{"default":"","title":"Primary Keyword","type":"string"},"review_findings":{"description":"What the review gate found. Each item is one of: a low-confidence requirement or claim (item_id, kind, confidence, threshold, reason); a component that failed verification (component_id, kind, reason, claim_id); a kit element or citation rule the brief's article spec requires that the kit cannot provide (element, reason, detail; approving the kit waives it); or an article spec note that never holds the kit (advisory, element, component_id).","items":{"additionalProperties":true,"type":"object"},"title":"Review Findings","type":"array"},"status":{"$ref":"#/components/schemas/ContentKitStatus"},"title":{"default":"","title":"Title","type":"string"},"updated_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Updated At"},"write":{"$ref":"#/components/schemas/PublicKitWriteStatus"}},"required":["content_item_id","status","kit_revision","write"],"title":"PublicKitApproval","type":"object"},"PublicKitClaim":{"description":"One citable claim. ``origin=supplied`` is a fact you supplied; its\n``url`` is set only when its page was fetched and states the fact.\n``supplied_url`` and ``source_check`` show the URL you supplied and why\nit is or is not cited.","properties":{"attribution":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Attribution"},"confidence":{"maximum":1,"minimum":0,"title":"Confidence","type":"number"},"id":{"title":"Id","type":"string"},"origin":{"$ref":"#/components/schemas/ArticleSourceOrigin"},"section_ids":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"Outline section ids this claim supports, if mapped.","title":"Section Ids"},"source_check":{"anyOf":[{"$ref":"#/components/schemas/FactSourceOutcome"},{"type":"null"}],"description":"What checking the supplied URL found: verified (cited), fetch_failed (the page could not be read), not_on_page (the page does not state every figure and name in the fact), ineligible_url or unsafe_url (not allowed), or removed_source (the source was removed or its domain excluded). Null on facts added before it was recorded."},"source_check_failure":{"anyOf":[{"$ref":"#/components/schemas/FactFetchFailure"},{"type":"null"}],"description":"Recorded detail of a failed source read. Null when no detail was recorded."},"supplied_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The source URL you supplied with this fact, kept even when it is not cited. Null on facts added before it was recorded.","title":"Supplied Url"},"text":{"title":"Text","type":"string"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"}},"required":["id","text","origin","confidence"],"title":"PublicKitClaim","type":"object"},"PublicKitComponent":{"description":"One article component (FAQ, stats, quotes, table, takeaways, sources).\n``locked`` and ``user_override`` components are kept as you set them.","properties":{"id":{"title":"Id","type":"string"},"kind":{"$ref":"#/components/schemas/ContentKitComponentKind"},"locked":{"default":false,"title":"Locked","type":"boolean"},"payload":{"additionalProperties":true,"title":"Payload","type":"object"},"user_override":{"default":false,"title":"User Override","type":"boolean"}},"required":["id","kind"],"title":"PublicKitComponent","type":"object"},"PublicKitComponentInput":{"additionalProperties":false,"description":"Add or replace a component with a typed payload (request).\n\n``payload`` is the kind's structured shape (for example an FAQ's\n``items`` with each answer bound to a ``claim_id``); it is rebuilt\nagainst the kit's claims, so every figure and name it states must be in\nthe claims it cites. A raw ``{\"markdown\": ...}`` payload and the\n``sources`` kind are refused with 422 (add a fact to add a source).","properties":{"expected_kit_revision":{"pattern":"^[a-f0-9]{64}$","title":"Expected Kit Revision","type":"string"},"id":{"anyOf":[{"pattern":"^[A-Za-z0-9_:-]{1,64}$","type":"string"},{"type":"null"}],"title":"Id"},"kind":{"$ref":"#/components/schemas/ContentKitComponentKind"},"locked":{"default":false,"title":"Locked","type":"boolean"},"payload":{"additionalProperties":true,"title":"Payload","type":"object"}},"required":["expected_kit_revision","kind","payload"],"title":"PublicKitComponentInput","type":"object"},"PublicKitDecisionInput":{"additionalProperties":false,"description":"Approve or reject the kit at this revision (request).","properties":{"expected_kit_revision":{"pattern":"^[a-f0-9]{64}$","title":"Expected Kit Revision","type":"string"}},"required":["expected_kit_revision"],"title":"PublicKitDecisionInput","type":"object"},"PublicKitEvidence":{"description":"What evidence the kit holds now. Computed from the current kit on\nevery read and write, so it reflects your edits; ``review_findings`` is\nthe review gate's record of an earlier revision.","properties":{"min_sources":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"The brief's minimum, set only when it requires citations.","title":"Min Sources"},"sections":{"items":{"$ref":"#/components/schemas/PublicKitSectionEvidence"},"title":"Sections","type":"array"},"source_count":{"default":0,"description":"Distinct cited sources.","minimum":0,"title":"Source Count","type":"integer"},"unmapped_claim_count":{"default":0,"description":"Claims not matched to a section, such as facts you supplied.","minimum":0,"title":"Unmapped Claim Count","type":"integer"},"unmapped_claim_ids":{"items":{"type":"string"},"title":"Unmapped Claim Ids","type":"array"},"unmet_requirements":{"items":{"$ref":"#/components/schemas/PublicKitUnmetRequirement"},"title":"Unmet Requirements","type":"array"},"unplaceable_claim_ids":{"description":"Facts you supplied, and must-use claims, that no section can state because every section they could appear in is general-only. Add supplied facts with section_ids to place them.","items":{"type":"string"},"title":"Unplaceable Claim Ids","type":"array"}},"title":"PublicKitEvidence","type":"object"},"PublicKitFactAdded":{"description":"The kit after a fact was added. ``source_url_cited`` is true only when\nthe fact's page was fetched and states the fact; ``source_check`` says\nwhy when it is not.","properties":{"auto_approved":{"default":false,"title":"Auto Approved","type":"boolean"},"brief_id":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Brief Id"},"claim_id":{"title":"Claim Id","type":"string"},"claims":{"items":{"$ref":"#/components/schemas/PublicKitClaim"},"title":"Claims","type":"array"},"components":{"items":{"$ref":"#/components/schemas/PublicKitComponent"},"title":"Components","type":"array"},"content_item_id":{"format":"uuid","title":"Content Item Id","type":"string"},"decided_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Decided At"},"decided_by":{"anyOf":[{"$ref":"#/components/schemas/ContentKitDecisionActor"},{"type":"null"}]},"evidence":{"anyOf":[{"$ref":"#/components/schemas/PublicKitEvidence"},{"type":"null"}]},"kit_revision":{"title":"Kit Revision","type":"string"},"outline":{"items":{"$ref":"#/components/schemas/PublicKitOutlineItem"},"title":"Outline","type":"array"},"primary_keyword":{"default":"","title":"Primary Keyword","type":"string"},"review_findings":{"description":"What the review gate found. Each item is one of: a low-confidence requirement or claim (item_id, kind, confidence, threshold, reason); a component that failed verification (component_id, kind, reason, claim_id); a kit element or citation rule the brief's article spec requires that the kit cannot provide (element, reason, detail; approving the kit waives it); or an article spec note that never holds the kit (advisory, element, component_id).","items":{"additionalProperties":true,"type":"object"},"title":"Review Findings","type":"array"},"source_check":{"anyOf":[{"$ref":"#/components/schemas/FactSourceOutcome"},{"type":"null"}]},"source_url_cited":{"title":"Source Url Cited","type":"boolean"},"status":{"$ref":"#/components/schemas/ContentKitStatus"},"title":{"default":"","title":"Title","type":"string"},"updated_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Updated At"}},"required":["content_item_id","status","kit_revision","claim_id","source_url_cited"],"title":"PublicKitFactAdded","type":"object"},"PublicKitFactInput":{"additionalProperties":false,"description":"Add one supplied fact to the kit (request). Same rules as brief facts;\na duplicate of a fact already on the kit is a 422. ``section_ids`` maps\nthe fact to outline sections: it then counts as their evidence and the\nwriter may state it there even in a section otherwise kept general. An id\nnot in the kit's outline is a 422 (``section_not_in_outline``).","properties":{"attribution":{"anyOf":[{"maxLength":120,"type":"string"},{"type":"null"}],"title":"Attribution"},"expected_kit_revision":{"pattern":"^[a-f0-9]{64}$","title":"Expected Kit Revision","type":"string"},"priority":{"$ref":"#/components/schemas/UserFactPriority","default":"normal"},"section_ids":{"anyOf":[{"items":{"type":"string"},"maxItems":20,"type":"array"},{"type":"null"}],"title":"Section Ids"},"source_url":{"anyOf":[{"maxLength":2048,"type":"string"},{"type":"null"}],"title":"Source Url"},"text":{"maxLength":200,"minLength":1,"title":"Text","type":"string"}},"required":["text","expected_kit_revision"],"title":"PublicKitFactInput","type":"object"},"PublicKitOutlineItem":{"description":"One planned section of the article.","properties":{"heading":{"title":"Heading","type":"string"},"id":{"title":"Id","type":"string"},"target_words":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Target Words"}},"required":["id","heading"],"title":"PublicKitOutlineItem","type":"object"},"PublicKitRevisionInput":{"additionalProperties":false,"description":"Compare-and-swap token of a kit write (request).","properties":{"expected_kit_revision":{"pattern":"^[a-f0-9]{64}$","title":"Expected Kit Revision","type":"string"}},"required":["expected_kit_revision"],"title":"PublicKitRevisionInput","type":"object"},"PublicKitSectionEvidence":{"description":"One outline section's evidence in the current kit.","properties":{"cited_claim_ids":{"description":"Cited claims supporting this section.","items":{"type":"string"},"title":"Cited Claim Ids","type":"array"},"claim_count":{"description":"Cited claims matched to this section.","minimum":0,"title":"Claim Count","type":"integer"},"general_only":{"description":"The writer keeps this section general: no figures, prices, dates or named-product facts.","title":"General Only","type":"boolean"},"heading":{"title":"Heading","type":"string"},"outline_id":{"title":"Outline Id","type":"string"},"source_urls":{"description":"Distinct URLs cited in this section.","items":{"type":"string"},"title":"Source Urls","type":"array"},"uncited_claim_ids":{"description":"Facts you supplied for this section that have no cited URL; they are written as plain prose.","items":{"type":"string"},"title":"Uncited Claim Ids","type":"array"}},"required":["outline_id","heading","claim_count","general_only"],"title":"PublicKitSectionEvidence","type":"object"},"PublicKitSourceExclusion":{"description":"The kit after a source domain was excluded, and what changed.","properties":{"auto_approved":{"default":false,"title":"Auto Approved","type":"boolean"},"brief_id":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Brief Id"},"claims":{"items":{"$ref":"#/components/schemas/PublicKitClaim"},"title":"Claims","type":"array"},"components":{"items":{"$ref":"#/components/schemas/PublicKitComponent"},"title":"Components","type":"array"},"content_item_id":{"format":"uuid","title":"Content Item Id","type":"string"},"decided_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Decided At"},"decided_by":{"anyOf":[{"$ref":"#/components/schemas/ContentKitDecisionActor"},{"type":"null"}]},"domain":{"title":"Domain","type":"string"},"dropped_component_ids":{"items":{"type":"string"},"title":"Dropped Component Ids","type":"array"},"evidence":{"anyOf":[{"$ref":"#/components/schemas/PublicKitEvidence"},{"type":"null"}]},"excluded_source_urls":{"items":{"type":"string"},"title":"Excluded Source Urls","type":"array"},"general_only_sections":{"description":"Sections that lost their last cited claim; the writer keeps them general.","items":{"type":"string"},"title":"General Only Sections","type":"array"},"kit_revision":{"title":"Kit Revision","type":"string"},"outline":{"items":{"$ref":"#/components/schemas/PublicKitOutlineItem"},"title":"Outline","type":"array"},"primary_keyword":{"default":"","title":"Primary Keyword","type":"string"},"removed_claim_ids":{"items":{"type":"string"},"title":"Removed Claim Ids","type":"array"},"review_findings":{"description":"What the review gate found. Each item is one of: a low-confidence requirement or claim (item_id, kind, confidence, threshold, reason); a component that failed verification (component_id, kind, reason, claim_id); a kit element or citation rule the brief's article spec requires that the kit cannot provide (element, reason, detail; approving the kit waives it); or an article spec note that never holds the kit (advisory, element, component_id).","items":{"additionalProperties":true,"type":"object"},"title":"Review Findings","type":"array"},"status":{"$ref":"#/components/schemas/ContentKitStatus"},"title":{"default":"","title":"Title","type":"string"},"uncited_fact_claim_ids":{"description":"Facts you supplied that cited the domain. They stay in the kit as uncited statements; remove them if they should go too.","items":{"type":"string"},"title":"Uncited Fact Claim Ids","type":"array"},"updated_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Updated At"}},"required":["content_item_id","status","kit_revision","domain","excluded_source_urls","removed_claim_ids","dropped_component_ids","uncited_fact_claim_ids","general_only_sections"],"title":"PublicKitSourceExclusion","type":"object"},"PublicKitSourceExclusionInput":{"additionalProperties":false,"description":"Exclude one source domain from the kit (request). ``domain`` is a bare\nhost name such as ``example.com``; its subdomains are excluded too.","properties":{"domain":{"maxLength":253,"minLength":1,"title":"Domain","type":"string"},"expected_kit_revision":{"pattern":"^[a-f0-9]{64}$","title":"Expected Kit Revision","type":"string"}},"required":["expected_kit_revision","domain"],"title":"PublicKitSourceExclusionInput","type":"object"},"PublicKitUnmetRequirement":{"description":"A kit element or citation rule the brief requires that the current\nkit cannot provide.","properties":{"detail":{"default":"","title":"Detail","type":"string"},"element":{"$ref":"#/components/schemas/ArticleElement"},"reason":{"$ref":"#/components/schemas/RequiredElementReason"}},"required":["element","reason"],"title":"PublicKitUnmetRequirement","type":"object"},"PublicKitWriteStatus":{"description":"What happened to the article write after an approval was stored.\n\n``started``: the write for this approved kit is running (poll\n``GET /jobs`` filtered by ``content_item_id``). ``not_started``: the\napproval is stored but no write started; approve again or regenerate.","enum":["started","not_started"],"title":"PublicKitWriteStatus","type":"string"},"PublicOrganizationSettings":{"description":"Stable public org-level settings.","properties":{"brief_auto_approve":{"default":true,"title":"Brief Auto Approve","type":"boolean"},"brief_review_confidence_threshold":{"default":0.7,"maximum":1,"minimum":0,"title":"Brief Review Confidence Threshold","type":"number"},"default_citation_mode":{"$ref":"#/components/schemas/CitationStyle","default":"bottom_only"},"default_content_quality":{"$ref":"#/components/schemas/ContentQuality","default":"standard"},"default_property_id":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"description":"Organization default publishing property for topic generation, or null when none is set. Used when POST /content/generate omits property_id and this property belongs to the topic's brand.","title":"Default Property Id"},"max_citations_per_content":{"default":8,"maximum":30,"minimum":1,"title":"Max Citations Per Content","type":"integer"},"prohibited_phrases":{"items":{"type":"string"},"title":"Prohibited Phrases","type":"array"},"regulated_industries":{"items":{"$ref":"#/components/schemas/RegulatedIndustry"},"title":"Regulated Industries","type":"array"},"source_verification_failure_mode":{"$ref":"#/components/schemas/SourceVerificationFailureMode","default":"repair_then_fail"}},"title":"PublicOrganizationSettings","type":"object"},"PublicOrganizationSettingsUpdate":{"additionalProperties":false,"description":"Partial organization policy update. Omitted fields remain unchanged; at least one valid setting must be provided. Source verification cannot be disabled.","properties":{"brief_auto_approve":{"title":"Brief Auto Approve","type":"boolean"},"brief_review_confidence_threshold":{"maximum":1,"minimum":0,"title":"Brief Review Confidence Threshold","type":"number"},"default_citation_mode":{"$ref":"#/components/schemas/CitationStyle","title":"Default Citation Mode"},"default_content_quality":{"$ref":"#/components/schemas/ContentQuality","title":"Default Content Quality"},"default_property_id":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"description":"Set the organization default publishing property, or send null to clear it. Omit to leave it unchanged. Must be an active property of this organization; anything else returns 422.","title":"Default Property Id"},"max_citations_per_content":{"maximum":30,"minimum":1,"title":"Max Citations Per Content","type":"integer"},"prohibited_phrases":{"items":{"type":"string"},"title":"Prohibited Phrases","type":"array"},"regulated_industries":{"anyOf":[{"items":{"$ref":"#/components/schemas/RegulatedIndustry"},"type":"array"},{"type":"null"}],"title":"Regulated Industries"},"source_verification_failure_mode":{"anyOf":[{"$ref":"#/components/schemas/SourceVerificationFailureMode"},{"type":"null"}]}},"title":"PublicOrganizationSettingsUpdate","type":"object"},"PublicPage_PublicAudience_":{"properties":{"has_more":{"default":false,"title":"Has More","type":"boolean"},"items":{"items":{"$ref":"#/components/schemas/PublicAudience"},"title":"Items","type":"array"},"limit":{"title":"Limit","type":"integer"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Opaque keyset cursor for the next page when the endpoint supports cursor paging. Prefer this over offset for multi-page walks.","title":"Next Cursor"},"offset":{"title":"Offset","type":"integer"},"total":{"default":0,"title":"Total","type":"integer"}},"required":["limit","offset"],"title":"PublicPage[PublicAudience]","type":"object"},"PublicPage_PublicAuthor_":{"properties":{"has_more":{"default":false,"title":"Has More","type":"boolean"},"items":{"items":{"$ref":"#/components/schemas/PublicAuthor"},"title":"Items","type":"array"},"limit":{"title":"Limit","type":"integer"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Opaque keyset cursor for the next page when the endpoint supports cursor paging. Prefer this over offset for multi-page walks.","title":"Next Cursor"},"offset":{"title":"Offset","type":"integer"},"total":{"default":0,"title":"Total","type":"integer"}},"required":["limit","offset"],"title":"PublicPage[PublicAuthor]","type":"object"},"PublicPage_PublicBrand_":{"properties":{"has_more":{"default":false,"title":"Has More","type":"boolean"},"items":{"items":{"$ref":"#/components/schemas/PublicBrand"},"title":"Items","type":"array"},"limit":{"title":"Limit","type":"integer"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Opaque keyset cursor for the next page when the endpoint supports cursor paging. Prefer this over offset for multi-page walks.","title":"Next Cursor"},"offset":{"title":"Offset","type":"integer"},"total":{"default":0,"title":"Total","type":"integer"}},"required":["limit","offset"],"title":"PublicPage[PublicBrand]","type":"object"},"PublicPage_PublicBrief_":{"properties":{"has_more":{"default":false,"title":"Has More","type":"boolean"},"items":{"items":{"$ref":"#/components/schemas/PublicBrief"},"title":"Items","type":"array"},"limit":{"title":"Limit","type":"integer"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Opaque keyset cursor for the next page when the endpoint supports cursor paging. Prefer this over offset for multi-page walks.","title":"Next Cursor"},"offset":{"title":"Offset","type":"integer"},"total":{"default":0,"title":"Total","type":"integer"}},"required":["limit","offset"],"title":"PublicPage[PublicBrief]","type":"object"},"PublicPage_PublicCategory_":{"properties":{"has_more":{"default":false,"title":"Has More","type":"boolean"},"items":{"items":{"$ref":"#/components/schemas/PublicCategory"},"title":"Items","type":"array"},"limit":{"title":"Limit","type":"integer"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Opaque keyset cursor for the next page when the endpoint supports cursor paging. Prefer this over offset for multi-page walks.","title":"Next Cursor"},"offset":{"title":"Offset","type":"integer"},"total":{"default":0,"title":"Total","type":"integer"}},"required":["limit","offset"],"title":"PublicPage[PublicCategory]","type":"object"},"PublicPage_PublicContentItemDetail_":{"properties":{"has_more":{"default":false,"title":"Has More","type":"boolean"},"items":{"items":{"$ref":"#/components/schemas/PublicContentItemDetail"},"title":"Items","type":"array"},"limit":{"title":"Limit","type":"integer"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Opaque keyset cursor for the next page when the endpoint supports cursor paging. Prefer this over offset for multi-page walks.","title":"Next Cursor"},"offset":{"title":"Offset","type":"integer"},"total":{"default":0,"title":"Total","type":"integer"}},"required":["limit","offset"],"title":"PublicPage[PublicContentItemDetail]","type":"object"},"PublicPage_PublicContentSummary_":{"properties":{"has_more":{"default":false,"title":"Has More","type":"boolean"},"items":{"items":{"$ref":"#/components/schemas/PublicContentSummary"},"title":"Items","type":"array"},"limit":{"title":"Limit","type":"integer"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Opaque keyset cursor for the next page when the endpoint supports cursor paging. Prefer this over offset for multi-page walks.","title":"Next Cursor"},"offset":{"title":"Offset","type":"integer"},"total":{"default":0,"title":"Total","type":"integer"}},"required":["limit","offset"],"title":"PublicPage[PublicContentSummary]","type":"object"},"PublicPage_PublicContentVersion_":{"properties":{"has_more":{"default":false,"title":"Has More","type":"boolean"},"items":{"items":{"$ref":"#/components/schemas/PublicContentVersion"},"title":"Items","type":"array"},"limit":{"title":"Limit","type":"integer"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Opaque keyset cursor for the next page when the endpoint supports cursor paging. Prefer this over offset for multi-page walks.","title":"Next Cursor"},"offset":{"title":"Offset","type":"integer"},"total":{"default":0,"title":"Total","type":"integer"}},"required":["limit","offset"],"title":"PublicPage[PublicContentVersion]","type":"object"},"PublicPage_PublicDocument_":{"properties":{"has_more":{"default":false,"title":"Has More","type":"boolean"},"items":{"items":{"$ref":"#/components/schemas/PublicDocument"},"title":"Items","type":"array"},"limit":{"title":"Limit","type":"integer"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Opaque keyset cursor for the next page when the endpoint supports cursor paging. Prefer this over offset for multi-page walks.","title":"Next Cursor"},"offset":{"title":"Offset","type":"integer"},"total":{"default":0,"title":"Total","type":"integer"}},"required":["limit","offset"],"title":"PublicPage[PublicDocument]","type":"object"},"PublicPage_PublicImportedContent_":{"properties":{"has_more":{"default":false,"title":"Has More","type":"boolean"},"items":{"items":{"$ref":"#/components/schemas/PublicImportedContent"},"title":"Items","type":"array"},"limit":{"title":"Limit","type":"integer"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Opaque keyset cursor for the next page when the endpoint supports cursor paging. Prefer this over offset for multi-page walks.","title":"Next Cursor"},"offset":{"title":"Offset","type":"integer"},"total":{"default":0,"title":"Total","type":"integer"}},"required":["limit","offset"],"title":"PublicPage[PublicImportedContent]","type":"object"},"PublicPage_PublicJobSummary_":{"properties":{"has_more":{"default":false,"title":"Has More","type":"boolean"},"items":{"items":{"$ref":"#/components/schemas/PublicJobSummary"},"title":"Items","type":"array"},"limit":{"title":"Limit","type":"integer"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Opaque keyset cursor for the next page when the endpoint supports cursor paging. Prefer this over offset for multi-page walks.","title":"Next Cursor"},"offset":{"title":"Offset","type":"integer"},"total":{"default":0,"title":"Total","type":"integer"}},"required":["limit","offset"],"title":"PublicPage[PublicJobSummary]","type":"object"},"PublicPage_PublicPillar_":{"properties":{"has_more":{"default":false,"title":"Has More","type":"boolean"},"items":{"items":{"$ref":"#/components/schemas/PublicPillar"},"title":"Items","type":"array"},"limit":{"title":"Limit","type":"integer"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Opaque keyset cursor for the next page when the endpoint supports cursor paging. Prefer this over offset for multi-page walks.","title":"Next Cursor"},"offset":{"title":"Offset","type":"integer"},"total":{"default":0,"title":"Total","type":"integer"}},"required":["limit","offset"],"title":"PublicPage[PublicPillar]","type":"object"},"PublicPage_PublicProgramFact_":{"properties":{"has_more":{"default":false,"title":"Has More","type":"boolean"},"items":{"items":{"$ref":"#/components/schemas/PublicProgramFact"},"title":"Items","type":"array"},"limit":{"title":"Limit","type":"integer"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Opaque keyset cursor for the next page when the endpoint supports cursor paging. Prefer this over offset for multi-page walks.","title":"Next Cursor"},"offset":{"title":"Offset","type":"integer"},"total":{"default":0,"title":"Total","type":"integer"}},"required":["limit","offset"],"title":"PublicPage[PublicProgramFact]","type":"object"},"PublicPage_PublicProgramIdea_":{"properties":{"has_more":{"default":false,"title":"Has More","type":"boolean"},"items":{"items":{"$ref":"#/components/schemas/PublicProgramIdea"},"title":"Items","type":"array"},"limit":{"title":"Limit","type":"integer"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Opaque keyset cursor for the next page when the endpoint supports cursor paging. Prefer this over offset for multi-page walks.","title":"Next Cursor"},"offset":{"title":"Offset","type":"integer"},"total":{"default":0,"title":"Total","type":"integer"}},"required":["limit","offset"],"title":"PublicPage[PublicProgramIdea]","type":"object"},"PublicPage_PublicProgramPage_":{"properties":{"has_more":{"default":false,"title":"Has More","type":"boolean"},"items":{"items":{"$ref":"#/components/schemas/PublicProgramPage"},"title":"Items","type":"array"},"limit":{"title":"Limit","type":"integer"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Opaque keyset cursor for the next page when the endpoint supports cursor paging. Prefer this over offset for multi-page walks.","title":"Next Cursor"},"offset":{"title":"Offset","type":"integer"},"total":{"default":0,"title":"Total","type":"integer"}},"required":["limit","offset"],"title":"PublicPage[PublicProgramPage]","type":"object"},"PublicPage_PublicProgramPlanPage_":{"properties":{"has_more":{"default":false,"title":"Has More","type":"boolean"},"items":{"items":{"$ref":"#/components/schemas/PublicProgramPlanPage"},"title":"Items","type":"array"},"limit":{"title":"Limit","type":"integer"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Opaque keyset cursor for the next page when the endpoint supports cursor paging. Prefer this over offset for multi-page walks.","title":"Next Cursor"},"offset":{"title":"Offset","type":"integer"},"total":{"default":0,"title":"Total","type":"integer"}},"required":["limit","offset"],"title":"PublicPage[PublicProgramPlanPage]","type":"object"},"PublicPage_PublicProgram_":{"properties":{"has_more":{"default":false,"title":"Has More","type":"boolean"},"items":{"items":{"$ref":"#/components/schemas/PublicProgram"},"title":"Items","type":"array"},"limit":{"title":"Limit","type":"integer"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Opaque keyset cursor for the next page when the endpoint supports cursor paging. Prefer this over offset for multi-page walks.","title":"Next Cursor"},"offset":{"title":"Offset","type":"integer"},"total":{"default":0,"title":"Total","type":"integer"}},"required":["limit","offset"],"title":"PublicPage[PublicProgram]","type":"object"},"PublicPage_PublicProperty_":{"properties":{"has_more":{"default":false,"title":"Has More","type":"boolean"},"items":{"items":{"$ref":"#/components/schemas/PublicProperty"},"title":"Items","type":"array"},"limit":{"title":"Limit","type":"integer"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Opaque keyset cursor for the next page when the endpoint supports cursor paging. Prefer this over offset for multi-page walks.","title":"Next Cursor"},"offset":{"title":"Offset","type":"integer"},"total":{"default":0,"title":"Total","type":"integer"}},"required":["limit","offset"],"title":"PublicPage[PublicProperty]","type":"object"},"PublicPage_PublicTag_":{"properties":{"has_more":{"default":false,"title":"Has More","type":"boolean"},"items":{"items":{"$ref":"#/components/schemas/PublicTag"},"title":"Items","type":"array"},"limit":{"title":"Limit","type":"integer"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Opaque keyset cursor for the next page when the endpoint supports cursor paging. Prefer this over offset for multi-page walks.","title":"Next Cursor"},"offset":{"title":"Offset","type":"integer"},"total":{"default":0,"title":"Total","type":"integer"}},"required":["limit","offset"],"title":"PublicPage[PublicTag]","type":"object"},"PublicPage_PublicTopic_":{"properties":{"has_more":{"default":false,"title":"Has More","type":"boolean"},"items":{"items":{"$ref":"#/components/schemas/PublicTopic"},"title":"Items","type":"array"},"limit":{"title":"Limit","type":"integer"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Opaque keyset cursor for the next page when the endpoint supports cursor paging. Prefer this over offset for multi-page walks.","title":"Next Cursor"},"offset":{"title":"Offset","type":"integer"},"total":{"default":0,"title":"Total","type":"integer"}},"required":["limit","offset"],"title":"PublicPage[PublicTopic]","type":"object"},"PublicPillar":{"description":"A content pillar (response).\n\n``keywords`` is the stored keyword list (useful for write round-trips).\n``display_keywords`` is the resolved keyword plan preferred for\npresentation and may differ from ``keywords``.","properties":{"brand_id":{"format":"uuid","title":"Brand Id","type":"string"},"business_goal":{"default":"","title":"Business Goal","type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"display_keywords":{"items":{"type":"string"},"title":"Display Keywords","type":"array"},"display_keywords_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Display Keywords Source"},"goal":{"$ref":"#/components/schemas/PillarGoal"},"id":{"format":"uuid","title":"Id","type":"string"},"keywords":{"items":{"type":"string"},"title":"Keywords","type":"array"},"name":{"title":"Name","type":"string"},"status":{"$ref":"#/components/schemas/ContentStatus"},"target_audience":{"default":"","title":"Target Audience","type":"string"},"target_audience_ids":{"items":{"format":"uuid","type":"string"},"title":"Target Audience Ids","type":"array"}},"required":["id","brand_id","name","goal","status"],"title":"PublicPillar","type":"object"},"PublicPillarCreate":{"additionalProperties":false,"description":"Create a content pillar.","properties":{"brand_id":{"format":"uuid","title":"Brand Id","type":"string"},"business_goal":{"default":"","title":"Business Goal","type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"goal":{"$ref":"#/components/schemas/PillarGoal","default":"awareness"},"keywords":{"items":{"type":"string"},"title":"Keywords","type":"array"},"name":{"maxLength":255,"minLength":1,"title":"Name","type":"string"},"target_audience":{"default":"","title":"Target Audience","type":"string"},"target_audience_ids":{"items":{"format":"uuid","type":"string"},"title":"Target Audience Ids","type":"array"}},"required":["brand_id","name"],"title":"PublicPillarCreate","type":"object"},"PublicPillarStrategyRequest":{"additionalProperties":false,"description":"Request to generate a clusters-first pillar strategy for a brand.","properties":{"brand_id":{"format":"uuid","title":"Brand Id","type":"string"},"force_refresh":{"default":false,"title":"Force Refresh","type":"boolean"},"keyword_segment":{"anyOf":[{"$ref":"#/components/schemas/PublicKeywordSegment"},{"type":"null"}]},"num_pillars":{"default":5,"title":"Num Pillars","type":"integer"}},"required":["brand_id"],"title":"PublicPillarStrategyRequest","type":"object"},"PublicPillarUpdate":{"additionalProperties":false,"description":"Patch a content pillar (only set fields are applied).\n\nExplicit ``null`` on ``name``, ``goal``, or ``status`` returns **422**;\n``description``, ``keywords``, ``target_audience``, ``business_goal``,\nand ``target_audience_ids`` may be ``null`` to clear.","properties":{"business_goal":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Business Goal"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"goal":{"$ref":"#/components/schemas/PillarGoal","title":"Goal"},"keywords":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Keywords"},"name":{"maxLength":255,"minLength":1,"title":"Name","type":"string"},"status":{"$ref":"#/components/schemas/ContentStatus","title":"Status"},"target_audience":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Audience"},"target_audience_ids":{"anyOf":[{"items":{"format":"uuid","type":"string"},"type":"array"},{"type":"null"}],"title":"Target Audience Ids"}},"title":"PublicPillarUpdate","type":"object"},"PublicProgram":{"description":"A programmatic-SEO program with its per-stage counts.","properties":{"brand_id":{"format":"uuid","title":"Brand Id","type":"string"},"client_reference":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Client Reference"},"counts":{"$ref":"#/components/schemas/PublicProgramCounts"},"created_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Created At"},"id":{"format":"uuid","title":"Id","type":"string"},"property_id":{"format":"uuid","title":"Property Id","type":"string"},"scope":{"$ref":"#/components/schemas/PublicProgramScope"},"state":{"$ref":"#/components/schemas/PublicProgramState"},"template_family":{"$ref":"#/components/schemas/TemplateFamily"},"updated_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Updated At"}},"required":["id","brand_id","property_id","template_family","scope","state","counts"],"title":"PublicProgram","type":"object"},"PublicProgramCounts":{"description":"Per-stage counts for one program. Every stage is always present.","properties":{"ideas":{"$ref":"#/components/schemas/PublicProgramItemCounts"},"plan_pages":{"$ref":"#/components/schemas/PublicProgramItemCounts"},"seeds":{"default":0,"title":"Seeds","type":"integer"}},"required":["ideas","plan_pages"],"title":"PublicProgramCounts","type":"object"},"PublicProgramCreate":{"additionalProperties":false,"description":"Create a program: brand, property, template family, scope, seeds.","properties":{"brand_id":{"description":"The brand this program writes for.","format":"uuid","title":"Brand Id","type":"string"},"client_reference":{"anyOf":[{"maxLength":255,"type":"string"},{"type":"null"}],"description":"Your own identifier for this program. Echoed back on reads.","title":"Client Reference"},"property_id":{"description":"The publishing property the generated pages belong to.","format":"uuid","title":"Property Id","type":"string"},"scope":{"$ref":"#/components/schemas/PublicProgramScopeInput"},"seeds":{"description":"Seeds to research this program from, submitted in bulk. Submitting the same seed twice for one program yields a single row.","items":{"$ref":"#/components/schemas/PublicProgramSeedInput"},"maxItems":500,"title":"Seeds","type":"array"},"template_family":{"$ref":"#/components/schemas/TemplateFamily","description":"The template family that expands this program's scope into a page list. Must name a first-party family from GET /program-templates."}},"required":["brand_id","property_id","template_family","scope"],"title":"PublicProgramCreate","type":"object"},"PublicProgramFact":{"description":"One stored fact about one of your program's entities.","properties":{"attribute":{"title":"Attribute","type":"string"},"created_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Created At"},"entity":{"title":"Entity","type":"string"},"origin":{"$ref":"#/components/schemas/PublicProgramFactOrigin"},"source_excerpt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Excerpt"},"source_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Url"},"updated_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Updated At"},"value":{"title":"Value","type":"string"}},"required":["entity","attribute","value","origin"],"title":"PublicProgramFact","type":"object"},"PublicProgramFactInput":{"additionalProperties":false,"description":"One fact about one of your program's entities.","properties":{"attribute":{"description":"What the value is about — a product attribute such as `Wi-Fi standard` or `Annual fee`. Search-demand metrics (search volume, keyword difficulty, CPC) are not attributes and are refused with `422`.","maxLength":120,"minLength":1,"title":"Attribute","type":"string"},"entity":{"description":"The entity these facts describe. Match a name exactly as it appears in a planned page's `expansion.entities` (case and whitespace are ignored); a fact for an entity no page names is kept but never used.","maxLength":200,"minLength":1,"title":"Entity","type":"string"},"source_excerpt":{"anyOf":[{"maxLength":1000,"type":"string"},{"type":"null"}],"description":"Optional. The passage at `source_url` that states the value.","title":"Source Excerpt"},"source_url":{"anyOf":[{"maxLength":2048,"type":"string"},{"type":"null"}],"description":"Optional. Where the value comes from; absolute `http(s)` only. It is carried into the page's brief as the cell's source.","title":"Source Url"},"value":{"description":"The fact itself. A hedge such as `unknown`, `n/a` or `not verified` is refused with `422` — leave the attribute out instead.","maxLength":2000,"minLength":1,"title":"Value","type":"string"}},"required":["entity","attribute","value"],"title":"PublicProgramFactInput","type":"object"},"PublicProgramFactOrigin":{"description":"Who recorded a fact about one of a program's entities.\n\n``supplied`` — you, through ``POST /programs/{program_id}/facts``.\n``research`` — the platform, at generate time, always with a source URL.\nA supplied fact is never overwritten by research.","enum":["supplied","research"],"title":"PublicProgramFactOrigin","type":"string"},"PublicProgramFactsSupplied":{"description":"What `POST /programs/{program_id}/facts` recorded.\n\n`facts` are the rows as stored after the merge — read back from the store,\nnot the request echoed — so you can see exactly what a later generate run\nwill use.","properties":{"entities":{"description":"The distinct entities written by this call, matched the way pages are (case and whitespace ignored), each named as the request first spelled it and listed in the order the request first named them. `facts` is ordered by entity then attribute instead.","items":{"type":"string"},"title":"Entities","type":"array"},"facts":{"items":{"$ref":"#/components/schemas/PublicProgramFact"},"title":"Facts","type":"array"},"facts_written":{"description":"How many facts this call inserted or replaced.","title":"Facts Written","type":"integer"},"program_id":{"format":"uuid","title":"Program Id","type":"string"}},"required":["program_id","facts_written","entities","facts"],"title":"PublicProgramFactsSupplied","type":"object"},"PublicProgramFactsSupply":{"additionalProperties":false,"description":"Facts to record about your program's entities, in one call.","properties":{"facts":{"description":"One entry per (entity, attribute). Sending the same pair twice in one request is refused with `422`; sending it again in a later request replaces the earlier value.","items":{"$ref":"#/components/schemas/PublicProgramFactInput"},"maxItems":500,"minItems":1,"title":"Facts","type":"array"}},"required":["facts"],"title":"PublicProgramFactsSupply","type":"object"},"PublicProgramIdea":{"description":"One candidate idea inside a program, and whether it is approved.\n\nIdeas start `pending`. Only `approved` ideas become planned pages; a\n`declined` idea is kept so you can change your mind, but it never advances.","properties":{"client_reference":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Your own identifier, carried forward from the seed this idea came from. `null` for an idea you added by hand without one, or one derived from your program scope rather than a seed.","title":"Client Reference"},"created_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Created At"},"id":{"format":"uuid","title":"Id","type":"string"},"primary_keyword":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Primary Keyword"},"program_id":{"format":"uuid","title":"Program Id","type":"string"},"research":{"additionalProperties":true,"description":"What the research run found for this idea: search volume, keyword difficulty, CPC, the competition level, and the domains currently ranking. Empty for an idea you added by hand.","title":"Research","type":"object"},"state":{"$ref":"#/components/schemas/PublicProgramItemState"},"title":{"title":"Title","type":"string"},"updated_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Updated At"}},"required":["id","program_id","title","state"],"title":"PublicProgramIdea","type":"object"},"PublicProgramIdeaCreate":{"additionalProperties":false,"description":"Add one idea to a program by hand.","properties":{"client_reference":{"anyOf":[{"maxLength":255,"type":"string"},{"type":"null"}],"description":"Your own identifier for this idea. Echoed back on reads.","title":"Client Reference"},"primary_keyword":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"description":"The keyword this idea targets. Ideas are deduplicated on it (falling back to the title), so re-adding the same keyword returns the idea you already have rather than a second one.","title":"Primary Keyword"},"title":{"description":"What the page is about.","maxLength":500,"minLength":1,"title":"Title","type":"string"}},"required":["title"],"title":"PublicProgramIdeaCreate","type":"object"},"PublicProgramItemCounts":{"description":"How many rows of one artifact sit in each approval state.\n\nEvery approval state is present with an explicit zero rather than omitted, so\na caller reading ``declined`` never has to distinguish \"none\" from \"not\nreported\".","properties":{"approved":{"default":0,"title":"Approved","type":"integer"},"declined":{"default":0,"title":"Declined","type":"integer"},"pending":{"default":0,"title":"Pending","type":"integer"},"total":{"default":0,"title":"Total","type":"integer"}},"title":"PublicProgramItemCounts","type":"object"},"PublicProgramItemState":{"description":"Approval state of a single program idea or plan page.\n\nRows start ``pending``. Only ``approved`` rows advance to the next stage;\n``declined`` rows are retained but never advance.","enum":["pending","approved","declined"],"title":"PublicProgramItemState","type":"string"},"PublicProgramPage":{"description":"One page of a program, and how far it has got toward a downloadable article.\n\nA superset of the plan page: the same row, plus what the generate stage has\ndone about it. Download a `ready` page with\n`GET /api/public/v1/content/{content_item_id}` — pass `latest_only=true` to\nget just its current version instead of its whole revision history.","properties":{"blocked_inputs":{"description":"The structured inputs the last generate run could not find for this page. Non-empty only while `generation_state` is `blocked`. Supply facts for the entities the page covers (`POST /programs/{program_id}/facts`) and run `pages:generate` again.","items":{"$ref":"#/components/schemas/TemplateGeneratorInput"},"title":"Blocked Inputs","type":"array"},"client_reference":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Your own identifier, carried forward from the idea (and the seed) this page came from. `null` for a page you added by hand without one.","title":"Client Reference"},"content_item_id":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"description":"The content item this page generated into. `null` until the page has been generated.","title":"Content Item Id"},"content_status":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The content item's own status, or `null` when no content item exists for this page yet.","title":"Content Status"},"created_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Created At"},"expansion":{"additionalProperties":true,"description":"How this page was derived: the template's expansion unit, the in-scope entities it covers, and the ideas it came from. For a page you added by hand this carries only the `entities` you supplied on create, and is empty if you supplied none.","title":"Expansion","type":"object"},"generation_state":{"$ref":"#/components/schemas/PublicProgramPageGenerationState","description":"How far this page has got. `not_approved` — you have not approved it, so it will not generate. `awaiting_generation` — approved and queued. `generating` — being written. `ready` — finished and downloadable. `content_deleted` — you deleted this page's content item; the page still names the old `content_item_id`, and the next `pages:generate` run writes a new one. `blocked` — approved, but the last generate run could not find a structured input the page needs; `blocked_inputs` names it, and the page is re-checked on the next run. A page under a `draft_only` property reaches `ready` and is never published, which is the point of that policy."},"id":{"format":"uuid","title":"Id","type":"string"},"program_id":{"format":"uuid","title":"Program Id","type":"string"},"state":{"$ref":"#/components/schemas/PublicProgramItemState"},"target_keyword":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Keyword"},"template_family":{"$ref":"#/components/schemas/TemplateFamily","description":"The template family this page was planned under. Recorded on the page, so changing your program later does not retroactively change what an already-planned page is. Same catalogue as `POST /programs` (`TemplateFamily`)."},"title":{"title":"Title","type":"string"},"updated_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Updated At"}},"required":["id","program_id","title","template_family","state","generation_state"],"title":"PublicProgramPage","type":"object"},"PublicProgramPageGenerationState":{"description":"How far a program page has travelled toward a downloadable article.\n\nDistinct from the approval state above, which records a customer decision.\nThis one records what the generate stage has done about that decision.\n\n``not_approved`` is deliberately its own value rather than being folded\ninto ``awaiting_generation``: a page the customer declined and a page they\nhave not decided on are BOTH absent from the generated set, and collapsing\nthem makes \"the declined page did not generate\" unfalsifiable.\n\n``ready`` means a version exists AND the content item is still live, so\n``GET /content/{content_item_id}`` returns a body. It is NOT the publish\nstatus. Program pages never terminate at ``ready_for_export`` and never\npark in a CMS-publish inbox — those are topic-autopilot outcomes. Under\neither property ``publish_policy``, generation stops at a downloadable\narticle; ``POST /content/{item_id}/publish`` is a separate opt-in that\nreturns 409 under ``draft_only``.\n\n``content_deleted`` is the state of a page whose content item was soft-\ndeleted. Deleting a content item RETAINS its versions for audit, so \"a\nversion exists\" outlives the item and cannot by itself mean the page is\ndownloadable — the row still names a ``content_item_id`` that\n``GET /content/{content_item_id}`` answers with a 404. It is its own value\nrather than a reuse of ``generating`` or ``awaiting_generation`` because\nboth of those say work is already in flight. Re-running\n``POST …/pages:generate`` rematerialises a new brief + content item: the\nwrite clears the dead back-link when the linked item is missing or\nsoft-deleted, then creates a fresh one. Until that re-run, a polling\nintegrator that only watches ``ready`` can stop — this state is stable\nbetween runs.\n\n``blocked`` is an approved page a generate run declined to write because a\nstructured input it needs was not available: for a ``comparison`` page an\nattribute matrix covering every compared entity (supplied, or researched\nby the platform), for an ``entity_review`` page supplied facts about its\nentity. The page keeps its approval and has no content item;\n``blocked_inputs`` names what is missing. Supply facts for the entities\nthe page covers (``POST /programs/{program_id}/facts``) and run\n``pages:generate`` again: the next run writes the page, blocks it again,\nor — when the input is now present but the page cannot be written for\nanother reason, such as an exhausted allowance — clears the marker so the\npage reads ``awaiting_generation``. The value is stable between runs, so a\npoller that only watches ``ready`` can stop on it. Facts reach a page only\nwhen it is written; a page that already has a content item keeps the brief\nit was written from. ``listicle`` pages are never blocked.","enum":["not_approved","awaiting_generation","generating","ready","content_deleted","blocked"],"title":"PublicProgramPageGenerationState","type":"string"},"PublicProgramPlanPage":{"description":"One page in a program's plan, and whether it is approved.\n\nThe plan is the concrete page list your template produces from the ideas you\napproved: for a comparison template over a set of entities it is every\npairing of them. Pages start `pending`. Only `approved` pages are written; a\n`declined` page is kept so you can change your mind, but it never generates.","properties":{"client_reference":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Your own identifier, carried forward from the idea (and the seed) this page came from. `null` for a page you added by hand without one.","title":"Client Reference"},"content_item_id":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"description":"The content item this page generated into. `null` until the page has been generated.","title":"Content Item Id"},"created_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Created At"},"expansion":{"additionalProperties":true,"description":"How this page was derived: the template's expansion unit, the in-scope entities it covers, and the ideas it came from. For a page you added by hand this carries only the `entities` you supplied on create, and is empty if you supplied none.","title":"Expansion","type":"object"},"id":{"format":"uuid","title":"Id","type":"string"},"program_id":{"format":"uuid","title":"Program Id","type":"string"},"state":{"$ref":"#/components/schemas/PublicProgramItemState"},"target_keyword":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Keyword"},"template_family":{"$ref":"#/components/schemas/TemplateFamily","description":"The template family this page was planned under. Recorded on the page, so changing your program later does not retroactively change what an already-planned page is. Same catalogue as `POST /programs` (`TemplateFamily`)."},"title":{"title":"Title","type":"string"},"updated_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Updated At"}},"required":["id","program_id","title","template_family","state"],"title":"PublicProgramPlanPage","type":"object"},"PublicProgramPlanPageCreate":{"additionalProperties":false,"description":"Add one page to a program's plan by hand.","properties":{"client_reference":{"anyOf":[{"maxLength":255,"type":"string"},{"type":"null"}],"description":"Your own identifier for this page. Echoed back on reads.","title":"Client Reference"},"entities":{"anyOf":[{"items":{"type":"string"},"maxItems":50,"type":"array"},{"type":"null"}],"description":"The entities this page is about, recorded as its `expansion.entities`. Supply these when your template family needs facts about named things — a page added without them has nothing for supplied facts to match, so it is refused at generate time and reads `blocked` however many facts you send. How many a page may carry is the family's own contract: see `entities_per_page_min` and `entities_per_page_max` on GET /program-templates. Names are matched to facts ignoring case and surrounding whitespace, so two spellings of one entity count once. Omit the field entirely to add a page with no entities.","title":"Entities"},"target_keyword":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"description":"The keyword this page targets.","title":"Target Keyword"},"title":{"description":"What the page is about.","maxLength":500,"minLength":1,"title":"Title","type":"string"}},"required":["title"],"title":"PublicProgramPlanPageCreate","type":"object"},"PublicProgramScope":{"additionalProperties":true,"description":"What a program covers: the entity set its template expands over.\n\nFor a comparison template the entities are the things being compared; for a\nlisticle they are the subjects each list is built around.\n\nOn read, unknown keys that a later template version may have stored are\npreserved so forward-compatible fields round-trip. Clients should ignore\nkeys they do not understand. Create rejects unknown keys inside scope with\n**422**.","properties":{"entities":{"description":"The entities this program covers. Blank entries are rejected; duplicates are collapsed, preserving the order first supplied.","items":{"type":"string"},"maxItems":500,"minItems":1,"title":"Entities","type":"array"}},"required":["entities"],"title":"PublicProgramScope","type":"object"},"PublicProgramScopeInput":{"additionalProperties":false,"description":"What a program covers on create: the entity set its template expands over.\n\nUnknown keys are rejected so a typo is a **422** rather than a scope that\nsilently covers less than you intended.","properties":{"entities":{"description":"The entities this program covers. Blank entries are rejected; duplicates are collapsed, preserving the order first supplied.","items":{"type":"string"},"maxItems":500,"minItems":1,"title":"Entities","type":"array"}},"required":["entities"],"title":"PublicProgramScopeInput","type":"object"},"PublicProgramSeedInput":{"additionalProperties":false,"description":"One submitted seed.\n\n``client_reference`` is the caller's own identifier for this seed. It is\nopaque to us and is carried onto every idea and plan page derived from the\nseed, so a caller can correlate what they submitted with what we generated.","properties":{"client_reference":{"anyOf":[{"maxLength":255,"type":"string"},{"type":"null"}],"description":"Your own identifier for this seed. Echoed back on every row derived from it.","title":"Client Reference"},"seed":{"description":"A keyword or phrase to research this program from.","maxLength":500,"minLength":1,"title":"Seed","type":"string"}},"required":["seed"],"title":"PublicProgramSeedInput","type":"object"},"PublicProgramStageAccepted":{"description":"A program stage has started. Poll `GET /jobs/{job_id}` for its progress.\n\nWhen the job reaches a terminal status, re-read the program to see its new\nstate and counts.","properties":{"job_id":{"format":"uuid","title":"Job Id","type":"string"},"program_state":{"$ref":"#/components/schemas/PublicProgramState","description":"The state the program entered when this stage started."},"status":{"$ref":"#/components/schemas/JobStatus"}},"required":["job_id","status","program_state"],"title":"PublicProgramStageAccepted","type":"object"},"PublicProgramState":{"description":"Lifecycle of a programmatic-SEO program.\n\nThe happy path runs ``draft`` -> ``researching`` -> ``ideas_ready`` ->\n``planning`` -> ``plan_ready`` -> ``generating`` -> ``pages_ready``.\n``failed`` is the single failure state; the program keeps the ideas and\nplan rows it already produced, so a caller retries by re-issuing the stage\nverb rather than by rebuilding the program.\n\n``researching``, ``planning`` and ``generating`` mean a stage job is in\nflight. No stage verb is accepted while the program sits in one of them.","enum":["draft","researching","ideas_ready","planning","plan_ready","generating","pages_ready","failed"],"title":"PublicProgramState","type":"string"},"PublicProgramTemplate":{"description":"One first-party programmatic-SEO template family.\n\nA family answers exactly two questions and nothing else: how a program's\nscope expands into a page list, and what the generator needs for one page of\nthat shape. Nothing specific to your site (slugs, title patterns, section\noutlines, attribute names) is part of a family — those come from the\nprogram's own scope, which is what lets one family serve many programs.","properties":{"display_name":{"description":"Human-readable label.","title":"Display Name","type":"string"},"entities_per_page_max":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Most in-scope entities that may appear on one page. `null` means unbounded — your program's scope supplies the ceiling.","title":"Entities Per Page Max"},"entities_per_page_min":{"description":"Fewest in-scope entities that may appear on one page.","title":"Entities Per Page Min","type":"integer"},"expansion_unit":{"$ref":"#/components/schemas/TemplateExpansionUnit","description":"What ONE page corresponds to: a combination of in-scope entities, a facet, or a single entity. Together with the entity bounds this is how many pages a given scope will produce."},"family":{"$ref":"#/components/schemas/TemplateFamily","description":"Stable identifier. Pass this as `template_family` when creating a program."},"required_generator_inputs":{"description":"The structured input kinds a page of this family is written against. They shape the generation prompt. Two of them also gate the write: `attribute_matrix` (`comparison`) and `entity_profiles` (`entity_review`) are supplied per entity through `POST /programs/{program_id}/facts` — the platform's generate-time research can also supply the matrix, and a fact you supplied wins over a researched one for the same entity and attribute. A page whose gated input is still unusable when `pages:generate` reaches it is marked `blocked` rather than written (`generation_state: blocked`, with `blocked_inputs` naming the kind) and counted on the generate job result as `pages_skipped_missing_inputs`; supply the facts and run `pages:generate` again. `listicle` pages are never blocked. The other kinds shape the prompt only and have no request field.","items":{"$ref":"#/components/schemas/TemplateGeneratorInput"},"title":"Required Generator Inputs","type":"array"},"summary":{"description":"One sentence on what pages this produces.","title":"Summary","type":"string"}},"required":["family","display_name","summary","expansion_unit","entities_per_page_min","required_generator_inputs"],"title":"PublicProgramTemplate","type":"object"},"PublicProperty":{"description":"A publishing property the org owns (where content is published).\n\nContent items are property-scoped; discover or create properties to target\nthem.","properties":{"brand_id":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Brand Id"},"channel_type":{"$ref":"#/components/schemas/ChannelType"},"created_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Created At"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"id":{"format":"uuid","title":"Id","type":"string"},"name":{"title":"Name","type":"string"},"publish_policy":{"$ref":"#/components/schemas/PublishPolicy"},"purpose":{"$ref":"#/components/schemas/PropertyPurpose"},"role":{"$ref":"#/components/schemas/PropertyRole"},"status":{"$ref":"#/components/schemas/EntityStatus"},"url":{"title":"Url","type":"string"},"verified":{"default":false,"title":"Verified","type":"boolean"}},"required":["id","name","url","channel_type","role","purpose","status","publish_policy"],"title":"PublicProperty","type":"object"},"PublicPropertyCreate":{"additionalProperties":false,"description":"Create a publishing property from the caller's own input.\n\nSupply an explicit owned ``brand_id``. Server-assigned fields\n(``verified``, ``created_at``) are also omitted; unknown keys return\n**422**.","properties":{"brand_id":{"format":"uuid","title":"Brand Id","type":"string"},"channel_type":{"$ref":"#/components/schemas/ChannelType","default":"blog"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"name":{"maxLength":255,"minLength":1,"title":"Name","type":"string"},"publish_policy":{"$ref":"#/components/schemas/PublishPolicy","default":"cms_publish"},"purpose":{"$ref":"#/components/schemas/PropertyPurpose","default":"thought_leadership"},"role":{"$ref":"#/components/schemas/PropertyRole","default":"primary"},"url":{"maxLength":255,"minLength":1,"title":"Url","type":"string"}},"required":["name","url","brand_id"],"title":"PublicPropertyCreate","type":"object"},"PublicPropertyUpdate":{"additionalProperties":false,"description":"Scoped patch for an existing property.\n\nOnly ``publish_policy`` is writable on the public surface today — name/url\nand other fields stay on the session-authed internal property routes. The\nfield is **required** (not optional-with-default): an empty body is a 422 so\na client cannot call PATCH and leave the policy unchanged by accident.\n\nExplicit ``null`` is also a 422 (the column is NOT NULL). Unknown keys are\nrejected.","properties":{"publish_policy":{"$ref":"#/components/schemas/PublishPolicy"}},"required":["publish_policy"],"title":"PublicPropertyUpdate","type":"object"},"PublicPublishAccepted":{"description":"202 for an enqueued publish.\n\nRetries of an already-enqueued publish return 202 with the original\n``job_id`` and ``was_duplicate_lookup=true`` instead of starting a second\npublish — clients may retry freely.","properties":{"job_id":{"description":"Poll jobs/{job_id} under the same Public API version and organization prefix used for this request.","format":"uuid","title":"Job Id","type":"string"},"scheduled_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"description":"Echo of the resolved schedule time when mode=schedule.","title":"Scheduled At"},"was_duplicate_lookup":{"default":false,"description":"True when this request collided with an already-enqueued publish of the same (item, version, mode) and the existing job was returned.","title":"Was Duplicate Lookup","type":"boolean"}},"required":["job_id"],"title":"PublicPublishAccepted","type":"object"},"PublicPublishMode":{"description":"How to publish: as a CMS draft, live now, scheduled, or torn back down.\n\n``unpublish`` removes a remote document that is already live. It is allowed\neven on a ``draft_only`` property, and it never provisions a publish\ndestination: an item with no publish target has nothing to tear down.","enum":["draft","live","schedule","unpublish"],"title":"PublicPublishMode","type":"string"},"PublicPublishRequest":{"additionalProperties":false,"description":"Publish or schedule a content item to the org's connected CMS.","properties":{"mode":{"$ref":"#/components/schemas/PublicPublishMode","description":"draft = push as a CMS draft; live = publish immediately; schedule = publish at schedule_at (which then becomes required); unpublish = tear down a remote document that is already live."},"schedule_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"description":"Required when mode=schedule, rejected otherwise. Must be in the future and timezone-aware.","title":"Schedule At"}},"required":["mode"],"title":"PublicPublishRequest","type":"object"},"PublicQuotaResource":{"description":"One monthly metered resource for the authenticated org. ``remaining`` is included allowance left (not overage headroom). When ``overage_enabled`` is true and usage is past ``limit``, ``remaining`` is 0 but ``is_blocked`` stays false — further spend is allowed and billed.","properties":{"current":{"title":"Current","type":"integer"},"is_blocked":{"title":"Is Blocked","type":"boolean"},"limit":{"title":"Limit","type":"integer"},"overage_enabled":{"title":"Overage Enabled","type":"boolean"},"remaining":{"title":"Remaining","type":"integer"},"resource_type":{"$ref":"#/components/schemas/PublicAccountQuotaResourceType"}},"required":["resource_type","current","limit","remaining","overage_enabled","is_blocked"],"title":"PublicQuotaResource","type":"object"},"PublicReviewHold":{"description":"One finding that held a saved draft for review.\n\nkind is the finding kind, for example cite_lint, drift_h2_missing or a\nbrief_ rubric kind. text names what to check. For cite_lint it starts\nwith the source-page reason (fetch_failed, not_on_page, ineligible,\nnot_public or budget_exhausted), followed by the citing sentence and the\nURL.","properties":{"kind":{"title":"Kind","type":"string"},"text":{"title":"Text","type":"string"}},"required":["kind","text"],"title":"PublicReviewHold","type":"object"},"PublicRewriteDocuments":{"additionalProperties":false,"description":"Document-library selection for a rewrite (auto / none / selected).","properties":{"ids":{"items":{"format":"uuid","type":"string"},"title":"Ids","type":"array"},"mode":{"default":"auto","enum":["auto","none","selected"],"title":"Mode","type":"string"}},"title":"PublicRewriteDocuments","type":"object"},"PublicRewriteRequest":{"additionalProperties":false,"description":"Submit Markdown to be rewritten to the brand voice.\n\n``property_id`` is required so the source item is property-scoped for\nlater CMS publish. Markdown body is required.","properties":{"brand_id":{"format":"uuid","title":"Brand Id","type":"string"},"content":{"maxLength":50000,"minLength":1,"title":"Content","type":"string"},"documents":{"$ref":"#/components/schemas/PublicRewriteDocuments"},"instructions":{"anyOf":[{"maxLength":5000,"type":"string"},{"type":"null"}],"title":"Instructions"},"pillar_id":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Pillar Id"},"property_id":{"format":"uuid","title":"Property Id","type":"string"},"title":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"title":"Title"}},"required":["brand_id","property_id","content"],"title":"PublicRewriteRequest","type":"object"},"PublicRewriteResponse":{"description":"Accepted-rewrite envelope; poll ``GET /jobs/{job_id}`` and then fetch ``GET /content/{content_item_id}`` for the v2 rewrite.","properties":{"content_item_id":{"format":"uuid","title":"Content Item Id","type":"string"},"job_id":{"format":"uuid","title":"Job Id","type":"string"},"status":{"title":"Status","type":"string"}},"required":["job_id","content_item_id","status"],"title":"PublicRewriteResponse","type":"object"},"PublicSuppliedFact":{"description":"A fact you supplied with no source URL, as given to the writer.\n\nIt carries no link in the body, so it is listed here rather than in\n``sources`` or ``assertion_provenance``. Recorded on the version when it\nis written, so later kit changes do not alter it. ``[]`` for a v1\nversion; the version's list is ``null`` when unknown (a v2 version saved\nbefore this was recorded whose content kit has since changed).","properties":{"attribution":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Attribution"},"claim_id":{"title":"Claim Id","type":"string"},"text":{"title":"Text","type":"string"}},"required":["claim_id","text"],"title":"PublicSuppliedFact","type":"object"},"PublicTag":{"description":"A tag (response).","properties":{"brand_id":{"format":"uuid","title":"Brand Id","type":"string"},"id":{"format":"uuid","title":"Id","type":"string"},"name":{"title":"Name","type":"string"},"parent_id":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Parent Id"},"slug":{"title":"Slug","type":"string"},"usage_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":0,"title":"Usage Count"}},"required":["id","brand_id","name","slug"],"title":"PublicTag","type":"object"},"PublicTagCreate":{"additionalProperties":false,"description":"Create a tag.","properties":{"brand_id":{"format":"uuid","title":"Brand Id","type":"string"},"name":{"maxLength":50,"minLength":1,"title":"Name","type":"string"},"slug":{"anyOf":[{"maxLength":50,"minLength":1,"pattern":"^[a-z0-9-]+$","type":"string"},{"type":"null"}],"title":"Slug"}},"required":["brand_id","name"],"title":"PublicTagCreate","type":"object"},"PublicTagUpdate":{"additionalProperties":false,"description":"Patch a tag (only set fields are applied).\n\nBoth keys are omit-only (``PublicTagUpdateOmitOnlyField``): omitting one\nleaves it unchanged, and an explicit ``null`` returns **422**.","properties":{"name":{"maxLength":50,"minLength":1,"title":"Name","type":"string"},"slug":{"maxLength":50,"minLength":1,"pattern":"^[a-z0-9-]+$","title":"Slug","type":"string"}},"title":"PublicTagUpdate","type":"object"},"PublicTopic":{"description":"A topic-bank idea the caller can target for generation.\n\nIncludes keyword market signals (search volume, difficulty, cpc, intent)\nand an autopilot eligibility hint. Market fields may be null on single-topic\nreads; list reads with scores populate them when available.","properties":{"brand_id":{"format":"uuid","title":"Brand Id","type":"string"},"cpc":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Cpc"},"decision_band":{"anyOf":[{"$ref":"#/components/schemas/DecisionBand"},{"type":"null"}]},"eligible_for_autopilot":{"title":"Eligible For Autopilot","type":"boolean"},"funnel_stage":{"anyOf":[{"$ref":"#/components/schemas/FunnelStage"},{"type":"null"}]},"id":{"format":"uuid","title":"Id","type":"string"},"intent":{"anyOf":[{"$ref":"#/components/schemas/SearchIntent"},{"type":"null"}]},"keyword_difficulty":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Keyword Difficulty"},"pillar_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pillar Name"},"premise":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Premise"},"primary_keyword":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Primary Keyword"},"search_volume":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Search Volume"},"status":{"anyOf":[{"$ref":"#/components/schemas/TopicIdeaStatus"},{"type":"null"}]},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"total_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Total Score"}},"required":["id","brand_id","eligible_for_autopilot"],"title":"PublicTopic","type":"object"},"PublicTopicCreate":{"additionalProperties":false,"description":"Create a topic from the caller's own input, then generate content from it.\n\nSupply the angle and keywords; scoring signals are derived by the system.\nA newly created topic is immediately eligible for ``POST /content/generate``.\n``primary_keyword`` is required — generation seeds from it (title/premise\nalone are not enough and would produce generic content).","properties":{"funnel_stage":{"$ref":"#/components/schemas/FunnelStage","default":"tofu"},"intent":{"$ref":"#/components/schemas/SearchIntent","default":"informational"},"pillar_id":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Pillar Id"},"premise":{"anyOf":[{"maxLength":5000,"type":"string"},{"type":"null"}],"title":"Premise"},"primary_keyword":{"maxLength":200,"minLength":1,"title":"Primary Keyword","type":"string"},"secondary_keywords":{"items":{"type":"string"},"maxItems":20,"title":"Secondary Keywords","type":"array"},"suggested_format":{"$ref":"#/components/schemas/ContentFormat","default":"blog_post"},"title":{"maxLength":500,"minLength":1,"title":"Title","type":"string"}},"required":["title","primary_keyword"],"title":"PublicTopicCreate","type":"object"},"PublicTopicGenerationRequest":{"additionalProperties":false,"description":"Start an async topic-generation batch for a brand.\n\nOptional ``pillar_id`` pins generation to one active pillar; optional\n``property_id`` sets scoring context. ``requested_count`` defaults to 50\n(1–500).","properties":{"pillar_id":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Pillar Id"},"property_id":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Property Id"},"requested_count":{"default":50,"maximum":500,"minimum":1,"title":"Requested Count","type":"integer"}},"title":"PublicTopicGenerationRequest","type":"object"},"PublicTopicGenerationResponse":{"description":"Accepted topic-generation batch; poll ``GET /jobs/{job_id}`` for completion.\n\n``status`` is ``running`` at kickoff, or ``queued`` if the run is not yet\nassigned.","properties":{"batch_id":{"format":"uuid","title":"Batch Id","type":"string"},"job_id":{"format":"uuid","title":"Job Id","type":"string"},"status":{"$ref":"#/components/schemas/JobStatus"},"workflow_id":{"title":"Workflow Id","type":"string"}},"required":["job_id","batch_id","workflow_id","status"],"title":"PublicTopicGenerationResponse","type":"object"},"PublicTopicRescoreRequest":{"additionalProperties":false,"description":"Re-score a brand's curated topics on demand.\n\n``property_id`` is required. Optional ``topic_ids`` limits the set;\noptional ``force_seo_refresh`` re-fetches market keyword data first.","properties":{"force_seo_refresh":{"default":false,"title":"Force Seo Refresh","type":"boolean"},"property_id":{"format":"uuid","title":"Property Id","type":"string"},"topic_ids":{"anyOf":[{"items":{"format":"uuid","type":"string"},"type":"array"},{"type":"null"}],"title":"Topic Ids"}},"required":["property_id"],"title":"PublicTopicRescoreRequest","type":"object"},"PublicTopicRescoreResponse":{"description":"Accepted-rescore envelope; poll ``GET /jobs/{job_id}`` for the summary.","properties":{"job_id":{"format":"uuid","title":"Job Id","type":"string"},"status":{"$ref":"#/components/schemas/JobStatus"}},"required":["job_id","status"],"title":"PublicTopicRescoreResponse","type":"object"},"PublicTopicScore":{"description":"A persisted (cached) topic score for one property.\n\nReturned by the cached scores read. Does not trigger scoring or provider usage.","properties":{"confidence":{"title":"Confidence","type":"number"},"decision_band":{"anyOf":[{"$ref":"#/components/schemas/DecisionBand"},{"type":"null"}]},"dimension_scores":{"additionalProperties":{"type":"number"},"title":"Dimension Scores","type":"object"},"property_id":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Property Id"},"scored_at":{"format":"date-time","title":"Scored At","type":"string"},"scoring_model_version":{"title":"Scoring Model Version","type":"string"},"seo_metrics":{"$ref":"#/components/schemas/PublicTopicScoreSeoMetrics"},"total_score":{"title":"Total Score","type":"number"},"weights":{"additionalProperties":{"type":"number"},"title":"Weights","type":"object"}},"required":["total_score","confidence","dimension_scores","weights","scored_at","scoring_model_version","seo_metrics"],"title":"PublicTopicScore","type":"object"},"PublicTopicScoreSeoMetrics":{"description":"Curated keyword market signals attached to a topic score.\n\nOnly third-party market data (volume, difficulty, cpc, competition). Fields\nmay be null when metrics were never fetched or are not yet available;\nmissing values stay null rather than defaulting to 0.","properties":{"competition":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Competition"},"cpc":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Cpc"},"keyword_difficulty":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Keyword Difficulty"},"search_volume":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Search Volume"}},"title":"PublicTopicScoreSeoMetrics","type":"object"},"PublicVersionedRelevantLink":{"description":"One approved website link bound to a saved generation version.","properties":{"anchor":{"title":"Anchor","type":"string"},"id":{"title":"Id","type":"string"},"locale":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Indexed page locale frozen with the generation version.","title":"Locale"},"requirement":{"default":"optional","title":"Requirement","type":"string"},"url":{"title":"Url","type":"string"},"usage":{"default":"","title":"Usage","type":"string"}},"required":["id","url","anchor"],"title":"PublicVersionedRelevantLink","type":"object"},"PublicVersionedRelevantLinks":{"description":"Read-only export of a saved version's approved website links.","properties":{"links":{"items":{"$ref":"#/components/schemas/PublicVersionedRelevantLink"},"title":"Links","type":"array"},"version_id":{"format":"uuid","title":"Version Id","type":"string"}},"required":["version_id"],"title":"PublicVersionedRelevantLinks","type":"object"},"PublishPolicy":{"description":"How finished pages for a publishing property leave RoboWrite.\n\n``cms_publish`` (the default) auto-publishes a finished page to the\norganization's connected CMS. Without a connected CMS, generation runs for\nthe property stop and wait for a person in the RoboWrite dashboard.\n\n``draft_only`` means you collect finished pages yourself: runs complete on\ntheir own, the page is downloaded with\n``GET /api/public/v1/content/{content_item_id}``, and\n``POST /api/public/v1/content/{item_id}/publish`` answers 409 because there\nis no destination to publish to.","enum":["draft_only","cms_publish"],"title":"PublishPolicy","type":"string"},"ReadingLevel":{"enum":["practitioner","executive","beginner"],"title":"ReadingLevel","type":"string"},"ReadingLevelSpec":{"additionalProperties":false,"description":"The reader level the article targets. No level: not judged.","properties":{"level":{"anyOf":[{"$ref":"#/components/schemas/ArticleReadingLevel"},{"type":"null"}]},"requirement":{"$ref":"#/components/schemas/ElementRequirement","default":"optional"}},"title":"ReadingLevelSpec","type":"object"},"RegulatedIndustry":{"description":"Org-level regulated content policy industry values.\n\nUsed when configuring regulated-content policy and projecting compliance\nfindings on generated drafts.","enum":["finance","healthcare","legal"],"title":"RegulatedIndustry","type":"string"},"RegulatedPolicyFindingKind":{"description":"Deterministic regulated-content policy finding kinds.\n\nReturned on public content reads with ``?include=compliance``. Stable\nmachine-readable values for branching on compliance findings.\n\n``MISSING_DISCLAIMER`` marks a still-missing per-industry regulated\ndisclaimer; generation adds the canonical footer so a clean shipped draft\nclears it.","enum":["unsourced_figure","advice_tone","off_brand_promotion","missing_disclaimer"],"title":"RegulatedPolicyFindingKind","type":"string"},"RelevantLinkSpec":{"additionalProperties":false,"description":"A navigation link the article should carry (not a citation).","properties":{"anchor":{"maxLength":80,"minLength":1,"title":"Anchor","type":"string"},"id":{"description":"Lowercase slug that identifies the link in the spec.","maxLength":64,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$","title":"Id","type":"string"},"requirement":{"$ref":"#/components/schemas/ElementRequirement","default":"optional"},"url":{"title":"Url","type":"string"},"usage":{"default":"","maxLength":200,"title":"Usage","type":"string"}},"required":["id","url","anchor"],"title":"RelevantLinkSpec","type":"object"},"RequiredElementReason":{"description":"Why a brief-required element is missing from the kit.","enum":["no_admitted_evidence","build_failed","below_min_items","below_min_sources","required_source_not_admitted"],"title":"RequiredElementReason","type":"string"},"ReviewAction":{"enum":["approve","reject","request_revision"],"title":"ReviewAction","type":"string"},"ReviewAssignment":{"properties":{"actor_id":{"title":"Actor Id","type":"string"},"assignment_revision":{"title":"Assignment Revision","type":"integer"},"content_version_id":{"format":"uuid","title":"Content Version Id","type":"string"},"created_at":{"format":"date-time","title":"Created At","type":"string"},"id":{"format":"uuid","title":"Id","type":"string"},"organization_id":{"title":"Organization Id","type":"string"},"previous_reviewer_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Previous Reviewer Id"},"request_id":{"format":"uuid","title":"Request Id","type":"string"},"review_id":{"format":"uuid","title":"Review Id","type":"string"},"reviewer_id":{"title":"Reviewer Id","type":"string"}},"required":["id","organization_id","review_id","content_version_id","actor_id","reviewer_id","previous_reviewer_id","assignment_revision","request_id","created_at"],"title":"ReviewAssignment","type":"object"},"ReviewAssignmentRequest":{"additionalProperties":false,"properties":{"content_version_id":{"format":"uuid","title":"Content Version Id","type":"string"},"expected_assignment_revision":{"minimum":0,"title":"Expected Assignment Revision","type":"integer"},"request_id":{"format":"uuid","title":"Request Id","type":"string"},"reviewer_id":{"maxLength":256,"minLength":1,"pattern":"^\\S+$","title":"Reviewer Id","type":"string"}},"required":["content_version_id","request_id","reviewer_id","expected_assignment_revision"],"title":"ReviewAssignmentRequest","type":"object"},"ReviewCreateRequest":{"additionalProperties":false,"properties":{"content_version_id":{"format":"uuid","title":"Content Version Id","type":"string"}},"required":["content_version_id"],"title":"ReviewCreateRequest","type":"object"},"ReviewDecision":{"properties":{"action":{"$ref":"#/components/schemas/ReviewAction"},"actor_id":{"title":"Actor Id","type":"string"},"body_sha256":{"title":"Body Sha256","type":"string"},"content_item_id":{"format":"uuid","title":"Content Item Id","type":"string"},"content_version_id":{"format":"uuid","title":"Content Version Id","type":"string"},"created_at":{"format":"date-time","title":"Created At","type":"string"},"feedback":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Feedback"},"id":{"format":"uuid","title":"Id","type":"string"},"organization_id":{"title":"Organization Id","type":"string"},"request_id":{"format":"uuid","title":"Request Id","type":"string"},"review_id":{"format":"uuid","title":"Review Id","type":"string"},"reviewer_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reviewer Id"}},"required":["id","review_id","organization_id","content_item_id","content_version_id","body_sha256","reviewer_id","actor_id","request_id","action","feedback","created_at"],"title":"ReviewDecision","type":"object"},"ReviewDecisionRequest":{"additionalProperties":false,"properties":{"action":{"$ref":"#/components/schemas/ReviewAction"},"content_version_id":{"format":"uuid","title":"Content Version Id","type":"string"},"feedback":{"anyOf":[{"maxLength":10000,"type":"string"},{"type":"null"}],"title":"Feedback"},"request_id":{"format":"uuid","title":"Request Id","type":"string"}},"required":["content_version_id","request_id","action"],"title":"ReviewDecisionRequest","type":"object"},"ReviewList":{"properties":{"items":{"items":{"$ref":"#/components/schemas/EditorialReview"},"title":"Items","type":"array"},"total":{"title":"Total","type":"integer"}},"required":["items","total"],"title":"ReviewList","type":"object"},"ReviewStatus":{"enum":["pending","approved","rejected","revision_requested"],"title":"ReviewStatus","type":"string"},"ReviewedProductIssuerAlias":{"additionalProperties":false,"description":"An owner-reviewed product identity bound to an issuer in the same rule.","properties":{"issuer":{"minLength":1,"title":"Issuer","type":"string"},"product":{"minLength":1,"title":"Product","type":"string"}},"required":["product","issuer"],"title":"ReviewedProductIssuerAlias","type":"object"},"ReviewedSourceRule":{"additionalProperties":false,"properties":{"authority":{"$ref":"#/components/schemas/SourceAuthority"},"domain":{"title":"Domain","type":"string"},"entities":{"items":{"type":"string"},"title":"Entities","type":"array"},"include_subdomains":{"default":false,"title":"Include Subdomains","type":"boolean"},"path_prefixes":{"items":{"type":"string"},"title":"Path Prefixes","type":"array"},"permitted_claim_types":{"items":{"$ref":"#/components/schemas/SourceClaimType"},"title":"Permitted Claim Types","type":"array"},"product_issuer_aliases":{"items":{"$ref":"#/components/schemas/ReviewedProductIssuerAlias"},"title":"Product Issuer Aliases","type":"array"},"review_evidence_url":{"format":"uri","maxLength":2083,"minLength":1,"title":"Review Evidence Url","type":"string"},"review_notes":{"maxLength":4000,"minLength":1,"title":"Review Notes","type":"string"},"reviewed_at":{"format":"date-time","title":"Reviewed At","type":"string"}},"required":["domain","authority","review_evidence_url","review_notes","reviewed_at"],"title":"ReviewedSourceRule","type":"object"},"SearchIntent":{"description":"User intent classification for SEO.","enum":["informational","navigational","transactional","commercial"],"title":"SearchIntent","type":"string"},"SophisticationLevel":{"description":"Audience domain expertise level.","enum":["novice","intermediate","expert"],"title":"SophisticationLevel","type":"string"},"SortDirection":{"description":"Sort direction for list endpoints: ``asc`` or ``desc``.","enum":["asc","desc"],"title":"SortDirection","type":"string"},"SourceAuthority":{"enum":["government","organization","issuer","merchant","excluded"],"title":"SourceAuthority","type":"string"},"SourceClaimType":{"enum":["general_fact","card_rate","card_benefit","own_terms"],"title":"SourceClaimType","type":"string"},"SourceVerificationFailureMode":{"description":"Recovery behavior; source verification is always mandatory.","enum":["repair_then_fail","fail_fast"],"title":"SourceVerificationFailureMode","type":"string"},"StatsSpec":{"additionalProperties":false,"description":"How many stats a required stats element needs.","properties":{"min_items":{"default":1,"maximum":10,"minimum":1,"title":"Min Items","type":"integer"}},"title":"StatsSpec","type":"object"},"TaskStatus":{"description":"Workflow status of content tasks.","enum":["planned","ready","generating","draft","in_review","approved","published","cancelled"],"title":"TaskStatus","type":"string"},"TechnicalCapability":{"additionalProperties":false,"description":"A single capability of a technical system: name + short description.","properties":{"description":{"maxLength":400,"minLength":1,"title":"Description","type":"string"},"name":{"maxLength":160,"minLength":1,"title":"Name","type":"string"}},"required":["name","description"],"title":"TechnicalCapability","type":"object"},"TechnicalDepth":{"description":"Level of technical content appropriate for audience.","enum":["non_technical","semi_technical","technical","highly_technical"],"title":"TechnicalDepth","type":"string"},"TechnicalSpecSummary":{"additionalProperties":false,"properties":{"capabilities":{"items":{"$ref":"#/components/schemas/TechnicalCapability"},"maxItems":15,"minItems":1,"title":"Capabilities","type":"array"},"category":{"const":"technical_spec","default":"technical_spec","title":"Category","type":"string"},"constraints":{"default":[],"items":{"maxLength":240,"minLength":1,"type":"string"},"maxItems":10,"title":"Constraints","type":"array"},"factual_assertions":{"default":[],"items":{"maxLength":240,"minLength":1,"type":"string"},"maxItems":10,"title":"Factual Assertions","type":"array"},"glossary":{"default":[],"items":{"$ref":"#/components/schemas/BrandTerm"},"maxItems":15,"title":"Glossary","type":"array"},"integrations":{"default":[],"items":{"maxLength":160,"minLength":1,"type":"string"},"maxItems":15,"title":"Integrations","type":"array"},"known_limitations":{"default":[],"items":{"maxLength":240,"minLength":1,"type":"string"},"maxItems":8,"title":"Known Limitations","type":"array"},"purpose":{"maxLength":400,"minLength":1,"title":"Purpose","type":"string"},"supported_platforms":{"default":[],"items":{"maxLength":120,"minLength":1,"type":"string"},"maxItems":10,"title":"Supported Platforms","type":"array"},"system_name":{"maxLength":160,"minLength":1,"title":"System Name","type":"string"}},"required":["system_name","purpose","capabilities"],"title":"TechnicalSpecSummary","type":"object"},"TemplateExpansionUnit":{"description":"What one page of an expanded program corresponds to.\n\nThis decides how many pages a scope produces: one page per combination of\nin-scope entities, one page per facet, or one page per entity.","enum":["entity_pair","entity_facet","single_entity"],"title":"TemplateExpansionUnit","type":"string"},"TemplateFamily":{"description":"Page archetype a programmatic-SEO program builds.","enum":["comparison","listicle","entity_review"],"title":"TemplateFamily","type":"string"},"TemplateGeneratorInput":{"description":"A structured input kind the generator is told to build a page around.\n\nThese are generic input kinds. The concrete values behind each kind come\nfrom the program's own scope and the facts recorded for it, so a family\nstays reusable.\n\nTwo kinds also gate the write. `attribute_matrix` (a `comparison` page)\nand `entity_profiles` (an `entity_review` page) are supplied per entity\nthrough `POST /programs/{program_id}/facts`; the platform's generate-time\nresearch can also supply the matrix, and a supplied fact wins over a\nresearched one for the same entity and attribute. A page whose gated\ninput is still unusable is marked `blocked` at the generate stage rather\nthan written (`generation_state: blocked`, with `blocked_inputs` naming\nthe kind) and counted on the generate job result as\n`pages_skipped_missing_inputs`; supply the facts and run `pages:generate`\nagain. `listicle` pages are never blocked. The other kinds shape the\ngeneration prompt and nothing else, and have no request field.","enum":["entity_profiles","attribute_matrix","facet_definition","ranking_criterion","verdict_criteria"],"title":"TemplateGeneratorInput","type":"string"},"TopicIdeaStatus":{"description":"Lifecycle status of topic ideas in the bank.","enum":["suggested","selected","rejected","converted","expired"],"title":"TopicIdeaStatus","type":"string"},"UserFactPriority":{"enum":["normal","must_use"],"title":"UserFactPriority","type":"string"},"ValidationError":{"properties":{"ctx":{"title":"Context","type":"object"},"input":{"title":"Input"},"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"title":"Location","type":"array"},"msg":{"title":"Message","type":"string"},"type":{"title":"Error Type","type":"string"}},"required":["loc","msg","type"],"title":"ValidationError","type":"object"},"VoiceSpec":{"additionalProperties":false,"description":"Up to two voice lines added to the brand voice for this article.","properties":{"extra_rules":{"items":{"type":"string"},"maxItems":2,"title":"Extra Rules","type":"array"},"requirement":{"$ref":"#/components/schemas/ElementRequirement","default":"optional"}},"title":"VoiceSpec","type":"object"},"WorkspaceAccessChecks":{"description":"Fresh workspace checks, separate from consent and action-specific gates.","properties":{"deletion_blocked":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Deletion Blocked"},"membership_confirmed":{"const":true,"title":"Membership Confirmed","type":"boolean"},"role_supported":{"title":"Role Supported","type":"boolean"},"security_eligibility":{"anyOf":[{"$ref":"#/components/schemas/OrganizationEligibility"},{"type":"null"}]}},"required":["membership_confirmed","role_supported","security_eligibility","deletion_blocked"],"title":"WorkspaceAccessChecks","type":"object"},"_TopicSortBy":{"description":"Closed set of topic list sort fields exposed in the public API.","enum":["total_score","search_volume","keyword_difficulty","created_at"],"title":"_TopicSortBy","type":"string"}},"securitySchemes":{"HTTPBearer":{"scheme":"bearer","type":"http"},"RoboWriteMultiOrgOAuth":{"flows":{"authorizationCode":{"authorizationUrl":"https://clerk.robowrite.ai/oauth/authorize","scopes":{"robowrite:content:all_orgs":"Read and manage content in every eligible workspace you belong to now or join later, subject to current access and allowances.","robowrite:organizations:read":"Read your current workspace memberships and access eligibility.","robowrite:publish:all_orgs":"Publish in eligible workspaces, only with enabled publication and explicit review and approval."},"tokenUrl":"https://clerk.robowrite.ai/oauth/token"}},"type":"oauth2"}}},"info":{"description":"Consumer-facing content lifecycle API (discover → create → generate → edit → read). Authenticate with an organization-scoped API key or an authorized agent OAuth access token via `Authorization: Bearer <TOKEN>`. Agent access requires browser sign-in and organization consent. See the public integration guide (API.md) for pagination, errors, idempotency, and rate limits.\n\n**Programs is parked.** Every `/programs` operation below is enabled per organization and returns `403` until yours is enabled — the shape is published so you can build against it, not because it is callable today. Ask support to enable Programs for your organization.","title":"RoboWrite Public API","version":"1.0.0"},"openapi":"3.1.0","paths":{"/api/public/v1/account":{"get":{"description":"Return org, brands accessible to the key, monthly quota, overage flags, and integration capabilities.","operationId":"get_account_api_public_v1_account_get","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicAccount"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Organization not found for API-key context"}},"summary":"Get Account","tags":["public-api"]}},"/api/public/v1/article-templates":{"get":{"description":"List built-in article presets followed by your organization's templates. Archived templates are omitted unless requested. Follow has_more using offset and limit.","operationId":"list_article_templates_api_public_v1_article_templates_get","parameters":[{"in":"query","name":"include_archived","required":false,"schema":{"default":false,"title":"Include Archived","type":"boolean"}},{"in":"query","name":"offset","required":false,"schema":{"default":0,"minimum":0,"title":"Offset","type":"integer"}},{"in":"query","name":"limit","required":false,"schema":{"default":50,"maximum":200,"minimum":1,"title":"Limit","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ArticleTemplatePage"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"List Article Templates","tags":["public-api"]}},"/api/public/v1/article-templates/{template_id}":{"get":{"description":"Read an article preset by built-in key or organization template UUID. Includes archived templates. A missing or foreign UUID returns 404.","operationId":"get_article_template_api_public_v1_article_templates__template_id__get","parameters":[{"in":"path","name":"template_id","required":true,"schema":{"anyOf":[{"$ref":"#/components/schemas/ArticleTemplateKey"},{"format":"uuid","type":"string"}],"title":"Template Id"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ArticleTemplateRecord"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Get Article Template","tags":["public-api"]}},"/api/public/v1/audiences":{"get":{"description":"List a brand's audiences, optionally filtered by status, in pages of up to 200.","operationId":"list_audiences_api_public_v1_audiences_get","parameters":[{"description":"Brand whose audiences to list","in":"query","name":"brand_id","required":true,"schema":{"description":"Brand whose audiences to list","format":"uuid","title":"Brand Id","type":"string"}},{"in":"query","name":"status","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/EntityStatus"},{"type":"null"}],"title":"Status"}},{"description":"Results per page","in":"query","name":"limit","required":false,"schema":{"default":50,"description":"Results per page","maximum":200,"minimum":1,"title":"Limit","type":"integer"}},{"description":"Pagination offset","in":"query","name":"offset","required":false,"schema":{"default":0,"description":"Pagination offset","minimum":0,"title":"Offset","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicPage_PublicAudience_"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"List Audiences","tags":["public-api"]},"post":{"description":"Create an audience for a brand you own.\n\nThe ``Idempotency-Key`` header is **optional**: with one, a retry of the\nsame body replays the original audience (``Idempotency-Replayed: true``);\nthe same key with a different body returns **409**.","operationId":"create_audience_api_public_v1_audiences_post","parameters":[{"in":"header","name":"Idempotency-Key","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicAudienceCreate"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicAudience"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Brand not found (absent or not owned by the org)"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"The Idempotency-Key was reused with a different payload"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Create Audience","tags":["public-api"]}},"/api/public/v1/audiences/{audience_id}":{"delete":{"description":"Delete an audience. Returns 204 with no body; 404 when it does not exist or belongs to another organization.","operationId":"delete_audience_api_public_v1_audiences__audience_id__delete","parameters":[{"in":"path","name":"audience_id","required":true,"schema":{"format":"uuid","title":"Audience Id","type":"string"}}],"responses":{"204":{"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Audience not found (absent or not owned by the org)"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Delete Audience","tags":["public-api"]},"get":{"description":"Read one audience, including its pain points. Returns 404 when it does not exist or belongs to another organization.","operationId":"get_audience_api_public_v1_audiences__audience_id__get","parameters":[{"in":"path","name":"audience_id","required":true,"schema":{"format":"uuid","title":"Audience Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicAudience"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Audience not found (absent or not owned by the org)"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Get Audience","tags":["public-api"]},"patch":{"description":"Partially update an audience: omitted fields stay unchanged. Returns the updated audience.","operationId":"update_audience_api_public_v1_audiences__audience_id__patch","parameters":[{"in":"path","name":"audience_id","required":true,"schema":{"format":"uuid","title":"Audience Id","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicAudienceUpdate"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicAudience"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Audience not found (absent or not owned by the org)"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Update Audience","tags":["public-api"]}},"/api/public/v1/authors":{"get":{"description":"List authors for the org, as a PublicPage carrying the full total.","operationId":"list_authors_api_public_v1_authors_get","parameters":[{"description":"Results per page","in":"query","name":"limit","required":false,"schema":{"default":50,"description":"Results per page","maximum":200,"minimum":1,"title":"Limit","type":"integer"}},{"description":"Pagination offset","in":"query","name":"offset","required":false,"schema":{"default":0,"description":"Pagination offset","minimum":0,"title":"Offset","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicPage_PublicAuthor_"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"List Authors","tags":["public-api"]},"post":{"description":"Create an author byline for your organization.\n\nThe ``Idempotency-Key`` header is **optional**: with one, a retry of the\nsame body replays the original author (``Idempotency-Replayed: true``); the\nsame key with a different body returns **409**.","operationId":"create_author_api_public_v1_authors_post","parameters":[{"in":"header","name":"Idempotency-Key","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicAuthorCreate"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicAuthor"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Idempotency-Key reused with a different payload"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Create Author","tags":["public-api"]}},"/api/public/v1/authors/{author_id}":{"delete":{"description":"Remove an author from your organization. Returns 204 with no body; 404 when the author is not in your organization.","operationId":"delete_author_api_public_v1_authors__author_id__delete","parameters":[{"in":"path","name":"author_id","required":true,"schema":{"format":"uuid","title":"Author Id","type":"string"}}],"responses":{"204":{"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Author not found (absent or not owned by the org)"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Delete Author","tags":["public-api"]},"get":{"description":"Read one author profile available to your organization.","operationId":"get_author_api_public_v1_authors__author_id__get","parameters":[{"in":"path","name":"author_id","required":true,"schema":{"format":"uuid","title":"Author Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicAuthor"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Author not found (absent or not owned by the org)"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Get Author","tags":["public-api"]},"patch":{"description":"Partially update an author profile: omitted fields stay unchanged. Returns the updated author.","operationId":"update_author_api_public_v1_authors__author_id__patch","parameters":[{"in":"path","name":"author_id","required":true,"schema":{"format":"uuid","title":"Author Id","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicAuthorUpdate"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicAuthor"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Author not found (absent or not owned by the org)"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Update Author","tags":["public-api"]}},"/api/public/v1/brand-setups":{"post":{"description":"Research a website for review. Requires Idempotency-Key; a matching retry\nreturns the same setup and job. Different input with that key, or an active\ndashboard setup, returns 409. Does not create a brand or draft.","operationId":"start_brand_setup_api_public_v1_brand_setups_post","parameters":[{"in":"header","name":"Idempotency-Key","required":true,"schema":{"title":"Idempotency-Key","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicBrandSetupCreate"}}},"required":true},"responses":{"202":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicBrandSetupStarted"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Conflict"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Start Brand Setup","tags":["public-api"]}},"/api/public/v1/brand-setups/{setup_id}":{"get":{"description":"Read progress and bounded brand/voice suggestions. Review ready suggestions\nbefore confirming. Failed research never silently creates a placeholder brand.","operationId":"get_brand_setup_api_public_v1_brand_setups__setup_id__get","parameters":[{"in":"path","name":"setup_id","required":true,"schema":{"format":"uuid","title":"Setup Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicBrandSetup"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Conflict"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Get Brand Setup","tags":["public-api"]}},"/api/public/v1/brand-setups/{setup_id}/confirm":{"post":{"description":"Create a new brand from reviewed research and optional edits. Requires\nIdempotency-Key; matching retries return the same brand. Existing brands\nand the current primary brand are preserved. No content is generated or published.","operationId":"confirm_brand_setup_api_public_v1_brand_setups__setup_id__confirm_post","parameters":[{"in":"path","name":"setup_id","required":true,"schema":{"format":"uuid","title":"Setup Id","type":"string"}},{"in":"header","name":"Idempotency-Key","required":true,"schema":{"title":"Idempotency-Key","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicBrandSetupConfirm"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicBrand"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Conflict"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Confirm Brand Setup","tags":["public-api"]}},"/api/public/v1/brands":{"get":{"description":"List brands linked to the authenticated org (newest first), paginated.","operationId":"list_brands_api_public_v1_brands_get","parameters":[{"description":"Results per page","in":"query","name":"limit","required":false,"schema":{"default":100,"description":"Results per page","maximum":200,"minimum":1,"title":"Limit","type":"integer"}},{"description":"Pagination offset","in":"query","name":"offset","required":false,"schema":{"default":0,"description":"Pagination offset","minimum":0,"title":"Offset","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicPage_PublicBrand_"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"List Brands","tags":["public-api"]}},"/api/public/v1/brands/{brand_id}":{"get":{"description":"Retrieve a single brand owned by the org.","operationId":"get_brand_api_public_v1_brands__brand_id__get","parameters":[{"in":"path","name":"brand_id","required":true,"schema":{"format":"uuid","title":"Brand Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicBrand"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Brand not found (absent or not owned by the org)"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Get Brand","tags":["public-api"]},"patch":{"description":"Update brand-voice fields used by content generation.\n\nOnly allow-listed voice fields are accepted. Omitted keys are left\nunchanged. Explicit ``null`` clears nullable text fields; ``tone`` and\nthe phrase arrays reject ``null`` (**422** — use ``[]`` to clear an\narray). Missing or foreign brand ids return **404**. Not billable.","operationId":"update_brand_api_public_v1_brands__brand_id__patch","parameters":[{"in":"path","name":"brand_id","required":true,"schema":{"format":"uuid","title":"Brand Id","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicBrandUpdate"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicBrand"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Brand not found (absent or not owned by the org)"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Update Brand","tags":["public-api"]}},"/api/public/v1/brands/{brand_id}/keywords":{"get":{"description":"List the brand's stored keyword strategy (clusters, keywords, and counts).\n\nReads your own keyword plan only — no third-party provider calls. The\nbrand must belong to your organization (**404** otherwise).","operationId":"list_brand_keywords_api_public_v1_brands__brand_id__keywords_get","parameters":[{"in":"path","name":"brand_id","required":true,"schema":{"format":"uuid","title":"Brand Id","type":"string"}},{"description":"Optional: restrict to a single pillar's clusters.","in":"query","name":"pillar_id","required":false,"schema":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"description":"Optional: restrict to a single pillar's clusters.","title":"Pillar Id"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicKeywordInventory"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Brand not found (absent or not owned by the org)"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"List Brand Keywords","tags":["public-api"]}},"/api/public/v1/brands/{brand_id}/projection":{"get":{"description":"Read brand fields and revision after verifying the expected website identity.","operationId":"get_brand_projection_api_public_v1_brands__brand_id__projection_get","parameters":[{"in":"path","name":"brand_id","required":true,"schema":{"format":"uuid","title":"Brand Id","type":"string"}},{"in":"query","name":"website_url","required":true,"schema":{"format":"uri","maxLength":2083,"minLength":1,"title":"Website Url","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BrandProjectionSnapshot"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Brand identity or receipt not found"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Get Brand Projection","tags":["public-api"]}},"/api/public/v1/brands/{brand_id}/projection/apply":{"post":{"description":"Apply source-owned fields only if the reviewed brand revision is still current. Returns a rollback receipt. Idempotency-Key is not accepted; the revision controls retries.","operationId":"apply_brand_projection_api_public_v1_brands__brand_id__projection_apply_post","parameters":[{"in":"path","name":"brand_id","required":true,"schema":{"format":"uuid","title":"Brand Id","type":"string"}},{"in":"header","name":"Idempotency-Key","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BrandProjectionParams"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BrandProjectionResult"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Brand identity or receipt not found"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Brand changed or fields are source-controlled; review a fresh projection"},"422":{"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/PublicErrorBody"},{"$ref":"#/components/schemas/HTTPValidationError"}]}}},"description":"Schema validation failed (field-error detail array), or an Idempotency-Key was sent to a route that does not accept one (string detail)."}},"summary":"Apply Brand Projection","tags":["public-api"]}},"/api/public/v1/brands/{brand_id}/projection/preview":{"post":{"description":"Compare an immutable source projection with stored brand fields without changing them. Idempotency-Key is not accepted.","operationId":"preview_brand_projection_api_public_v1_brands__brand_id__projection_preview_post","parameters":[{"in":"path","name":"brand_id","required":true,"schema":{"format":"uuid","title":"Brand Id","type":"string"}},{"in":"header","name":"Idempotency-Key","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BrandProjectionParams"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BrandProjectionResult"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Brand identity or receipt not found"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Brand changed or fields are source-controlled; review a fresh projection"},"422":{"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/PublicErrorBody"},{"$ref":"#/components/schemas/HTTPValidationError"}]}}},"description":"Schema validation failed (field-error detail array), or an Idempotency-Key was sent to a route that does not accept one (string detail)."}},"summary":"Preview Brand Projection","tags":["public-api"]}},"/api/public/v1/brands/{brand_id}/projection/rollback":{"post":{"description":"Restore a projection receipt only when no subsequent brand edit has occurred. Idempotency-Key is not accepted.","operationId":"rollback_brand_projection_api_public_v1_brands__brand_id__projection_rollback_post","parameters":[{"in":"path","name":"brand_id","required":true,"schema":{"format":"uuid","title":"Brand Id","type":"string"}},{"in":"header","name":"Idempotency-Key","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BrandProjectionRollbackParams"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BrandProjectionSnapshot"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Brand identity or receipt not found"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Brand changed or fields are source-controlled; review a fresh projection"},"422":{"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/PublicErrorBody"},{"$ref":"#/components/schemas/HTTPValidationError"}]}}},"description":"Schema validation failed (field-error detail array), or an Idempotency-Key was sent to a route that does not accept one (string detail)."}},"summary":"Rollback Brand Projection","tags":["public-api"]}},"/api/public/v1/brands/{brand_id}/source-policy":{"get":{"description":"Read the brand's current reviewed-source policy and revision.","operationId":"get_brand_source_policy_api_public_v1_brands__brand_id__source_policy_get","parameters":[{"in":"path","name":"brand_id","required":true,"schema":{"format":"uuid","title":"Brand Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BrandSourcePolicy"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Brand not found"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Get Brand Source Policy","tags":["public-api"]},"put":{"description":"Replace reviewed rules only if expected_revision is still current.","operationId":"put_brand_source_policy_api_public_v1_brands__brand_id__source_policy_put","parameters":[{"in":"path","name":"brand_id","required":true,"schema":{"format":"uuid","title":"Brand Id","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BrandSourcePolicyUpdate"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BrandSourcePolicy"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Brand not found"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Source policy changed. Reload before editing."},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Put Brand Source Policy","tags":["public-api"]}},"/api/public/v1/brands/{brand_id}/topics":{"post":{"description":"Create a topic from your own title, keyword, and angle.\n\nThe brand must belong to your organization (**404** otherwise). Optional\n``Idempotency-Key`` replays a prior create for the same payload. Returns\n**201** with the created topic.","operationId":"create_topic_api_public_v1_brands__brand_id__topics_post","parameters":[{"in":"path","name":"brand_id","required":true,"schema":{"format":"uuid","title":"Brand Id","type":"string"}},{"in":"header","name":"Idempotency-Key","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicTopicCreate"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicTopic"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Brand not found (absent or not owned by the org)"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Idempotency-Key reused with a different payload, or a concurrent create with the same key is in progress"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Create Topic","tags":["public-api"]}},"/api/public/v1/brands/{brand_id}/topics/generate":{"post":{"description":"Start an async topic-generation batch for a brand.\n\nGenerates topic-bank ideas for the brand's active pillars. Optional\n``pillar_id`` pins generation to one active pillar; optional\n``property_id`` sets the scoring context. An ``Idempotency-Key`` is\n**required**. Returns **202**; poll ``GET /jobs/{job_id}`` for completion.","operationId":"generate_topics_api_public_v1_brands__brand_id__topics_generate_post","parameters":[{"in":"path","name":"brand_id","required":true,"schema":{"format":"uuid","title":"Brand Id","type":"string"}},{"description":"Required. Dedupes this usage-charged generation; a retry with the same key replays the original 202 instead of starting (and billing) a second batch.","in":"header","name":"Idempotency-Key","required":true,"schema":{"description":"Required. Dedupes this usage-charged generation; a retry with the same key replays the original 202 instead of starting (and billing) a second batch.","title":"Idempotency-Key","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicTopicGenerationRequest"}}},"required":true},"responses":{"202":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicTopicGenerationResponse"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"A supplied pillar_id is not an active pillar for the brand, or the brand has no active pillars"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Brand or property not found (absent or not owned by the org)"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Idempotency-Key reused with a different payload, or a concurrent generate with the same key is in progress"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Topic-generation quota exceeded","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"},"Retry-After":{"$ref":"#/components/headers/Retry-After"}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Generation workflow infrastructure is temporarily unavailable"}},"summary":"Generate Topics","tags":["public-api"]}},"/api/public/v1/brands/{brand_id}/topics/rescore":{"post":{"description":"Re-score a brand's curated topics and persist updated decision bands.\n\n``property_id`` is required (scoring is property-scoped). Optional\n``topic_ids`` limits the set; omit to rescore the brand (server-capped).\nReturns **202** with a job; poll ``GET /jobs/{job_id}`` for the summary.\n\nThis route is already idempotent: an in-flight rescore for the same brand\nreuses its existing ``job_id`` rather than stacking a second one. It\ntherefore does **not** accept an ``Idempotency-Key`` — sending one returns\n**422** rather than being silently discarded.","operationId":"rescore_brand_topics_api_public_v1_brands__brand_id__topics_rescore_post","parameters":[{"in":"path","name":"brand_id","required":true,"schema":{"format":"uuid","title":"Brand Id","type":"string"}},{"in":"header","name":"Idempotency-Key","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicTopicRescoreRequest"}}},"required":true},"responses":{"202":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicTopicRescoreResponse"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Brand not found (absent or not owned by the org)"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Rescore Brand Topics","tags":["public-api"]}},"/api/public/v1/briefs":{"get":{"description":"Search briefs with AND filters and a bounded linked-content preview.","operationId":"list_briefs_api_public_v1_briefs_get","parameters":[{"in":"query","name":"brand_id","required":false,"schema":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Brand Id"}},{"in":"query","name":"property_id","required":false,"schema":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Property Id"}},{"in":"query","name":"status","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/TaskStatus"},{"type":"null"}],"title":"Status"}},{"in":"query","name":"format","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/ContentFormat"},{"type":"null"}],"title":"Format"}},{"in":"query","name":"pillar_id","required":false,"schema":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Pillar Id"}},{"in":"query","name":"created_from","required":false,"schema":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Created From"}},{"in":"query","name":"created_before","required":false,"schema":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Created Before"}},{"in":"query","name":"q","required":false,"schema":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"title":"Q"}},{"in":"query","name":"keyword","required":false,"schema":{"anyOf":[{"maxLength":255,"type":"string"},{"type":"null"}],"title":"Keyword"}},{"in":"query","name":"limit","required":false,"schema":{"default":50,"maximum":200,"minimum":1,"title":"Limit","type":"integer"}},{"in":"query","name":"offset","required":false,"schema":{"default":0,"minimum":0,"title":"Offset","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicPage_PublicBrief_"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"List Briefs","tags":["public-api"]},"post":{"description":"Create a brief and approve it so it is immediately ready for generation.\n\nSupply brand_id to target an owned brand; omission or null returns **422**.\nA supplied pillar must belong to the selected brand. An ``outline`` (ordered\nH2 titles) is saved as structured sections. Returns **201**.\n\nThe ``Idempotency-Key`` header is **optional**. With one, a retry of the\nsame body replays the original brief (``Idempotency-Replayed: true``)\ninstead of creating a second one, and the same key with a different body\nreturns **409**. Without one there is no deduplication and a retried POST\ncreates a second brief.\n\n``facts`` needs the v2 article pipeline: while it is not enabled a brief\nwith facts is refused with **409** ``article_pipeline_not_v2``. A fact a\nregulated workspace sends without a ``source_url``, or whose\n``source_url`` the brand source policy or blocked hosts refuse, is a\n**422** with ``detail.code`` (``user_fact_source_url_required`` /\n``user_fact_source_url_ineligible``), as on the kit-fact route.\n\n``article_spec`` marks each article element required, optional or off\nand sets citation, FAQ, length and other targets; omit it for the\nstandard article. An invalid spec is a **422** naming the field; a\nrequired source missing from ``source_urls`` is a **422** with\n``detail.code`` ``article_spec_required_source_not_in_brief``.","operationId":"create_brief_api_public_v1_briefs_post","parameters":[{"in":"header","name":"Idempotency-Key","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicBriefCreate"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicBrief"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Idempotency-Key reused with a different payload, or a concurrent create with the same key is in progress"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Create Brief","tags":["public-api"]}},"/api/public/v1/briefs/{brief_id}":{"get":{"description":"Read an owned brief and its current linked-content graph.","operationId":"get_brief_api_public_v1_briefs__brief_id__get","parameters":[{"in":"path","name":"brief_id","required":true,"schema":{"format":"uuid","title":"Brief Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicBrief"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Brief not found"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Get Brief","tags":["public-api"]},"patch":{"description":"Partially update a brief's content.\n\nOnly supplied fields change. ``status`` and ``brand_id`` are server-managed\nand not editable here. Missing or foreign brief/pillar ids return **404**.\nEditing any generation-relevant field (everything except ``pillar_id``) on\nan ``approved`` or ``ready`` brief moves its status back to ``draft`` so\nthe next generation re-enters review; re-approve with ``POST\n/briefs/{brief_id}/approve``. Supplying ``facts`` needs the v2 article\npipeline (**409** ``article_pipeline_not_v2`` otherwise) and meets the\nsame workspace and brand-policy rules as on create (**422**); ``[]`` or\n``null`` removes every fact. ``article_spec`` replaces the whole spec\n(``null`` resets it to the standard article); a required source must stay\nin ``source_urls``, including after a ``source_urls``-only edit\n(**422** ``article_spec_required_source_not_in_brief``).","operationId":"update_brief_api_public_v1_briefs__brief_id__patch","parameters":[{"in":"path","name":"brief_id","required":true,"schema":{"format":"uuid","title":"Brief Id","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicBriefUpdate"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicBrief"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Brief or referenced pillar not found"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Update Brief","tags":["public-api"]}},"/api/public/v1/briefs/{brief_id}/approve":{"post":{"description":"Approve a brief, most commonly to re-approve one a content edit moved back to draft. Legal only from draft or in_review; a brief that is already approved returns 422 rather than a no-op. Do not send an Idempotency-Key.","operationId":"approve_brief_api_public_v1_briefs__brief_id__approve_post","parameters":[{"in":"path","name":"brief_id","required":true,"schema":{"format":"uuid","title":"Brief Id","type":"string"}},{"in":"header","name":"Idempotency-Key","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicBrief"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Brief not found"},"422":{"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/PublicErrorBody"},{"$ref":"#/components/schemas/HTTPValidationError"}]}}},"description":"Schema validation failed (field-error detail array), an Idempotency-Key was sent to a route that does not accept one, or the brief's current status does not permit approval (string detail)."}},"summary":"Approve Brief","tags":["public-api"]}},"/api/public/v1/briefs/{brief_id}/sections":{"get":{"description":"List a brief's structured sections (sorted by ``sort_order``).\n\nDoes not consume provider usage. Missing or foreign brief ids return\n**404**.","operationId":"list_brief_sections_api_public_v1_briefs__brief_id__sections_get","parameters":[{"in":"path","name":"brief_id","required":true,"schema":{"format":"uuid","title":"Brief Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/PublicBriefSection"},"title":"Response List Brief Sections Api Public V1 Briefs  Brief Id  Sections Get","type":"array"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Brief not found"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"List Brief Sections","tags":["public-api"]}},"/api/public/v1/categories":{"get":{"description":"List a brand's categories in pages of up to 200.","operationId":"list_categories_api_public_v1_categories_get","parameters":[{"description":"Brand whose categories to list","in":"query","name":"brand_id","required":true,"schema":{"description":"Brand whose categories to list","format":"uuid","title":"Brand Id","type":"string"}},{"description":"Results per page","in":"query","name":"limit","required":false,"schema":{"default":50,"description":"Results per page","maximum":200,"minimum":1,"title":"Limit","type":"integer"}},{"description":"Pagination offset","in":"query","name":"offset","required":false,"schema":{"default":0,"description":"Pagination offset","minimum":0,"title":"Offset","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicPage_PublicCategory_"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"List Categories","tags":["public-api"]},"post":{"description":"Create a category for a brand you own.\n\nThe ``Idempotency-Key`` header is **optional**: with one, a retry of the\nsame body replays the original category (``Idempotency-Replayed: true``);\nthe same key with a different body returns **409**.","operationId":"create_category_api_public_v1_categories_post","parameters":[{"in":"header","name":"Idempotency-Key","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicCategoryCreate"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicCategory"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Brand not found (absent or not owned by the org)"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Slug already exists for this brand, or the Idempotency-Key was reused with a different payload"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Create Category","tags":["public-api"]}},"/api/public/v1/categories/{category_id}":{"delete":{"description":"Delete a category. Returns 204 with no body; 404 when it does not exist or belongs to another organization.","operationId":"delete_category_api_public_v1_categories__category_id__delete","parameters":[{"in":"path","name":"category_id","required":true,"schema":{"format":"uuid","title":"Category Id","type":"string"}}],"responses":{"204":{"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Category not found (absent or not owned by the org)"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Delete Category","tags":["public-api"]},"get":{"description":"Read one category, including its parent, display settings, and usage count.","operationId":"get_category_api_public_v1_categories__category_id__get","parameters":[{"in":"path","name":"category_id","required":true,"schema":{"format":"uuid","title":"Category Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicCategory"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Category not found (absent or not owned by the org)"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Get Category","tags":["public-api"]},"patch":{"description":"Partially update a category: omitted fields stay unchanged. Returns 409 when the new slug is already used by the brand.","operationId":"update_category_api_public_v1_categories__category_id__patch","parameters":[{"in":"path","name":"category_id","required":true,"schema":{"format":"uuid","title":"Category Id","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicCategoryUpdate"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicCategory"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Category not found (absent or not owned by the org)"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Slug already exists for this brand"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Update Category","tags":["public-api"]}},"/api/public/v1/content":{"get":{"description":"Search content using AND filters and exact filtered pagination.\n\nq is a case-insensitive literal title/slug substring; keyword is a whole\nphrase in brief targets or the latest saved revision's SEO keywords.\nDates select created_at in [created_from, created_before), normalized to UTC.\nA ``latest_attempt`` whose run ended holding the item's kit for review reads ``awaiting_review``. A run still waiting in place reads ``running`` here; poll ``GET /jobs/{job_id}`` for its review state.","operationId":"list_content_api_public_v1_content_get","parameters":[{"in":"query","name":"brand_id","required":false,"schema":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Brand Id"}},{"in":"query","name":"property_id","required":false,"schema":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Property Id"}},{"in":"query","name":"status","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/TaskStatus"},{"type":"null"}],"title":"Status"}},{"in":"query","name":"format","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/ContentFormat"},{"type":"null"}],"title":"Format"}},{"in":"query","name":"pillar_id","required":false,"schema":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Pillar Id"}},{"in":"query","name":"created_from","required":false,"schema":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Created From"}},{"in":"query","name":"created_before","required":false,"schema":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Created Before"}},{"in":"query","name":"q","required":false,"schema":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"title":"Q"}},{"in":"query","name":"keyword","required":false,"schema":{"anyOf":[{"maxLength":255,"type":"string"},{"type":"null"}],"title":"Keyword"}},{"in":"query","name":"limit","required":false,"schema":{"default":50,"maximum":200,"minimum":1,"title":"Limit","type":"integer"}},{"in":"query","name":"offset","required":false,"schema":{"default":0,"minimum":0,"title":"Offset","type":"integer"}},{"in":"query","name":"content_type","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/ContentFormat"},{"type":"null"}],"title":"Content Type"}},{"in":"query","name":"brief_id","required":false,"schema":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Brief Id"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicPage_PublicContentSummary_"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"List Content","tags":["public-api"]}},"/api/public/v1/content/generate":{"post":{"description":"Start content generation for a topic.\n\nReturns **202** with a job you can poll via ``GET /jobs/{job_id}``.\nEnforces the content-generation quota before kickoff. Optional\n``Idempotency-Key`` replays an in-flight or completed kickoff for the\nsame payload; a different payload on the same key returns **409**.\nIneligible topics return **409**, as does a topic whose existing content\nitem has another generation still running; unknown topics return **404**.\nOptional ``property_id`` selects the publishing property (same brand);\na foreign one returns **404**, another brand's **409**.","operationId":"generate_content_api_public_v1_content_generate_post","parameters":[{"in":"header","name":"Idempotency-Key","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicGenerateRequest"}}},"required":true},"responses":{"202":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicGenerateResponse"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Topic or property_id not found (absent or not owned by the org)"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Idempotency-Key reused with a different payload, or a concurrent generate with the same key is in progress; or the topic is not eligible: its decision band is expert_review or reject_or_hold, the brand's strict source policy has no reviewed source for it (no_permitted_sources_for_topic), property_id belongs to another brand or differs from the property of the topic's existing content item, no property was supplied and none resolves for the brand, or another generation of the topic's existing content item is still running"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Content-generation quota exhausted, or the per-org rate limit was exceeded (honor Retry-After when present)","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"},"Retry-After":{"$ref":"#/components/headers/Retry-After"}}}},"summary":"Generate Content","tags":["public-api"]}},"/api/public/v1/content/items":{"get":{"description":"List the org's content items (newest-first), with filter and pagination.\n\nFilters combine with AND. Use this to re-find item ids after a lost create\nresponse. ``status`` filters by item lifecycle status.","operationId":"list_content_items_api_public_v1_content_items_get","parameters":[{"description":"Filter by brief","in":"query","name":"brief_id","required":false,"schema":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"description":"Filter by brief","title":"Brief Id"}},{"description":"Filter by property","in":"query","name":"property_id","required":false,"schema":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"description":"Filter by property","title":"Property Id"}},{"description":"Filter by item status","in":"query","name":"status","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/TaskStatus"},{"type":"null"}],"description":"Filter by item status","title":"Status"}},{"description":"Results per page","in":"query","name":"limit","required":false,"schema":{"default":50,"description":"Results per page","maximum":200,"minimum":1,"title":"Limit","type":"integer"}},{"description":"Pagination offset","in":"query","name":"offset","required":false,"schema":{"default":0,"description":"Pagination offset","minimum":0,"title":"Offset","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicPage_PublicContentItemDetail_"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"List Content Items","tags":["public-api"]},"post":{"description":"Bind a brief to a publishing property and create a content item.\n\nResolves the item brand from the chosen property (which must belong to\nyour organization). The brief and property must share the same brand\n(**422** on mismatch). A missing or foreign brief/property returns **404**.\n\nAn ``Idempotency-Key`` is **required**. A retry with the same key and body\nreplays the original item (``Idempotency-Replayed: true``) instead of\ncreating a second row. Different body on the same key returns **409**.\nCreating items is not content-generation-quota gated; generation is gated\nseparately when you start a generate job. A per-org daily create cap may\nreturn **429** when exceeded (replays do not count toward the cap).","operationId":"create_content_item_api_public_v1_content_items_post","parameters":[{"description":"Required. Dedupes this billed create; a retry with the same key replays the original item instead of creating (and billing) a second.","in":"header","name":"Idempotency-Key","required":true,"schema":{"description":"Required. Dedupes this billed create; a retry with the same key replays the original item instead of creating (and billing) a second.","title":"Idempotency-Key","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicContentItemCreate"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicContentItemDetail"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Property not found / not owned, or brief not found"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Idempotency-Key reused with a different payload, a concurrent create with the same key is in progress, or a live content item already exists for this brief"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Per-org daily content-item create limit exceeded","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"},"Retry-After":{"$ref":"#/components/headers/Retry-After"}}}},"summary":"Create Content Item","tags":["public-api"]}},"/api/public/v1/content/items/{content_item_id}/versions/{version_id}/relevant-links":{"get":{"description":"Read the website links approved for one saved generation version, including the index locale frozen on that version at generation time. Returns an empty list when the version has no website-index links. Returns 404 when the content item does not exist, is not owned by the caller, or the version does not belong to the item.","operationId":"download_version_relevant_links_api_public_v1_content_items__content_item_id__versions__version_id__relevant_links_get","parameters":[{"in":"path","name":"content_item_id","required":true,"schema":{"format":"uuid","title":"Content Item Id","type":"string"}},{"in":"path","name":"version_id","required":true,"schema":{"format":"uuid","title":"Version Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicVersionedRelevantLinks"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Content item or version not found (or not owned by the org)"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Download Version Relevant Links","tags":["public-api"]}},"/api/public/v1/content/items/{item_id}":{"delete":{"description":"Soft-delete a content item.\n\nThe item must exist, belong to your organization, and not already be\ndeleted (**404** otherwise). Returns **204** with no body.","operationId":"delete_content_item_api_public_v1_content_items__item_id__delete","parameters":[{"in":"path","name":"item_id","required":true,"schema":{"format":"uuid","title":"Item Id","type":"string"}}],"responses":{"204":{"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Content item not found (absent, not owned by the org, or already soft-deleted)"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Delete Content Item","tags":["public-api"]},"patch":{"description":"Partially update a content item.\n\nOnly supplied fields change. ``title``, ``format``, ``status``,\n``author_id`` and ``slug`` reject explicit ``null`` with **422** — omit a\nkey to leave it unchanged. ``slug`` also rejects an empty string, which\nused to return **200** having changed nothing; send a replacement instead.\nReading ``slug`` back as ``null`` is possible and means the item has none;\na ``PATCH`` is how you give it one. ``POST /content/rewrite`` used to\ncreate its source item without one and, since 2026-08-29, derives one from\nthe title instead. ``published_url`` may be cleared with ``null``, which\nasks the next publish to re-derive it. The item must be live and owned by\nyour organization (**404** otherwise).","operationId":"update_content_item_api_public_v1_content_items__item_id__patch","parameters":[{"in":"path","name":"item_id","required":true,"schema":{"format":"uuid","title":"Item Id","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicContentItemUpdate"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicContentItemDetail"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Content item not found (absent, not owned by the org, or soft-deleted)"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Update Content Item","tags":["public-api"]}},"/api/public/v1/content/items/{item_id}/generate":{"post":{"description":"Start generation for an existing content item.\n\nSupply an ``Idempotency-Key`` so retries replay the original job (no second\ngeneration charge). When absent, a key is generated and echoed so the\ncaller can capture-and-resend. A previously failed generation is **not**\nreplayed: the same key re-dispatches as new, quota-charged work\n(``replayed=false``, no ``Idempotency-Replayed`` header). Over-quota\nrequests return **429**.","operationId":"generate_content_item_api_public_v1_content_items__item_id__generate_post","parameters":[{"in":"path","name":"item_id","required":true,"schema":{"format":"uuid","title":"Item Id","type":"string"}},{"in":"header","name":"Idempotency-Key","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/PublicGenerateItemRequest"},{"type":"null"}],"title":"Body"}}}},"responses":{"202":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicGenerateResponse"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Content item not found (absent or not owned by the org)"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Item not generatable: brief not in a generatable state (`brief_not_approved` / `item_not_generatable`), or another generation of the item is still running (`article_run_active`; wait for it to finish, then retry or review its kit)"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Generation backend temporarily unavailable; retry. A concurrent first call that has not finished dispatch yet is not a 503 — it returns 202 with status=queued for polling."}},"summary":"Generate Content Item","tags":["public-api"]}},"/api/public/v1/content/items/{item_id}/kit":{"get":{"description":"Read a content item's kit: outline, claims, components and review state.\n\nUse ``kit_revision`` as ``expected_kit_revision`` on every kit write.","operationId":"get_content_kit_api_public_v1_content_items__item_id__kit_get","parameters":[{"in":"path","name":"item_id","required":true,"schema":{"format":"uuid","title":"Item Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicContentKitRead"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Content item or kit not found (absent or not owned by the org)"},"409":{"description":"kit_revision_stale: the kit changed since expected_kit_revision; re-read it. article_pipeline_not_v2: content kits need the v2 article pipeline."},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Get Content Kit","tags":["public-api"]}},"/api/public/v1/content/items/{item_id}/kit/approve":{"post":{"description":"Approve the kit at this revision so the article is written from it.\n\nThe approval is stored first; ``write`` says whether the write started.\nAn agent (OAuth) approval is recorded as ``decided_by=agent``.","operationId":"approve_content_kit_api_public_v1_content_items__item_id__kit_approve_post","parameters":[{"in":"path","name":"item_id","required":true,"schema":{"format":"uuid","title":"Item Id","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicKitDecisionInput"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicKitApproval"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Content item or kit not found (absent or not owned by the org)"},"409":{"description":"kit_revision_stale: the kit changed since expected_kit_revision; re-read it. article_pipeline_not_v2: content kits need the v2 article pipeline."},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Approve Content Kit","tags":["public-api"]}},"/api/public/v1/content/items/{item_id}/kit/components":{"post":{"description":"Add a component, or replace the one with this ``id``, from a typed\npayload. The payload is rebuilt against the kit's claims; raw Markdown and\nthe ``sources`` kind are refused (422). An edit moves an approved kit back\nto ``needs_review``.","operationId":"upsert_content_kit_component_api_public_v1_content_items__item_id__kit_components_post","parameters":[{"in":"path","name":"item_id","required":true,"schema":{"format":"uuid","title":"Item Id","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicKitComponentInput"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicContentKit"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Content item or kit not found (absent or not owned by the org)"},"409":{"description":"kit_revision_stale: the kit changed since expected_kit_revision; re-read it. article_pipeline_not_v2: content kits need the v2 article pipeline."},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Upsert Content Kit Component","tags":["public-api"]}},"/api/public/v1/content/items/{item_id}/kit/components/{component_id}":{"delete":{"description":"Remove a component; later kit rebuilds do not bring it back. Send the\ncurrent revision in the ``Expected-Kit-Revision`` header.","operationId":"delete_content_kit_component_api_public_v1_content_items__item_id__kit_components__component_id__delete","parameters":[{"in":"path","name":"item_id","required":true,"schema":{"format":"uuid","title":"Item Id","type":"string"}},{"in":"path","name":"component_id","required":true,"schema":{"title":"Component Id","type":"string"}},{"in":"header","name":"Expected-Kit-Revision","required":true,"schema":{"pattern":"^[a-f0-9]{64}$","title":"Expected-Kit-Revision","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicContentKit"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Content item or kit not found (absent or not owned by the org)"},"409":{"description":"kit_revision_stale: the kit changed since expected_kit_revision; re-read it. article_pipeline_not_v2: content kits need the v2 article pipeline."},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Delete Content Kit Component","tags":["public-api"]}},"/api/public/v1/content/items/{item_id}/kit/components/{component_id}/lock":{"post":{"description":"Lock a component so later kit rebuilds keep it exactly as it is.","operationId":"lock_content_kit_component_api_public_v1_content_items__item_id__kit_components__component_id__lock_post","parameters":[{"in":"path","name":"item_id","required":true,"schema":{"format":"uuid","title":"Item Id","type":"string"}},{"in":"path","name":"component_id","required":true,"schema":{"title":"Component Id","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicKitRevisionInput"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicContentKit"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Content item or kit not found (absent or not owned by the org)"},"409":{"description":"kit_revision_stale: the kit changed since expected_kit_revision; re-read it. article_pipeline_not_v2: content kits need the v2 article pipeline."},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Lock Content Kit Component","tags":["public-api"]}},"/api/public/v1/content/items/{item_id}/kit/facts":{"post":{"description":"Add one supplied fact to the kit. A ``source_url`` is fetched and\ncited only when its page states the fact (``source_url_cited``;\n``source_check`` says why not). ``section_ids`` maps it to outline\nsections, so it counts as their evidence and may be stated there. Kit\nfacts survive kit rebuilds; brief facts live on the brief.","operationId":"add_content_kit_fact_api_public_v1_content_items__item_id__kit_facts_post","parameters":[{"in":"path","name":"item_id","required":true,"schema":{"format":"uuid","title":"Item Id","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicKitFactInput"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicKitFactAdded"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Content item or kit not found (absent or not owned by the org)"},"409":{"description":"kit_revision_stale: the kit changed since expected_kit_revision; re-read it. article_pipeline_not_v2: content kits need the v2 article pipeline."},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Add Content Kit Fact","tags":["public-api"]}},"/api/public/v1/content/items/{item_id}/kit/facts/{claim_id}":{"delete":{"description":"Remove a fact added on the kit (``user:k-``). Brief facts are edited\non the brief. A fact a locked or edited component still cites is a 422.","operationId":"delete_content_kit_fact_api_public_v1_content_items__item_id__kit_facts__claim_id__delete","parameters":[{"in":"path","name":"item_id","required":true,"schema":{"format":"uuid","title":"Item Id","type":"string"}},{"in":"path","name":"claim_id","required":true,"schema":{"title":"Claim Id","type":"string"}},{"in":"header","name":"Expected-Kit-Revision","required":true,"schema":{"pattern":"^[a-f0-9]{64}$","title":"Expected-Kit-Revision","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicContentKit"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Content item or kit not found (absent or not owned by the org)"},"409":{"description":"kit_revision_stale: the kit changed since expected_kit_revision; re-read it. article_pipeline_not_v2: content kits need the v2 article pipeline."},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Delete Content Kit Fact","tags":["public-api"]}},"/api/public/v1/content/items/{item_id}/kit/reject":{"post":{"description":"Reject the kit: it stays held (``needs_review``) and nothing is\nwritten. Edit and approve it, or regenerate to rebuild it.","operationId":"reject_content_kit_api_public_v1_content_items__item_id__kit_reject_post","parameters":[{"in":"path","name":"item_id","required":true,"schema":{"format":"uuid","title":"Item Id","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicKitDecisionInput"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicContentKit"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Content item or kit not found (absent or not owned by the org)"},"409":{"description":"kit_revision_stale: the kit changed since expected_kit_revision; re-read it. article_pipeline_not_v2: content kits need the v2 article pipeline."},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Reject Content Kit","tags":["public-api"]}},"/api/public/v1/content/items/{item_id}/kit/source-exclusions":{"post":{"description":"Exclude a source domain (and its subdomains) from the kit.\n\nIts claims and the components built from them leave the kit, and the\nsources list is rebuilt. Navigation links in the brief are unaffected.\n``evidence`` shows what the kit still holds; approve to write from it.","operationId":"exclude_content_kit_source_domain_api_public_v1_content_items__item_id__kit_source_exclusions_post","parameters":[{"in":"path","name":"item_id","required":true,"schema":{"format":"uuid","title":"Item Id","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicKitSourceExclusionInput"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicKitSourceExclusion"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Content item or kit not found (absent or not owned by the org)"},"409":{"description":"kit_revision_stale: the kit changed since expected_kit_revision; re-read it. article_pipeline_not_v2: content kits need the v2 article pipeline."},"422":{"description":"source_domain_invalid, source_domain_not_in_kit, source_has_locked_components (details.component_ids) or source_domain_cited_by_facts (details.claim_ids)."}},"summary":"Exclude Content Kit Source Domain","tags":["public-api"]}},"/api/public/v1/content/items/{item_id}/restore-archive":{"post":{"description":"Return an archived failed draft to inventory. Repeating a restore is safe.","operationId":"restore_archived_failed_draft_api_public_v1_content_items__item_id__restore_archive_post","parameters":[{"in":"path","name":"item_id","required":true,"schema":{"format":"uuid","title":"Item Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDraftInventoryRestore"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Restore Archived Failed Draft","tags":["public-api"]}},"/api/public/v1/content/rewrite":{"post":{"description":"Submit pasted Markdown to be rewritten to the brand voice.\n\nAn ``Idempotency-Key`` is **required** (absent → **422**). A retry with the\nsame key and body replays the original **202** instead of creating and\nbilling a second source item. Reuse of a key with a different payload — or\na concurrent in-flight rewrite with the same key — returns **409**.\n\nThe **202** is stored when the job is created (before dispatch). A later\ndispatch failure still returns **202**; retry with the same key replays the\nstored envelope rather than creating a second source item.","operationId":"create_rewrite_api_public_v1_content_rewrite_post","parameters":[{"description":"Required. Dedupes this billed rewrite; a retry with the same key replays the original 202 instead of creating (and billing) a second.","in":"header","name":"Idempotency-Key","required":true,"schema":{"description":"Required. Dedupes this billed rewrite; a retry with the same key replays the original 202 instead of creating (and billing) a second.","title":"Idempotency-Key","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicRewriteRequest"}}},"required":true},"responses":{"202":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicRewriteResponse"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Brand not found (absent or not owned by the org)"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Idempotency-Key reused with a different payload, or a concurrent rewrite with the same key is in progress"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Rewrite backend or idempotency store temporarily unavailable; retry with the same Idempotency-Key."}},"summary":"Create Rewrite","tags":["public-api"]}},"/api/public/v1/content/{content_item_id}":{"get":{"description":"Download a content item and a page of its versions.\n\n``versions`` is a ``PublicPage`` envelope: default window is the newest 50\n(standard public ``limit`` 1–200). Pass ``latest_only=true`` or\n``version=N`` to pin without paging.\n\nOptional projections are opt-in via ``?include=`` (``scoring``,\n``sources``, ``compliance``; combine with commas). When not requested,\nthose fields stay null. Scoring is per-version: each version surfaces\nits own quality signals when ``include=scoring`` is set.","operationId":"download_content_api_public_v1_content__content_item_id__get","parameters":[{"in":"path","name":"content_item_id","required":true,"schema":{"format":"uuid","title":"Content Item Id","type":"string"}},{"description":"Comma-separated optional projections. Pass 'scoring' to include per-version quality signals (geo/draft scores, warnings); pass 'sources' to include the research sources cited in each version (marker, source_name, source_url, origin); pass 'assertion_provenance' to include the per-assertion provenance receipt (sentence, sentence_index, url, marker, origin); pass 'compliance' to include each version's regulated-content policy findings (kind, message, excerpt); pass 'supplied_facts' to include the facts you supplied with no source URL (claim_id, text, attribution). Any may be combined.","in":"query","name":"include","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated optional projections. Pass 'scoring' to include per-version quality signals (geo/draft scores, warnings); pass 'sources' to include the research sources cited in each version (marker, source_name, source_url, origin); pass 'assertion_provenance' to include the per-assertion provenance receipt (sentence, sentence_index, url, marker, origin); pass 'compliance' to include each version's regulated-content policy findings (kind, message, excerpt); pass 'supplied_facts' to include the facts you supplied with no source URL (claim_id, text, attribution). Any may be combined.","title":"Include"}},{"description":"Return only the current version instead of paging the revision history. Use this for page-by-page download.","in":"query","name":"latest_only","required":false,"schema":{"default":false,"description":"Return only the current version instead of paging the revision history. Use this for page-by-page download.","title":"Latest Only","type":"boolean"}},{"description":"Return only this version number. Mutually exclusive with `latest_only`; an unknown version number is a 404.","in":"query","name":"version","required":false,"schema":{"anyOf":[{"minimum":1,"type":"integer"},{"type":"null"}],"description":"Return only this version number. Mutually exclusive with `latest_only`; an unknown version number is a 404.","title":"Version"}},{"description":"Versions page size. Ignored when latest_only or version is set. Newest version first. Standard public pagination bounds (1–200, default 50).","in":"query","name":"limit","required":false,"schema":{"default":50,"description":"Versions page size. Ignored when latest_only or version is set. Newest version first. Standard public pagination bounds (1–200, default 50).","maximum":200,"minimum":1,"title":"Limit","type":"integer"}},{"description":"Versions page offset. Ignored when latest_only or version is set.","in":"query","name":"offset","required":false,"schema":{"default":0,"description":"Versions page offset. Ignored when latest_only or version is set.","minimum":0,"title":"Offset","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicContentItem"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Content item not found (absent or not owned by the org)"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Download Content","tags":["public-api"]}},"/api/public/v1/content/{content_item_id}/checks":{"post":{"description":"Start an explicit quality check of the current saved version. This does not edit Markdown. Do not send Idempotency-Key.","operationId":"check_draft_api_public_v1_content__content_item_id__checks_post","parameters":[{"in":"path","name":"content_item_id","required":true,"schema":{"format":"uuid","title":"Content Item Id","type":"string"}},{"in":"header","name":"Idempotency-Key","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EditorialCheckRequest"}}},"required":true},"responses":{"202":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EditorialJobAccepted"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Check Draft","tags":["public-api"]}},"/api/public/v1/content/{content_item_id}/diff":{"get":{"description":"Compare Markdown of two immutable versions of the same item.","operationId":"diff_draft_api_public_v1_content__content_item_id__diff_get","parameters":[{"in":"path","name":"content_item_id","required":true,"schema":{"format":"uuid","title":"Content Item Id","type":"string"}},{"in":"query","name":"from_version_id","required":true,"schema":{"format":"uuid","title":"From Version Id","type":"string"}},{"in":"query","name":"to_version_id","required":true,"schema":{"format":"uuid","title":"To Version Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EditorialDiffResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Diff Draft","tags":["public-api"]}},"/api/public/v1/content/{content_item_id}/edits":{"post":{"description":"Save a new immutable Markdown version of the current draft. Send the exact expected_base_version_id. Whole-body replacement uses markdown_body; exact patches use a unique target substring. Reuse request_id after a lost response. Do not send Idempotency-Key.","operationId":"edit_draft_api_public_v1_content__content_item_id__edits_post","parameters":[{"in":"path","name":"content_item_id","required":true,"schema":{"format":"uuid","title":"Content Item Id","type":"string"}},{"in":"header","name":"Idempotency-Key","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EditorialEditRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EditorialVersionReceipt"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Edit Draft","tags":["public-api"]}},"/api/public/v1/content/{content_item_id}/restores":{"post":{"description":"Copy an earlier immutable version into a new current revision with restoration lineage. Supply the current expected_base_version_id. Do not send Idempotency-Key.","operationId":"restore_draft_api_public_v1_content__content_item_id__restores_post","parameters":[{"in":"path","name":"content_item_id","required":true,"schema":{"format":"uuid","title":"Content Item Id","type":"string"}},{"in":"header","name":"Idempotency-Key","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EditorialRestoreRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EditorialVersionReceipt"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Restore Draft","tags":["public-api"]}},"/api/public/v1/content/{content_item_id}/review-card":{"get":{"description":"Read persisted editorial checks for the current saved version. This does not start a check or a provider call. Do not send Idempotency-Key.","operationId":"get_review_card_api_public_v1_content__content_item_id__review_card_get","parameters":[{"in":"path","name":"content_item_id","required":true,"schema":{"format":"uuid","title":"Content Item Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EditorialReviewCard"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Get Review Card","tags":["public-api"]}},"/api/public/v1/content/{content_item_id}/rewrites":{"post":{"description":"Start an in-item AI rewrite of the current version. Section rewrites keep outside-section bytes identical unless allow_broader_repair is true. Failed verification saves no version. Requires Idempotency-Key. The first AI rewrite of a handwritten-only item uses the content allowance. AI rewrites of items that already have a generated version use the revisions allowance. While another generation of the item is pending or running this returns 409 article_run_active before any charge.","operationId":"rewrite_draft_api_public_v1_content__content_item_id__rewrites_post","parameters":[{"in":"path","name":"content_item_id","required":true,"schema":{"format":"uuid","title":"Content Item Id","type":"string"}},{"in":"header","name":"Idempotency-Key","required":true,"schema":{"title":"Idempotency-Key","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EditorialRewriteRequest"}}},"required":true},"responses":{"202":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EditorialJobAccepted"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Rewrite Draft","tags":["public-api"]}},"/api/public/v1/content/{content_item_id}/sections":{"get":{"description":"Parser-derived H2 section ids for a saved version. Duplicate headings are disambiguated; headings inside code fences are ignored.","operationId":"list_draft_sections_api_public_v1_content__content_item_id__sections_get","parameters":[{"in":"path","name":"content_item_id","required":true,"schema":{"format":"uuid","title":"Content Item Id","type":"string"}},{"in":"query","name":"content_version_id","required":true,"schema":{"format":"uuid","title":"Content Version Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/EditorialHeadingSection"},"title":"Response List Draft Sections Api Public V1 Content  Content Item Id  Sections Get","type":"array"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"List Draft Sections","tags":["public-api"]}},"/api/public/v1/content/{item_id}/publish":{"post":{"description":"Publish or schedule a content item to this org's connected CMS. Completes the public loop: generate -> review -> **publish**. Prerequisites: the item's property must have ``publish_policy=cms_publish`` (a ``draft_only`` property returns **409** — collect the page with ``GET /content/{content_item_id}`` instead), and the item must be live (not soft-deleted) and have a resolvable CMS destination — either an existing single publish target on the item, or a human-selected org default destination used to provision one. Zero targets with no valid default, or more than one target, both return 409. This surface never invents a collection UID and never picks among ambiguous targets. Exactly-once: a retry of an already-enqueued publish returns **202 with the original job_id** and ``was_duplicate_lookup=true``. It does not enqueue a second publish and is deliberately not a 409. Clients may retry freely. Provenance is set server-side and is never read from the request body. Modes are ``draft`` / ``live`` / ``schedule`` / ``unpublish``. ``unpublish`` tears the remote document down again and is the one mode that skips both readiness gates: it is allowed on a ``draft_only`` property (a page can be live on the destination CMS without this API having published it, and that is exactly the case worth reversing), and it never provisions a default destination — an item with no publish target returns **409** because there is nothing linked to tear down. Because that exactly-once dedupe is derived from the item/version/mode rather than from a client key, this route does **not** accept an ``Idempotency-Key`` — sending one returns **422** rather than being silently discarded.","operationId":"publish_content_item_api_public_v1_content__item_id__publish_post","parameters":[{"in":"path","name":"item_id","required":true,"schema":{"format":"uuid","title":"Item Id","type":"string"}},{"in":"header","name":"Idempotency-Key","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicPublishRequest"}}},"required":true},"responses":{"202":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicPublishAccepted"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Content item not found, not owned by this org, or soft-deleted"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"The item's property has publish_policy=draft_only, so there is nothing to publish to (not raised for mode=unpublish); or no CMS publish destination is available for this item (no target and no human-selected org default); or more than one target makes the destination ambiguous; or mode=unpublish was sent for an item with no publish target, leaving nothing to tear down"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Publish dispatch temporarily unavailable"}},"summary":"Publish Content Item","tags":["public-api"]}},"/api/public/v1/documents":{"get":{"description":"List the org's library documents, optionally filtered and paginated.\n\n``category``, ``status``, and ``q`` combine with AND; ``total`` and\n``has_more`` reflect the composed filter.","operationId":"list_documents_api_public_v1_documents_get","parameters":[{"description":"Optional document-category filter","in":"query","name":"category","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/DocumentCategory"},{"type":"null"}],"description":"Optional document-category filter","title":"Category"}},{"description":"Optional processing-status filter","in":"query","name":"status","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/DocumentStatus"},{"type":"null"}],"description":"Optional processing-status filter","title":"Status"}},{"description":"Optional case-insensitive filename substring filter","in":"query","name":"q","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional case-insensitive filename substring filter","title":"Q"}},{"description":"Results per page","in":"query","name":"limit","required":false,"schema":{"default":50,"description":"Results per page","maximum":200,"minimum":1,"title":"Limit","type":"integer"}},{"description":"Pagination offset","in":"query","name":"offset","required":false,"schema":{"default":0,"description":"Pagination offset","minimum":0,"title":"Offset","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicPage_PublicDocument_"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"List Documents","tags":["public-api"]}},"/api/public/v1/documents/{document_id}":{"get":{"description":"Retrieve a single document owned by your organization.\n\nDoes not include extracted text. Missing or foreign document ids return\n**404**.","operationId":"get_document_api_public_v1_documents__document_id__get","parameters":[{"in":"path","name":"document_id","required":true,"schema":{"format":"uuid","title":"Document Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDocument"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Document not found (absent or not owned by the org)"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Get Document","tags":["public-api"]}},"/api/public/v1/imported-content":{"get":{"description":"List CMS-synced imported content for the org (paginated envelope).","operationId":"list_imported_content_api_public_v1_imported_content_get","parameters":[{"in":"query","name":"property_id","required":false,"schema":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Property Id"}},{"in":"query","name":"has_brief","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Has Brief"}},{"in":"query","name":"limit","required":false,"schema":{"default":50,"maximum":200,"minimum":1,"title":"Limit","type":"integer"}},{"in":"query","name":"offset","required":false,"schema":{"default":0,"minimum":0,"title":"Offset","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicPage_PublicImportedContent_"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"List Imported Content","tags":["public-api"]}},"/api/public/v1/imported-content/{content_item_id}":{"get":{"description":"Get one imported content item with its body + metadata.","operationId":"get_imported_content_api_public_v1_imported_content__content_item_id__get","parameters":[{"in":"path","name":"content_item_id","required":true,"schema":{"format":"uuid","title":"Content Item Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicImportedContentDetail"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Imported content not found (absent or not owned by the org)"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Get Imported Content","tags":["public-api"]}},"/api/public/v1/jobs":{"get":{"description":"List your organization's jobs to resume progress after a disconnected session. Filters combine with AND. Dates require a UTC offset; created_from is inclusive and created_before exclusive. Results use descending creation time and job ID, with a full filtered total. A run that ended holding its content kit for review reads awaiting_review, as on GET /jobs/{job_id}; the status filter, total and paging use its stored status (completed). A run still waiting in place reads running here; poll GET /jobs/{job_id} for its review state.","operationId":"list_jobs_api_public_v1_jobs_get","parameters":[{"description":"Exact stored job-type name, including retired types. Must not be blank.","in":"query","name":"job_type","required":false,"schema":{"anyOf":[{"minLength":1,"pattern":"\\S","type":"string"},{"type":"null"}],"description":"Exact stored job-type name, including retired types. Must not be blank.","title":"Job Type"}},{"in":"query","name":"status","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/JobStatus"},{"type":"null"}],"title":"Status"}},{"in":"query","name":"created_from","required":false,"schema":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Created From"}},{"in":"query","name":"created_before","required":false,"schema":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Created Before"}},{"in":"query","name":"brand_id","required":false,"schema":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Brand Id"}},{"in":"query","name":"property_id","required":false,"schema":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Property Id"}},{"in":"query","name":"brief_id","required":false,"schema":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Brief Id"}},{"in":"query","name":"content_item_id","required":false,"schema":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Content Item Id"}},{"in":"query","name":"limit","required":false,"schema":{"default":50,"maximum":200,"minimum":1,"title":"Limit","type":"integer"}},{"in":"query","name":"offset","required":false,"schema":{"default":0,"minimum":0,"title":"Offset","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicPage_PublicJobSummary_"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"List Jobs","tags":["public-api"]}},"/api/public/v1/jobs/{job_id}":{"get":{"description":"Poll a generation job. ``content_item_id`` populates once the run produces it.\n\nFor an article run, ``kit_status`` / ``kit_revision`` describe the item's\ncontent kit and ``review_reasons`` why it needs a person. A run that held\nits kit for review reads ``awaiting_review`` while the kit is still held\nand the run is the one an approval would write (not after a newer run\nreplaced it or its write finished).","operationId":"get_job_status_api_public_v1_jobs__job_id__get","parameters":[{"in":"path","name":"job_id","required":true,"schema":{"format":"uuid","title":"Job Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicJobStatus"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Job not found (absent or not owned by the org)"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Get Job Status","tags":["public-api"]}},"/api/public/v1/org/settings":{"get":{"description":"Read your organization's settings, including the default publishing property.","operationId":"get_org_settings_api_public_v1_org_settings_get","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicOrganizationSettings"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Organization not found for API-key context"}},"summary":"Get Org Settings","tags":["public-api"]},"patch":{"description":"Partial update: omitted fields stay unchanged and an empty body returns 422. default_property_id sets the organization default publishing property, and explicit null clears it. A default_property_id that is not an active property of this organization (unknown, another organization's, inactive or deleted) returns 422 with a string detail.","operationId":"update_org_settings_api_public_v1_org_settings_patch","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicOrganizationSettingsUpdate"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicOrganizationSettings"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Organization not found for API-key context"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Update Org Settings","tags":["public-api"]}},"/api/public/v1/pillar-strategies":{"post":{"description":"Generate a clusters-first pillar strategy for a brand.\n\nDeduplication here is derived from the REQUEST, not from a client key: a\ncompleted snapshot for the same (org, brand, seeds, ``num_pillars``)\nsignature is returned as a free **200**, an in-flight run for the same\nsignature as a free **202**, and ``force_refresh: true`` is the deliberate\nbypass that starts a fresh charged run. A client key has nothing to add and\nwould defeat ``force_refresh``, so this route does **not** accept an\n``Idempotency-Key`` — sending one returns **422** rather than being\nsilently discarded.","operationId":"create_pillar_strategy_api_public_v1_pillar_strategies_post","parameters":[{"in":"header","name":"Idempotency-Key","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicPillarStrategyRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Brand not found (absent or not owned by the org)"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Create Pillar Strategy","tags":["public-api"]}},"/api/public/v1/pillar-strategies/{run_id}":{"get":{"description":"Poll a pillar strategy run started by POST /pillar-strategies. Returns the completed strategy, a failed or cancelled status with an error detail, or a generating status while the run is in progress.","operationId":"get_pillar_strategy_api_public_v1_pillar_strategies__run_id__get","parameters":[{"in":"path","name":"run_id","required":true,"schema":{"format":"uuid","title":"Run Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Pillar strategy run not found (absent or not owned by the org)"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Get Pillar Strategy","tags":["public-api"]}},"/api/public/v1/pillars":{"get":{"description":"List content pillars for the organization, with filter and pagination.","operationId":"list_pillars_api_public_v1_pillars_get","parameters":[{"description":"Filter by brand","in":"query","name":"brand_id","required":false,"schema":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"description":"Filter by brand","title":"Brand Id"}},{"in":"query","name":"active_only","required":false,"schema":{"default":true,"title":"Active Only","type":"boolean"}},{"in":"query","name":"status","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/ContentStatus"},{"type":"null"}],"title":"Status"}},{"description":"Results per page","in":"query","name":"limit","required":false,"schema":{"default":50,"description":"Results per page","maximum":200,"minimum":1,"title":"Limit","type":"integer"}},{"description":"Pagination offset","in":"query","name":"offset","required":false,"schema":{"default":0,"description":"Pagination offset","minimum":0,"title":"Offset","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicPage_PublicPillar_"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"List Pillars","tags":["public-api"]},"post":{"description":"Create a content pillar for a brand you own.\n\nThe ``Idempotency-Key`` header is **optional**: with one, a retry of the\nsame body replays the original pillar (``Idempotency-Replayed: true``); the\nsame key with a different body returns **409**.","operationId":"create_pillar_api_public_v1_pillars_post","parameters":[{"in":"header","name":"Idempotency-Key","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicPillarCreate"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicPillar"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Brand not found (absent or not owned by the org)"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Idempotency-Key reused with a different payload"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Create Pillar","tags":["public-api"]}},"/api/public/v1/pillars/{pillar_id}":{"delete":{"description":"Delete a content pillar. Returns 204 with no body; 404 when it does not exist or belongs to another organization.","operationId":"delete_pillar_api_public_v1_pillars__pillar_id__delete","parameters":[{"in":"path","name":"pillar_id","required":true,"schema":{"format":"uuid","title":"Pillar Id","type":"string"}}],"responses":{"204":{"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Pillar not found (absent or not owned by the org)"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Delete Pillar","tags":["public-api"]},"get":{"description":"Read one content pillar, including its keywords, goals, and linked audiences.","operationId":"get_pillar_api_public_v1_pillars__pillar_id__get","parameters":[{"in":"path","name":"pillar_id","required":true,"schema":{"format":"uuid","title":"Pillar Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicPillar"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Pillar not found (absent or not owned by the org)"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Get Pillar","tags":["public-api"]},"patch":{"description":"Partially update a content pillar: omitted fields stay unchanged. Returns the updated pillar.","operationId":"update_pillar_api_public_v1_pillars__pillar_id__patch","parameters":[{"in":"path","name":"pillar_id","required":true,"schema":{"format":"uuid","title":"Pillar Id","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicPillarUpdate"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicPillar"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Pillar not found (absent or not owned by the org)"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Update Pillar","tags":["public-api"]}},"/api/public/v1/ping":{"get":{"description":"Auth + rate-limit smoke endpoint. Echoes the resolved org.","operationId":"ping_api_public_v1_ping_get","responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":{"type":"string"},"title":"Response Ping Api Public V1 Ping Get","type":"object"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}}},"summary":"Ping","tags":["public-api"]}},"/api/public/v1/program-templates":{"get":{"description":"Every first-party programmatic-SEO template family, with the expansion and generator-input contract for each. The list is complete or it is an error: a catalogue that does not cover every family answers 503 rather than returning a shorter list.","operationId":"list_program_templates_api_public_v1_program_templates_get","responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/PublicProgramTemplate"},"title":"Response List Program Templates Api Public V1 Program Templates Get","type":"array"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Programs is parked: your organization is not on the allowlist, so every operation on this surface returns `{\"detail\": \"Programs is not enabled for this organization.\"}`. Ask support to enable Programs for your organization — see API.md § Programs."},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"The stored catalogue does not cover every template family. Retry; a partial catalogue is never returned as if it were complete."}},"summary":"List Program Templates","tags":["public-api"]}},"/api/public/v1/programs":{"get":{"description":"List your organization's programs, newest first, with per-stage counts.\n\nPrefer ``cursor`` / ``next_cursor`` for multi-page walks: offset paging can\nskip or duplicate rows when programs are created between requests.","operationId":"list_programs_api_public_v1_programs_get","parameters":[{"in":"query","name":"limit","required":false,"schema":{"default":50,"maximum":200,"minimum":1,"title":"Limit","type":"integer"}},{"description":"Offset into the newest-first list. Unstable under concurrent creates — prefer `cursor` for multi-page walks.","in":"query","name":"offset","required":false,"schema":{"default":0,"description":"Offset into the newest-first list. Unstable under concurrent creates — prefer `cursor` for multi-page walks.","minimum":0,"title":"Offset","type":"integer"}},{"description":"Opaque keyset cursor from a previous page's `next_cursor`. When set, `offset` is ignored.","in":"query","name":"cursor","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Opaque keyset cursor from a previous page's `next_cursor`. When set, `offset` is ignored.","title":"Cursor"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicPage_PublicProgram_"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Programs is parked: your organization is not on the allowlist, so every operation on this surface returns `{\"detail\": \"Programs is not enabled for this organization.\"}`. Ask support to enable Programs for your organization — see API.md § Programs."},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"List Programs","tags":["public-api"]},"post":{"description":"Create a program from a brand, a property, a template family, a scope and\na bulk set of seeds.\n\nThe program starts in ``draft``. Submitting the same seed twice for one\nprogram yields a single row. An optional ``Idempotency-Key`` replays a prior\ncreate for the same payload instead of writing a second program.","operationId":"create_program_api_public_v1_programs_post","parameters":[{"in":"header","name":"Idempotency-Key","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicProgramCreate"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicProgram"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Programs is parked: your organization is not on the allowlist, so every operation on this surface returns `{\"detail\": \"Programs is not enabled for this organization.\"}`. Ask support to enable Programs for your organization — see API.md § Programs."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"The brand or property is absent or not owned by your organization"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Idempotency-Key reused with a different payload, or a concurrent create with the same key is in progress"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Create Program","tags":["public-api"]}},"/api/public/v1/programs/{program_id}":{"get":{"description":"Retrieve one program, including how many ideas and plan pages sit in each\napproval state.","operationId":"get_program_api_public_v1_programs__program_id__get","parameters":[{"in":"path","name":"program_id","required":true,"schema":{"format":"uuid","title":"Program Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicProgram"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Programs is parked: your organization is not on the allowlist, so every operation on this surface returns `{\"detail\": \"Programs is not enabled for this organization.\"}`. Ask support to enable Programs for your organization — see API.md § Programs."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"The program is absent or not owned by your organization"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Get Program","tags":["public-api"]}},"/api/public/v1/programs/{program_id}/facts":{"get":{"description":"List the facts recorded for this program, ordered by entity then attribute.\n\nBoth the facts you supplied and those the platform researched at generate\ntime are listed; `origin` says which.","operationId":"list_program_facts_api_public_v1_programs__program_id__facts_get","parameters":[{"in":"path","name":"program_id","required":true,"schema":{"format":"uuid","title":"Program Id","type":"string"}},{"description":"Return only the facts for this entity, matched the way pages are (case and whitespace ignored). Omit for every entity; a blank value is refused.","in":"query","name":"entity","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Return only the facts for this entity, matched the way pages are (case and whitespace ignored). Omit for every entity; a blank value is refused.","maxLength":200,"minLength":1,"title":"Entity"}},{"in":"query","name":"limit","required":false,"schema":{"default":50,"maximum":200,"minimum":1,"title":"Limit","type":"integer"}},{"in":"query","name":"offset","required":false,"schema":{"default":0,"minimum":0,"title":"Offset","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicPage_PublicProgramFact_"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Programs is parked: your organization is not on the allowlist, so every operation on this surface returns `{\"detail\": \"Programs is not enabled for this organization.\"}`. Ask support to enable Programs for your organization — see API.md § Programs."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"The program is absent or not owned by your organization"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"List Program Facts","tags":["public-api"]},"post":{"description":"Record facts about this program's entities.\n\nOne entry per entity and attribute. Name the entity exactly as it appears in\na planned page's `expansion.entities` (case and whitespace are ignored);\nthe next `pages:generate` run builds that page's attribute matrix\n(`comparison`) or entity profile (`entity_review`) from the facts whose\nentity matches. A fact for an entity no page names is kept but never used.\n\nSending the same entity and attribute again replaces the earlier value, so\na retry converges on the same rows — this request does not accept an\n`Idempotency-Key`, and sending one returns `422`. A fact you supply is\nnever overwritten by the platform's own research.\n\nRefused with `422` when a value is a hedge (`unknown`, `n/a`, `not\nverified`, …) or an attribute is a search-demand metric (search volume,\nkeyword difficulty, CPC). Refused with `409` while the program is\n`generating`, because that run is reading the facts.\n\nSupplying facts does not change any page's `generation_state` on its own:\na `blocked` page stays `blocked` until the next `pages:generate` run\nre-checks it, and a page that already has a content item keeps the brief it\nwas written from.","operationId":"supply_program_facts_api_public_v1_programs__program_id__facts_post","parameters":[{"in":"path","name":"program_id","required":true,"schema":{"format":"uuid","title":"Program Id","type":"string"}},{"in":"header","name":"Idempotency-Key","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicProgramFactsSupply"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicProgramFactsSupplied"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Programs is parked: your organization is not on the allowlist, so every operation on this surface returns `{\"detail\": \"Programs is not enabled for this organization.\"}`. Ask support to enable Programs for your organization — see API.md § Programs."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"The program is absent or not owned by your organization"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"A generate run is reading the program's facts; retry once the program leaves `generating`"},"422":{"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/PublicErrorBody"},{"$ref":"#/components/schemas/HTTPValidationError"}]}}},"description":"Either schema validation failed (field-error detail array), or a value is a hedge, an attribute is a search-demand metric, or an Idempotency-Key was sent to a route that does not accept one (string detail). Branch on the type of detail — see API.md § Errors."}},"summary":"Supply Program Facts","tags":["public-api"]}},"/api/public/v1/programs/{program_id}/ideas":{"get":{"description":"List this program's ideas, oldest first, with what the research found.\n\nFilter with `?state=approved` to see exactly the set that will advance to the\nplan stage.","operationId":"list_program_ideas_api_public_v1_programs__program_id__ideas_get","parameters":[{"in":"path","name":"program_id","required":true,"schema":{"format":"uuid","title":"Program Id","type":"string"}},{"description":"Return only ideas in this approval state. Omit for all of them.","in":"query","name":"state","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/PublicProgramItemState"},{"type":"null"}],"description":"Return only ideas in this approval state. Omit for all of them.","title":"State"}},{"in":"query","name":"limit","required":false,"schema":{"default":50,"maximum":200,"minimum":1,"title":"Limit","type":"integer"}},{"in":"query","name":"offset","required":false,"schema":{"default":0,"minimum":0,"title":"Offset","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicPage_PublicProgramIdea_"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Programs is parked: your organization is not on the allowlist, so every operation on this surface returns `{\"detail\": \"Programs is not enabled for this organization.\"}`. Ask support to enable Programs for your organization — see API.md § Programs."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"The program (or idea) is absent or not owned by your organization"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"List Program Ideas","tags":["public-api"]},"post":{"description":"Add an idea of your own to this program, in `pending`.\n\nIdeas are deduplicated within a program on the primary keyword (falling back\nto the title), so adding the same idea twice returns the one you already\nhave. An optional `Idempotency-Key` replays the original `201`.","operationId":"add_program_idea_api_public_v1_programs__program_id__ideas_post","parameters":[{"in":"path","name":"program_id","required":true,"schema":{"format":"uuid","title":"Program Id","type":"string"}},{"in":"header","name":"Idempotency-Key","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicProgramIdeaCreate"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicProgramIdea"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Programs is parked: your organization is not on the allowlist, so every operation on this surface returns `{\"detail\": \"Programs is not enabled for this organization.\"}`. Ask support to enable Programs for your organization — see API.md § Programs."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"The program (or idea) is absent or not owned by your organization"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"The stage that consumes ideas is running, a stage is already in flight, or an Idempotency-Key was reused with a different payload"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Add Program Idea","tags":["public-api"]}},"/api/public/v1/programs/{program_id}/ideas/{idea_id}":{"patch":{"description":"Reserved. Editing an idea is not available yet and this always fails.\n\nDecline the idea and add a corrected one instead.","operationId":"edit_program_idea_api_public_v1_programs__program_id__ideas__idea_id__patch","parameters":[{"in":"path","name":"program_id","required":true,"schema":{"format":"uuid","title":"Program Id","type":"string"}},{"in":"path","name":"idea_id","required":true,"schema":{"format":"uuid","title":"Idea Id","type":"string"}}],"responses":{"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Programs is parked: your organization is not on the allowlist, so every operation on this surface returns `{\"detail\": \"Programs is not enabled for this organization.\"}`. Ask support to enable Programs for your organization — see API.md § Programs."},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"},"501":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Editing an idea is not available yet"}},"summary":"Edit Program Idea","tags":["public-api"]}},"/api/public/v1/programs/{program_id}/ideas/{idea_id}/approve":{"post":{"description":"Approve one idea. Only approved ideas advance to the plan stage.\n\nApproving an idea that is already approved is a no-op success, so a dropped\nresponse is safe to retry. This request does not accept an\n`Idempotency-Key` — it assigns a state rather than creating anything, so\nthere is nothing for a key to deduplicate.","operationId":"approve_program_idea_api_public_v1_programs__program_id__ideas__idea_id__approve_post","parameters":[{"in":"path","name":"program_id","required":true,"schema":{"format":"uuid","title":"Program Id","type":"string"}},{"in":"path","name":"idea_id","required":true,"schema":{"format":"uuid","title":"Idea Id","type":"string"}},{"in":"header","name":"Idempotency-Key","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicProgramIdea"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Programs is parked: your organization is not on the allowlist, so every operation on this surface returns `{\"detail\": \"Programs is not enabled for this organization.\"}`. Ask support to enable Programs for your organization — see API.md § Programs."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"The program (or idea) is absent or not owned by your organization"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"The stage that consumes ideas is running, a stage is already in flight, or an Idempotency-Key was reused with a different payload"},"422":{"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/PublicErrorBody"},{"$ref":"#/components/schemas/HTTPValidationError"}]}}},"description":"Either schema validation failed (field-error detail array) or an Idempotency-Key was sent to a route that does not accept one (string detail). Branch on the type of detail — see API.md § Errors."}},"summary":"Approve Program Idea","tags":["public-api"]}},"/api/public/v1/programs/{program_id}/ideas/{idea_id}/decline":{"post":{"description":"Decline one idea. A declined idea is kept but never becomes a page.\n\nDeclining is reversible — approve it later and it advances again. This\nrequest does not accept an `Idempotency-Key`.","operationId":"decline_program_idea_api_public_v1_programs__program_id__ideas__idea_id__decline_post","parameters":[{"in":"path","name":"program_id","required":true,"schema":{"format":"uuid","title":"Program Id","type":"string"}},{"in":"path","name":"idea_id","required":true,"schema":{"format":"uuid","title":"Idea Id","type":"string"}},{"in":"header","name":"Idempotency-Key","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicProgramIdea"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Programs is parked: your organization is not on the allowlist, so every operation on this surface returns `{\"detail\": \"Programs is not enabled for this organization.\"}`. Ask support to enable Programs for your organization — see API.md § Programs."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"The program (or idea) is absent or not owned by your organization"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"The stage that consumes ideas is running, a stage is already in flight, or an Idempotency-Key was reused with a different payload"},"422":{"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/PublicErrorBody"},{"$ref":"#/components/schemas/HTTPValidationError"}]}}},"description":"Either schema validation failed (field-error detail array) or an Idempotency-Key was sent to a route that does not accept one (string detail). Branch on the type of detail — see API.md § Errors."}},"summary":"Decline Program Idea","tags":["public-api"]}},"/api/public/v1/programs/{program_id}/ideas:approve-all":{"post":{"description":"Approve every high-confidence idea still pending, and report the counts.\n\nHigh-confidence means subject-sourced ideas, hand-added ideas, and related\nkeywords whose `relevance_score` clears the high-confidence floor. Lower-\nconfidence related keywords stay `pending` so you can curate them. Ideas\nyou have already declined are left declined — this convenience verb never\nreverses a decision you made deliberately. Approve a declined or low-\nconfidence idea individually if you change your mind.\n\nAn idea the program's template family cannot turn into a page of its own is\nalso left `pending`, whatever its score: on a `listicle` the page is the\nfacet, so an idea naming one of the program's scope entities is part of the\nranking every list carries rather than a page. On `comparison` and\n`entity_review` every subject is a page, so nothing is held back for this\nreason. This request does not accept an `Idempotency-Key`.","operationId":"approve_all_program_ideas_api_public_v1_programs__program_id__ideas_approve_all_post","parameters":[{"in":"path","name":"program_id","required":true,"schema":{"format":"uuid","title":"Program Id","type":"string"}},{"in":"header","name":"Idempotency-Key","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicProgramItemCounts"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Programs is parked: your organization is not on the allowlist, so every operation on this surface returns `{\"detail\": \"Programs is not enabled for this organization.\"}`. Ask support to enable Programs for your organization — see API.md § Programs."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"The program (or idea) is absent or not owned by your organization"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"The stage that consumes ideas is running, a stage is already in flight, or an Idempotency-Key was reused with a different payload"},"422":{"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/PublicErrorBody"},{"$ref":"#/components/schemas/HTTPValidationError"}]}}},"description":"Either schema validation failed (field-error detail array) or an Idempotency-Key was sent to a route that does not accept one (string detail). Branch on the type of detail — see API.md § Errors."}},"summary":"Approve All Program Ideas","tags":["public-api"]}},"/api/public/v1/programs/{program_id}/ideas:generate":{"post":{"description":"Research this program's seeds and scope, and propose ideas from them.\n\nReturns immediately with a `job_id`; poll `GET /jobs/{job_id}` until the job\nreaches a terminal status, then read `GET /programs/{program_id}/ideas` to\napprove or decline what it found. An `Idempotency-Key` header is required —\nthis research bills data providers, so a retried request must replay the\noriginal response rather than start (and charge for) a second run.","operationId":"generate_program_ideas_api_public_v1_programs__program_id__ideas_generate_post","parameters":[{"in":"path","name":"program_id","required":true,"schema":{"format":"uuid","title":"Program Id","type":"string"}},{"description":"Required. Dedupes this billed research run; a retry with the same key replays the original 202 instead of starting (and charging for) a second.","in":"header","name":"Idempotency-Key","required":true,"schema":{"description":"Required. Dedupes this billed research run; a retry with the same key replays the original 202 instead of starting (and charging for) a second.","title":"Idempotency-Key","type":"string"}}],"responses":{"202":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicProgramStageAccepted"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Programs is parked: your organization is not on the allowlist, so every operation on this surface returns `{\"detail\": \"Programs is not enabled for this organization.\"}`. Ask support to enable Programs for your organization — see API.md § Programs."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"The program (or idea) is absent or not owned by your organization"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"The stage that consumes ideas is running, a stage is already in flight, or an Idempotency-Key was reused with a different payload"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"The stage could not be started; retry shortly"}},"summary":"Generate Program Ideas","tags":["public-api"]}},"/api/public/v1/programs/{program_id}/pages":{"get":{"description":"List this program's pages and how far each has got, oldest first.\n\nEvery page carries a `generation_state`; a page whose state is `ready` has a\n`content_item_id` you can download with\n`GET /content/{content_item_id}?latest_only=true`.","operationId":"list_program_pages_api_public_v1_programs__program_id__pages_get","parameters":[{"in":"path","name":"program_id","required":true,"schema":{"format":"uuid","title":"Program Id","type":"string"}},{"description":"Return only pages in this approval state. Omit for all of them; pass `approved` to see exactly the set that generates.","in":"query","name":"state","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/PublicProgramItemState"},{"type":"null"}],"description":"Return only pages in this approval state. Omit for all of them; pass `approved` to see exactly the set that generates.","title":"State"}},{"in":"query","name":"limit","required":false,"schema":{"default":50,"maximum":200,"minimum":1,"title":"Limit","type":"integer"}},{"in":"query","name":"offset","required":false,"schema":{"default":0,"minimum":0,"title":"Offset","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicPage_PublicProgramPage_"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Programs is parked: your organization is not on the allowlist, so every operation on this surface returns `{\"detail\": \"Programs is not enabled for this organization.\"}`. Ask support to enable Programs for your organization — see API.md § Programs."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"The program is absent or not owned by your organization"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"List Program Pages","tags":["public-api"]}},"/api/public/v1/programs/{program_id}/pages:generate":{"post":{"description":"Write the pages you approved.\n\nReturns immediately with a `job_id`; poll `GET /jobs/{job_id}` until the job\nreaches a terminal status, then read `GET /programs/{program_id}/pages` to\nsee each page's progress and download the finished ones. Approve at least one\nplan page first — with nothing approved there is nothing to write and this\nreturns `409`.\n\nOnly pages in state `approved` are written. A `declined` page and a page you\nhave not decided on both produce nothing.\n\nAn approved page can also be refused before it is written. A `comparison`\npage needs an attribute matrix covering every compared entity — built from\nthe facts you supplied through `POST /programs/{program_id}/facts` or the\nplatform researched at generate time, a supplied fact winning over a\nresearched one — and an `entity_review` page needs supplied facts about\nits entity. A page whose gated input is still unusable is marked\n`blocked`: it keeps its approval, has no content item, reads\n`generation_state: blocked` on `GET /programs/{program_id}/pages` with\n`blocked_inputs` naming what is missing, and the completed job counts it\non `result.pages_skipped_missing_inputs`. Supply the facts and run this\nagain; the next run re-checks it. `listicle` pages are never blocked. The\njob reports `completed` either way, so compare `pages_dispatched` against\n`approved_pages` rather than reading a terminal status as a full yield.\n\nRe-running is safe: a page that already has a content item is never written a\nsecond time, so a retry adds only pages that are genuinely new. An\n`Idempotency-Key` header is required, so a retried request replays the\noriginal response rather than starting a second run.","operationId":"generate_program_pages_api_public_v1_programs__program_id__pages_generate_post","parameters":[{"in":"path","name":"program_id","required":true,"schema":{"format":"uuid","title":"Program Id","type":"string"}},{"description":"Required. Dedupes this billed page-generation run; a retry with the same key replays the original 202 instead of starting a second run.","in":"header","name":"Idempotency-Key","required":true,"schema":{"description":"Required. Dedupes this billed page-generation run; a retry with the same key replays the original 202 instead of starting a second run.","title":"Idempotency-Key","type":"string"}}],"responses":{"202":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicProgramStageAccepted"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Programs is parked: your organization is not on the allowlist, so every operation on this surface returns `{\"detail\": \"Programs is not enabled for this organization.\"}`. Ask support to enable Programs for your organization — see API.md § Programs."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"The program is absent or not owned by your organization"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"A stage is already in flight, no plan page has been approved yet, or an Idempotency-Key was reused with a different request"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"The organization's monthly content-generation allowance is exhausted (PROGRAM_QUOTA_EXCEEDED). Check GET /account.","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"},"Retry-After":{"$ref":"#/components/headers/Retry-After"}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"The stage could not be started; retry shortly"}},"summary":"Generate Program Pages","tags":["public-api"]}},"/api/public/v1/programs/{program_id}/plan":{"get":{"description":"List this program's planned pages, oldest first.\n\nFilter with `?state=approved` to see exactly the set that will be generated.","operationId":"list_program_plan_pages_api_public_v1_programs__program_id__plan_get","parameters":[{"in":"path","name":"program_id","required":true,"schema":{"format":"uuid","title":"Program Id","type":"string"}},{"description":"Return only plan pages in this approval state. Omit for all of them.","in":"query","name":"state","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/PublicProgramItemState"},{"type":"null"}],"description":"Return only plan pages in this approval state. Omit for all of them.","title":"State"}},{"in":"query","name":"limit","required":false,"schema":{"default":50,"maximum":200,"minimum":1,"title":"Limit","type":"integer"}},{"in":"query","name":"offset","required":false,"schema":{"default":0,"minimum":0,"title":"Offset","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicPage_PublicProgramPlanPage_"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Programs is parked: your organization is not on the allowlist, so every operation on this surface returns `{\"detail\": \"Programs is not enabled for this organization.\"}`. Ask support to enable Programs for your organization — see API.md § Programs."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"The program (or plan page) is absent or not owned by your organization"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"List Program Plan Pages","tags":["public-api"]},"post":{"description":"Add a page of your own to this program's plan, in `pending`.\n\nPages are deduplicated within a program on the title, so adding the same page\ntwice returns the one you already have. Unlike the automatic expansion, a\npage you add by hand is NOT filtered against the content you already have —\nyou asked for it by name. An optional `Idempotency-Key` replays the original\n`201`.","operationId":"add_program_plan_page_api_public_v1_programs__program_id__plan_post","parameters":[{"in":"path","name":"program_id","required":true,"schema":{"format":"uuid","title":"Program Id","type":"string"}},{"in":"header","name":"Idempotency-Key","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicProgramPlanPageCreate"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicProgramPlanPage"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Programs is parked: your organization is not on the allowlist, so every operation on this surface returns `{\"detail\": \"Programs is not enabled for this organization.\"}`. Ask support to enable Programs for your organization — see API.md § Programs."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"The program (or plan page) is absent or not owned by your organization"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"The stage that consumes plan pages is running, a stage is already in flight, no idea has been approved yet, or an Idempotency-Key was reused with a different payload"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Add Program Plan Page","tags":["public-api"]}},"/api/public/v1/programs/{program_id}/plan/{page_id}":{"patch":{"description":"Reserved. Editing a plan page is not available yet and this always fails.\n\nDecline the page and add a corrected one instead.","operationId":"edit_program_plan_page_api_public_v1_programs__program_id__plan__page_id__patch","parameters":[{"in":"path","name":"program_id","required":true,"schema":{"format":"uuid","title":"Program Id","type":"string"}},{"in":"path","name":"page_id","required":true,"schema":{"format":"uuid","title":"Page Id","type":"string"}}],"responses":{"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Programs is parked: your organization is not on the allowlist, so every operation on this surface returns `{\"detail\": \"Programs is not enabled for this organization.\"}`. Ask support to enable Programs for your organization — see API.md § Programs."},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"},"501":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Editing a plan page is not available yet"}},"summary":"Edit Program Plan Page","tags":["public-api"]}},"/api/public/v1/programs/{program_id}/plan/{page_id}/approve":{"post":{"description":"Approve one planned page. Only approved pages are generated.\n\nApproving a page that is already approved is a no-op success, so a dropped\nresponse is safe to retry. This request does not accept an\n`Idempotency-Key` — it assigns a state rather than creating anything, so\nthere is nothing for a key to deduplicate.","operationId":"approve_program_plan_page_api_public_v1_programs__program_id__plan__page_id__approve_post","parameters":[{"in":"path","name":"program_id","required":true,"schema":{"format":"uuid","title":"Program Id","type":"string"}},{"in":"path","name":"page_id","required":true,"schema":{"format":"uuid","title":"Page Id","type":"string"}},{"in":"header","name":"Idempotency-Key","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicProgramPlanPage"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Programs is parked: your organization is not on the allowlist, so every operation on this surface returns `{\"detail\": \"Programs is not enabled for this organization.\"}`. Ask support to enable Programs for your organization — see API.md § Programs."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"The program (or plan page) is absent or not owned by your organization"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"The stage that consumes plan pages is running, a stage is already in flight, no idea has been approved yet, or an Idempotency-Key was reused with a different payload"},"422":{"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/PublicErrorBody"},{"$ref":"#/components/schemas/HTTPValidationError"}]}}},"description":"Either schema validation failed (field-error detail array) or an Idempotency-Key was sent to a route that does not accept one (string detail). Branch on the type of detail — see API.md § Errors."}},"summary":"Approve Program Plan Page","tags":["public-api"]}},"/api/public/v1/programs/{program_id}/plan/{page_id}/decline":{"post":{"description":"Decline one planned page. A declined page is kept but never generated.\n\nDeclining is reversible — approve it later and it generates again. This\nrequest does not accept an `Idempotency-Key`.","operationId":"decline_program_plan_page_api_public_v1_programs__program_id__plan__page_id__decline_post","parameters":[{"in":"path","name":"program_id","required":true,"schema":{"format":"uuid","title":"Program Id","type":"string"}},{"in":"path","name":"page_id","required":true,"schema":{"format":"uuid","title":"Page Id","type":"string"}},{"in":"header","name":"Idempotency-Key","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicProgramPlanPage"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Programs is parked: your organization is not on the allowlist, so every operation on this surface returns `{\"detail\": \"Programs is not enabled for this organization.\"}`. Ask support to enable Programs for your organization — see API.md § Programs."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"The program (or plan page) is absent or not owned by your organization"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"The stage that consumes plan pages is running, a stage is already in flight, no idea has been approved yet, or an Idempotency-Key was reused with a different payload"},"422":{"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/PublicErrorBody"},{"$ref":"#/components/schemas/HTTPValidationError"}]}}},"description":"Either schema validation failed (field-error detail array) or an Idempotency-Key was sent to a route that does not accept one (string detail). Branch on the type of detail — see API.md § Errors."}},"summary":"Decline Program Plan Page","tags":["public-api"]}},"/api/public/v1/programs/{program_id}/plan:approve-all":{"post":{"description":"Approve every planned page still pending, and report the resulting counts.\n\nPages you have already declined are left declined — this convenience verb\nnever reverses a decision you made deliberately. Approve a declined page\nindividually if you change your mind. This request does not accept an\n`Idempotency-Key`.","operationId":"approve_all_program_plan_pages_api_public_v1_programs__program_id__plan_approve_all_post","parameters":[{"in":"path","name":"program_id","required":true,"schema":{"format":"uuid","title":"Program Id","type":"string"}},{"in":"header","name":"Idempotency-Key","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicProgramItemCounts"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Programs is parked: your organization is not on the allowlist, so every operation on this surface returns `{\"detail\": \"Programs is not enabled for this organization.\"}`. Ask support to enable Programs for your organization — see API.md § Programs."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"The program (or plan page) is absent or not owned by your organization"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"The stage that consumes plan pages is running, a stage is already in flight, no idea has been approved yet, or an Idempotency-Key was reused with a different payload"},"422":{"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/PublicErrorBody"},{"$ref":"#/components/schemas/HTTPValidationError"}]}}},"description":"Either schema validation failed (field-error detail array) or an Idempotency-Key was sent to a route that does not accept one (string detail). Branch on the type of detail — see API.md § Errors."}},"summary":"Approve All Program Plan Pages","tags":["public-api"]}},"/api/public/v1/programs/{program_id}/plan:generate":{"post":{"description":"Expand this program's template over the ideas you approved into a page list.\n\nReturns immediately with a `job_id`; poll `GET /jobs/{job_id}` until the job\nreaches a terminal status, then read `GET /programs/{program_id}/plan` to\napprove or decline what it planned. Approve at least one idea first — with\nnothing approved there is nothing to expand and this returns `409`.\n\nRe-running is safe: the expansion is deterministic, so a second run adds only\npages that are genuinely new and never duplicates one you already have. An\n`Idempotency-Key` header is required, so a retried request replays the\noriginal response rather than starting a second run.","operationId":"generate_program_plan_api_public_v1_programs__program_id__plan_generate_post","parameters":[{"in":"path","name":"program_id","required":true,"schema":{"format":"uuid","title":"Program Id","type":"string"}},{"description":"Required. Dedupes this billed expansion; a retry with the same key replays the original 202 instead of starting a second run.","in":"header","name":"Idempotency-Key","required":true,"schema":{"description":"Required. Dedupes this billed expansion; a retry with the same key replays the original 202 instead of starting a second run.","title":"Idempotency-Key","type":"string"}}],"responses":{"202":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicProgramStageAccepted"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Programs is parked: your organization is not on the allowlist, so every operation on this surface returns `{\"detail\": \"Programs is not enabled for this organization.\"}`. Ask support to enable Programs for your organization — see API.md § Programs."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"The program (or plan page) is absent or not owned by your organization"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"The stage that consumes plan pages is running, a stage is already in flight, no idea has been approved yet, or an Idempotency-Key was reused with a different payload"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"The stage could not be started; retry shortly"}},"summary":"Generate Program Plan","tags":["public-api"]}},"/api/public/v1/properties":{"get":{"description":"List the org's publishing properties, optionally filtered and paginated.\n\n``channel_type`` and ``verified_only`` combine with AND; ``total`` and\n``has_more`` reflect the composed filter.","operationId":"list_properties_api_public_v1_properties_get","parameters":[{"description":"Optional channel-type filter","in":"query","name":"channel_type","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/ChannelType"},{"type":"null"}],"description":"Optional channel-type filter","title":"Channel Type"}},{"description":"Only return verified properties","in":"query","name":"verified_only","required":false,"schema":{"default":false,"description":"Only return verified properties","title":"Verified Only","type":"boolean"}},{"description":"Results per page","in":"query","name":"limit","required":false,"schema":{"default":50,"description":"Results per page","maximum":200,"minimum":1,"title":"Limit","type":"integer"}},{"description":"Pagination offset","in":"query","name":"offset","required":false,"schema":{"default":0,"description":"Pagination offset","minimum":0,"title":"Offset","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicPage_PublicProperty_"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"List Properties","tags":["public-api"]},"post":{"description":"Create a publishing property from the caller's own input.\n\nDuplicate URL → **409**. ``brand_id`` is required, including for\nsingle-brand organizations. Missing or null brand input returns **422**;\nan unknown or foreign brand returns **404**.\n\nSet ``publish_policy`` to ``draft_only`` for a headless integration: pages\ngenerated for the property then finish on their own and are collected with\n``GET /content/{content_item_id}``. The default, ``cms_publish``, requires a\nconnected CMS — without one, generation runs stop and wait for a person in\nthe RoboWrite dashboard.\n\nThe ``Idempotency-Key`` header is **optional**: with one, a retry of the\nsame body replays the original property (``Idempotency-Replayed: true``);\nthe same key with a different body returns **409**.","operationId":"create_property_api_public_v1_properties_post","parameters":[{"in":"header","name":"Idempotency-Key","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicPropertyCreate"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicProperty"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"A property with this URL already exists, or the Idempotency-Key was reused with a different payload"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Create Property","tags":["public-api"]}},"/api/public/v1/properties/{property_id}":{"get":{"description":"Retrieve a single property owned by the org.","operationId":"get_property_api_public_v1_properties__property_id__get","parameters":[{"in":"path","name":"property_id","required":true,"schema":{"format":"uuid","title":"Property Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicProperty"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Property not found (absent or not owned by the org)"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Get Property","tags":["public-api"]},"patch":{"description":"Change ``publish_policy`` on an existing property.\n\nOnly ``publish_policy`` is accepted. Send ``draft_only`` for headless\ncollection via ``GET /content/{id}``, or ``cms_publish`` to re-enable\nCMS auto-publish for topic-autopilot. Explicit ``null`` and unknown keys\nare **422**. A missing or foreign property is **404**.\n\n``PATCH`` is outside the Idempotency-Key scheme — re-applying the same\npolicy is a no-op that converges on the same state.","operationId":"update_property_api_public_v1_properties__property_id__patch","parameters":[{"in":"path","name":"property_id","required":true,"schema":{"format":"uuid","title":"Property Id","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicPropertyUpdate"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicProperty"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Property not found (absent or not owned by the org)"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Update Property","tags":["public-api"]}},"/api/public/v1/reviewers":{"get":{"description":"List current organization members eligible for editorial review.","operationId":"list_reviewers_api_public_v1_reviewers_get","responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/OrgMember"},"title":"Response List Reviewers Api Public V1 Reviewers Get","type":"array"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}}},"summary":"List Reviewers","tags":["public-api"]}},"/api/public/v1/reviews":{"get":{"description":"Read durable editorial reviews and their exact version references after a disconnected session. An approved review authorizes editorial use and export only. Check is_current before using it.","operationId":"list_reviews_api_public_v1_reviews_get","parameters":[{"in":"query","name":"content_item_id","required":false,"schema":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Content Item Id"}},{"in":"query","name":"limit","required":false,"schema":{"default":50,"maximum":200,"minimum":1,"title":"Limit","type":"integer"}},{"in":"query","name":"offset","required":false,"schema":{"default":0,"minimum":0,"title":"Offset","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReviewList"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"List Reviews","tags":["public-api"]},"post":{"description":"Request editorial review of the current saved nonempty version. Repeating the same version recovers its review. This does not start generation or publication.","operationId":"request_review_api_public_v1_reviews_post","parameters":[{"in":"header","name":"Idempotency-Key","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReviewCreateRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EditorialReview"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Request Review","tags":["public-api"]}},"/api/public/v1/reviews/{review_id}":{"get":{"description":"Read one editorial review and its persisted decision even after the original job ends. This read never generates content or publishes.","operationId":"get_review_api_public_v1_reviews__review_id__get","parameters":[{"in":"path","name":"review_id","required":true,"schema":{"format":"uuid","title":"Review Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EditorialReview"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Get Review","tags":["public-api"]}},"/api/public/v1/reviews/{review_id}/assignments":{"post":{"description":"Claim an unassigned review for yourself, or assign/reassign a current organization member as an organization admin. Supply the exact version and current assignment revision. Reuse request_id with identical input on retries; changed assignments conflict.","operationId":"assign_review_api_public_v1_reviews__review_id__assignments_post","parameters":[{"in":"path","name":"review_id","required":true,"schema":{"format":"uuid","title":"Review Id","type":"string"}},{"in":"header","name":"Idempotency-Key","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReviewAssignmentRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReviewAssignment"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Assign Review","tags":["public-api"]}},"/api/public/v1/reviews/{review_id}/decisions":{"post":{"description":"Apply an editorial decision to the exact current version. Only the assigned current member or an organization admin may decide. Reuse request_id with identical input after a lost response. Approval never publishes; rejection retains the draft; a revision request records feedback and stops. Editing or rewriting requires another explicit action.","operationId":"decide_review_api_public_v1_reviews__review_id__decisions_post","parameters":[{"in":"path","name":"review_id","required":true,"schema":{"format":"uuid","title":"Review Id","type":"string"}},{"in":"header","name":"Idempotency-Key","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReviewDecisionRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReviewDecision"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Decide Review","tags":["public-api"]}},"/api/public/v1/tags":{"get":{"description":"List a brand's tags in pages of up to 200.","operationId":"list_tags_api_public_v1_tags_get","parameters":[{"description":"Brand whose tags to list","in":"query","name":"brand_id","required":true,"schema":{"description":"Brand whose tags to list","format":"uuid","title":"Brand Id","type":"string"}},{"description":"Results per page","in":"query","name":"limit","required":false,"schema":{"default":50,"description":"Results per page","maximum":200,"minimum":1,"title":"Limit","type":"integer"}},{"description":"Pagination offset","in":"query","name":"offset","required":false,"schema":{"default":0,"description":"Pagination offset","minimum":0,"title":"Offset","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicPage_PublicTag_"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"List Tags","tags":["public-api"]},"post":{"description":"Create a tag for a brand you own.\n\nThe ``Idempotency-Key`` header is **optional**: with one, a retry of the\nsame body replays the original tag (``Idempotency-Replayed: true``); the\nsame key with a different body returns **409**.","operationId":"create_tag_api_public_v1_tags_post","parameters":[{"in":"header","name":"Idempotency-Key","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicTagCreate"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicTag"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Brand not found (absent or not owned by the org)"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Slug already exists for this brand, or the Idempotency-Key was reused with a different payload"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Create Tag","tags":["public-api"]}},"/api/public/v1/tags/{tag_id}":{"delete":{"description":"Delete a tag. Returns 204 with no body; 404 when it does not exist or belongs to another organization.","operationId":"delete_tag_api_public_v1_tags__tag_id__delete","parameters":[{"in":"path","name":"tag_id","required":true,"schema":{"format":"uuid","title":"Tag Id","type":"string"}}],"responses":{"204":{"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Tag not found (absent or not owned by the org)"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Delete Tag","tags":["public-api"]},"get":{"description":"Read one tag, including its parent and usage count.","operationId":"get_tag_api_public_v1_tags__tag_id__get","parameters":[{"in":"path","name":"tag_id","required":true,"schema":{"format":"uuid","title":"Tag Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicTag"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Tag not found (absent or not owned by the org)"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Get Tag","tags":["public-api"]},"patch":{"description":"Partially update a tag: omitted fields stay unchanged. Returns 409 when the new slug is already used by the brand.","operationId":"update_tag_api_public_v1_tags__tag_id__patch","parameters":[{"in":"path","name":"tag_id","required":true,"schema":{"format":"uuid","title":"Tag Id","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicTagUpdate"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicTag"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Tag not found (absent or not owned by the org)"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Slug already exists for this brand"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Update Tag","tags":["public-api"]}},"/api/public/v1/topics":{"get":{"description":"List a brand's topic-bank ideas with filter, search, sort, and pagination.\n\nRequires ``brand_id``. Returns a page of topics with eligibility and\nscoring fields where available.","operationId":"list_topics_api_public_v1_topics_get","parameters":[{"description":"Brand whose topics to list","in":"query","name":"brand_id","required":true,"schema":{"description":"Brand whose topics to list","format":"uuid","title":"Brand Id","type":"string"}},{"description":"Filter by pillar","in":"query","name":"pillar_id","required":false,"schema":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"description":"Filter by pillar","title":"Pillar Id"}},{"description":"Filter by keyword across title, primary, and secondary keywords","in":"query","name":"keyword","required":false,"schema":{"anyOf":[{"maxLength":120,"minLength":1,"type":"string"},{"type":"null"}],"description":"Filter by keyword across title, primary, and secondary keywords","title":"Keyword"}},{"description":"Filter by status","in":"query","name":"status","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/TopicIdeaStatus"},{"type":"null"}],"description":"Filter by status","title":"Status"}},{"description":"Minimum total score","in":"query","name":"min_score","required":false,"schema":{"default":0,"description":"Minimum total score","maximum":5,"minimum":0,"title":"Min Score","type":"number"}},{"description":"Property context for scores","in":"query","name":"property_id","required":false,"schema":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"description":"Property context for scores","title":"Property Id"}},{"description":"Results per page","in":"query","name":"limit","required":false,"schema":{"default":50,"description":"Results per page","maximum":200,"minimum":1,"title":"Limit","type":"integer"}},{"description":"Pagination offset","in":"query","name":"offset","required":false,"schema":{"default":0,"description":"Pagination offset","minimum":0,"title":"Offset","type":"integer"}},{"description":"Sort field","in":"query","name":"sort_by","required":false,"schema":{"$ref":"#/components/schemas/_TopicSortBy","default":"total_score","description":"Sort field"}},{"description":"Sort order","in":"query","name":"sort_order","required":false,"schema":{"$ref":"#/components/schemas/SortDirection","default":"desc","description":"Sort order"}},{"description":"Minimum search volume","in":"query","name":"min_volume","required":false,"schema":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"Minimum search volume","title":"Min Volume"}},{"description":"Maximum keyword difficulty","in":"query","name":"max_difficulty","required":false,"schema":{"anyOf":[{"maximum":100,"minimum":0,"type":"number"},{"type":"null"}],"description":"Maximum keyword difficulty","title":"Max Difficulty"}},{"description":"Search intent filter","in":"query","name":"intent","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/SearchIntent"},{"type":"null"}],"description":"Search intent filter","title":"Intent"}},{"description":"Filter by editorial routing band","in":"query","name":"decision_band","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/DecisionBand"},{"type":"null"}],"description":"Filter by editorial routing band","title":"Decision Band"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicPage_PublicTopic_"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"List Topics","tags":["public-api"]}},"/api/public/v1/topics/{topic_id}":{"get":{"description":"Retrieve a single topic by id.\n\nOrg-scoped; missing or foreign topics return **404**. Score market signals\nare list-read only and come back null on this endpoint.","operationId":"get_topic_api_public_v1_topics__topic_id__get","parameters":[{"in":"path","name":"topic_id","required":true,"schema":{"format":"uuid","title":"Topic Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicTopic"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Topic not found (absent or not owned by the org)"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Get Topic","tags":["public-api"]}},"/api/public/v1/topics/{topic_id}/content":{"get":{"description":"List content through direct topic-to-brief lineage, with AND filters.","operationId":"list_topic_content_api_public_v1_topics__topic_id__content_get","parameters":[{"in":"path","name":"topic_id","required":true,"schema":{"format":"uuid","title":"Topic Id","type":"string"}},{"in":"query","name":"brand_id","required":false,"schema":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Brand Id"}},{"in":"query","name":"property_id","required":false,"schema":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Property Id"}},{"in":"query","name":"status","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/TaskStatus"},{"type":"null"}],"title":"Status"}},{"in":"query","name":"format","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/ContentFormat"},{"type":"null"}],"title":"Format"}},{"in":"query","name":"pillar_id","required":false,"schema":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Pillar Id"}},{"in":"query","name":"created_from","required":false,"schema":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Created From"}},{"in":"query","name":"created_before","required":false,"schema":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Created Before"}},{"in":"query","name":"q","required":false,"schema":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"title":"Q"}},{"in":"query","name":"keyword","required":false,"schema":{"anyOf":[{"maxLength":255,"type":"string"},{"type":"null"}],"title":"Keyword"}},{"in":"query","name":"limit","required":false,"schema":{"default":50,"maximum":200,"minimum":1,"title":"Limit","type":"integer"}},{"in":"query","name":"offset","required":false,"schema":{"default":0,"minimum":0,"title":"Offset","type":"integer"}},{"in":"query","name":"content_type","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/ContentFormat"},{"type":"null"}],"title":"Content Type"}},{"in":"query","name":"brief_id","required":false,"schema":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Brief Id"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicPage_PublicContentSummary_"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Topic not found (absent or not owned by the org)"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"List Topic Content","tags":["public-api"]}},"/api/public/v1/topics/{topic_id}/scores":{"get":{"description":"List a topic's stored scores across properties.\n\nReads cached score rows only — does not trigger scoring or external\nprovider calls. A missing or foreign topic returns **404**.","operationId":"get_topic_scores_api_public_v1_topics__topic_id__scores_get","parameters":[{"in":"path","name":"topic_id","required":true,"schema":{"format":"uuid","title":"Topic Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/PublicTopicScore"},"title":"Response Get Topic Scores Api Public V1 Topics  Topic Id  Scores Get","type":"array"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Topic not found (absent or not owned by the org)"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Get Topic Scores","tags":["public-api"]}},"/api/public/v2/organizations":{"get":{"description":"Discover your workspaces and whether their current access and security requirements are proven. This does not select a workspace or start work.","operationId":"list_organizations_api_public_v2_organizations_get","parameters":[{"in":"query","name":"limit","required":false,"schema":{"default":100,"maximum":100,"minimum":1,"title":"Limit","type":"integer"}},{"in":"query","name":"offset","required":false,"schema":{"default":0,"minimum":0,"title":"Offset","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrganizationDiscovery"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"RoboWriteMultiOrgOAuth":["robowrite:organizations:read"]}],"summary":"List Organizations","tags":["public-api"]}},"/api/public/v2/organizations/{organization_id}/access":{"get":{"description":"Read your current role, consented permissions and security eligibility in one workspace. Allowance, object ownership and exact-version reviews remain separate checks.","operationId":"get_organization_access_api_public_v2_organizations__organization_id__access_get","parameters":[{"in":"path","name":"organization_id","required":true,"schema":{"pattern":"^org_[A-Za-z0-9_]+$","title":"Organization Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrganizationAccess"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"RoboWriteMultiOrgOAuth":["robowrite:organizations:read"]}],"summary":"Get Organization Access","tags":["public-api"]}},"/api/public/v2/organizations/{organization_id}/account":{"get":{"description":"Return org, brands accessible to the key, monthly quota, overage flags, and integration capabilities.","operationId":"multi_org_get_account_api_public_v1_account_get","parameters":[{"in":"path","name":"organization_id","required":true,"schema":{"pattern":"^org_[A-Za-z0-9_]+$","title":"Organization Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicAccount"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Organization not found for API-key context"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"RoboWriteMultiOrgOAuth":["robowrite:content:all_orgs","robowrite:organizations:read"]}],"summary":"Multi Org Get Account","tags":["public-api"]}},"/api/public/v2/organizations/{organization_id}/article-templates":{"get":{"description":"List built-in article presets followed by your organization's templates. Archived templates are omitted unless requested. Follow has_more using offset and limit.","operationId":"multi_org_list_article_templates_api_public_v1_article_templates_get","parameters":[{"in":"path","name":"organization_id","required":true,"schema":{"pattern":"^org_[A-Za-z0-9_]+$","title":"Organization Id","type":"string"}},{"in":"query","name":"include_archived","required":false,"schema":{"default":false,"title":"Include Archived","type":"boolean"}},{"in":"query","name":"offset","required":false,"schema":{"default":0,"minimum":0,"title":"Offset","type":"integer"}},{"in":"query","name":"limit","required":false,"schema":{"default":50,"maximum":200,"minimum":1,"title":"Limit","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ArticleTemplatePage"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"RoboWriteMultiOrgOAuth":["robowrite:content:all_orgs","robowrite:organizations:read"]}],"summary":"Multi Org List Article Templates","tags":["public-api"]}},"/api/public/v2/organizations/{organization_id}/article-templates/{template_id}":{"get":{"description":"Read an article preset by built-in key or organization template UUID. Includes archived templates. A missing or foreign UUID returns 404.","operationId":"multi_org_get_article_template_api_public_v1_article_templates__template_id__get","parameters":[{"in":"path","name":"template_id","required":true,"schema":{"anyOf":[{"$ref":"#/components/schemas/ArticleTemplateKey"},{"format":"uuid","type":"string"}],"title":"Template Id"}},{"in":"path","name":"organization_id","required":true,"schema":{"pattern":"^org_[A-Za-z0-9_]+$","title":"Organization Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ArticleTemplateRecord"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"RoboWriteMultiOrgOAuth":["robowrite:content:all_orgs","robowrite:organizations:read"]}],"summary":"Multi Org Get Article Template","tags":["public-api"]}},"/api/public/v2/organizations/{organization_id}/audiences":{"get":{"description":"List a brand's audiences, optionally filtered by status, in pages of up to 200.","operationId":"multi_org_list_audiences_api_public_v1_audiences_get","parameters":[{"in":"path","name":"organization_id","required":true,"schema":{"pattern":"^org_[A-Za-z0-9_]+$","title":"Organization Id","type":"string"}},{"description":"Brand whose audiences to list","in":"query","name":"brand_id","required":true,"schema":{"description":"Brand whose audiences to list","format":"uuid","title":"Brand Id","type":"string"}},{"in":"query","name":"status","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/EntityStatus"},{"type":"null"}],"title":"Status"}},{"description":"Results per page","in":"query","name":"limit","required":false,"schema":{"default":50,"description":"Results per page","maximum":200,"minimum":1,"title":"Limit","type":"integer"}},{"description":"Pagination offset","in":"query","name":"offset","required":false,"schema":{"default":0,"description":"Pagination offset","minimum":0,"title":"Offset","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicPage_PublicAudience_"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"RoboWriteMultiOrgOAuth":["robowrite:content:all_orgs","robowrite:organizations:read"]}],"summary":"Multi Org List Audiences","tags":["public-api"]},"post":{"description":"Create an audience for a brand you own.\n\nThe ``Idempotency-Key`` header is **optional**: with one, a retry of the\nsame body replays the original audience (``Idempotency-Replayed: true``);\nthe same key with a different body returns **409**.","operationId":"multi_org_create_audience_api_public_v1_audiences_post","parameters":[{"in":"path","name":"organization_id","required":true,"schema":{"pattern":"^org_[A-Za-z0-9_]+$","title":"Organization Id","type":"string"}},{"in":"header","name":"Idempotency-Key","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicAudienceCreate"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicAudience"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Brand not found (absent or not owned by the org)"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"The Idempotency-Key was reused with a different payload"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"RoboWriteMultiOrgOAuth":["robowrite:content:all_orgs","robowrite:organizations:read"]}],"summary":"Multi Org Create Audience","tags":["public-api"]}},"/api/public/v2/organizations/{organization_id}/audiences/{audience_id}":{"get":{"description":"Read one audience, including its pain points. Returns 404 when it does not exist or belongs to another organization.","operationId":"multi_org_get_audience_api_public_v1_audiences__audience_id__get","parameters":[{"in":"path","name":"audience_id","required":true,"schema":{"format":"uuid","title":"Audience Id","type":"string"}},{"in":"path","name":"organization_id","required":true,"schema":{"pattern":"^org_[A-Za-z0-9_]+$","title":"Organization Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicAudience"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Audience not found (absent or not owned by the org)"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"RoboWriteMultiOrgOAuth":["robowrite:content:all_orgs","robowrite:organizations:read"]}],"summary":"Multi Org Get Audience","tags":["public-api"]}},"/api/public/v2/organizations/{organization_id}/brand-setups":{"post":{"description":"Research a website for review. Requires Idempotency-Key; a matching retry\nreturns the same setup and job. Different input with that key, or an active\ndashboard setup, returns 409. Does not create a brand or draft.","operationId":"multi_org_start_brand_setup_api_public_v1_brand_setups_post","parameters":[{"in":"path","name":"organization_id","required":true,"schema":{"pattern":"^org_[A-Za-z0-9_]+$","title":"Organization Id","type":"string"}},{"in":"header","name":"Idempotency-Key","required":true,"schema":{"title":"Idempotency-Key","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicBrandSetupCreate"}}},"required":true},"responses":{"202":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicBrandSetupStarted"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Conflict"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"RoboWriteMultiOrgOAuth":["robowrite:content:all_orgs","robowrite:organizations:read"]}],"summary":"Multi Org Start Brand Setup","tags":["public-api"]}},"/api/public/v2/organizations/{organization_id}/brand-setups/{setup_id}":{"get":{"description":"Read progress and bounded brand/voice suggestions. Review ready suggestions\nbefore confirming. Failed research never silently creates a placeholder brand.","operationId":"multi_org_get_brand_setup_api_public_v1_brand_setups__setup_id__get","parameters":[{"in":"path","name":"setup_id","required":true,"schema":{"format":"uuid","title":"Setup Id","type":"string"}},{"in":"path","name":"organization_id","required":true,"schema":{"pattern":"^org_[A-Za-z0-9_]+$","title":"Organization Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicBrandSetup"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Conflict"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"RoboWriteMultiOrgOAuth":["robowrite:content:all_orgs","robowrite:organizations:read"]}],"summary":"Multi Org Get Brand Setup","tags":["public-api"]}},"/api/public/v2/organizations/{organization_id}/brand-setups/{setup_id}/confirm":{"post":{"description":"Create a new brand from reviewed research and optional edits. Requires\nIdempotency-Key; matching retries return the same brand. Existing brands\nand the current primary brand are preserved. No content is generated or published.","operationId":"multi_org_confirm_brand_setup_api_public_v1_brand_setups__setup_id__confirm_post","parameters":[{"in":"path","name":"setup_id","required":true,"schema":{"format":"uuid","title":"Setup Id","type":"string"}},{"in":"path","name":"organization_id","required":true,"schema":{"pattern":"^org_[A-Za-z0-9_]+$","title":"Organization Id","type":"string"}},{"in":"header","name":"Idempotency-Key","required":true,"schema":{"title":"Idempotency-Key","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicBrandSetupConfirm"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicBrand"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Conflict"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"RoboWriteMultiOrgOAuth":["robowrite:content:all_orgs","robowrite:organizations:read"]}],"summary":"Multi Org Confirm Brand Setup","tags":["public-api"]}},"/api/public/v2/organizations/{organization_id}/brands":{"get":{"description":"List brands linked to the authenticated org (newest first), paginated.","operationId":"multi_org_list_brands_api_public_v1_brands_get","parameters":[{"in":"path","name":"organization_id","required":true,"schema":{"pattern":"^org_[A-Za-z0-9_]+$","title":"Organization Id","type":"string"}},{"description":"Results per page","in":"query","name":"limit","required":false,"schema":{"default":100,"description":"Results per page","maximum":200,"minimum":1,"title":"Limit","type":"integer"}},{"description":"Pagination offset","in":"query","name":"offset","required":false,"schema":{"default":0,"description":"Pagination offset","minimum":0,"title":"Offset","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicPage_PublicBrand_"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"RoboWriteMultiOrgOAuth":["robowrite:content:all_orgs","robowrite:organizations:read"]}],"summary":"Multi Org List Brands","tags":["public-api"]}},"/api/public/v2/organizations/{organization_id}/brands/{brand_id}":{"get":{"description":"Retrieve a single brand owned by the org.","operationId":"multi_org_get_brand_api_public_v1_brands__brand_id__get","parameters":[{"in":"path","name":"brand_id","required":true,"schema":{"format":"uuid","title":"Brand Id","type":"string"}},{"in":"path","name":"organization_id","required":true,"schema":{"pattern":"^org_[A-Za-z0-9_]+$","title":"Organization Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicBrand"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Brand not found (absent or not owned by the org)"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"RoboWriteMultiOrgOAuth":["robowrite:content:all_orgs","robowrite:organizations:read"]}],"summary":"Multi Org Get Brand","tags":["public-api"]},"patch":{"description":"Update brand-voice fields used by content generation.\n\nOnly allow-listed voice fields are accepted. Omitted keys are left\nunchanged. Explicit ``null`` clears nullable text fields; ``tone`` and\nthe phrase arrays reject ``null`` (**422** — use ``[]`` to clear an\narray). Missing or foreign brand ids return **404**. Not billable.","operationId":"multi_org_update_brand_api_public_v1_brands__brand_id__patch","parameters":[{"in":"path","name":"brand_id","required":true,"schema":{"format":"uuid","title":"Brand Id","type":"string"}},{"in":"path","name":"organization_id","required":true,"schema":{"pattern":"^org_[A-Za-z0-9_]+$","title":"Organization Id","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicBrandUpdate"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicBrand"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Brand not found (absent or not owned by the org)"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"RoboWriteMultiOrgOAuth":["robowrite:content:all_orgs","robowrite:organizations:read"]}],"summary":"Multi Org Update Brand","tags":["public-api"]}},"/api/public/v2/organizations/{organization_id}/brands/{brand_id}/topics":{"post":{"description":"Create a topic from your own title, keyword, and angle.\n\nThe brand must belong to your organization (**404** otherwise). Optional\n``Idempotency-Key`` replays a prior create for the same payload. Returns\n**201** with the created topic.","operationId":"multi_org_create_topic_api_public_v1_brands__brand_id__topics_post","parameters":[{"in":"path","name":"brand_id","required":true,"schema":{"format":"uuid","title":"Brand Id","type":"string"}},{"in":"path","name":"organization_id","required":true,"schema":{"pattern":"^org_[A-Za-z0-9_]+$","title":"Organization Id","type":"string"}},{"in":"header","name":"Idempotency-Key","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicTopicCreate"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicTopic"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Brand not found (absent or not owned by the org)"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Idempotency-Key reused with a different payload, or a concurrent create with the same key is in progress"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"RoboWriteMultiOrgOAuth":["robowrite:content:all_orgs","robowrite:organizations:read"]}],"summary":"Multi Org Create Topic","tags":["public-api"]}},"/api/public/v2/organizations/{organization_id}/briefs":{"get":{"description":"Search briefs with AND filters and a bounded linked-content preview.","operationId":"multi_org_list_briefs_api_public_v1_briefs_get","parameters":[{"in":"path","name":"organization_id","required":true,"schema":{"pattern":"^org_[A-Za-z0-9_]+$","title":"Organization Id","type":"string"}},{"in":"query","name":"brand_id","required":false,"schema":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Brand Id"}},{"in":"query","name":"property_id","required":false,"schema":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Property Id"}},{"in":"query","name":"status","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/TaskStatus"},{"type":"null"}],"title":"Status"}},{"in":"query","name":"format","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/ContentFormat"},{"type":"null"}],"title":"Format"}},{"in":"query","name":"pillar_id","required":false,"schema":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Pillar Id"}},{"in":"query","name":"created_from","required":false,"schema":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Created From"}},{"in":"query","name":"created_before","required":false,"schema":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Created Before"}},{"in":"query","name":"q","required":false,"schema":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"title":"Q"}},{"in":"query","name":"keyword","required":false,"schema":{"anyOf":[{"maxLength":255,"type":"string"},{"type":"null"}],"title":"Keyword"}},{"in":"query","name":"limit","required":false,"schema":{"default":50,"maximum":200,"minimum":1,"title":"Limit","type":"integer"}},{"in":"query","name":"offset","required":false,"schema":{"default":0,"minimum":0,"title":"Offset","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicPage_PublicBrief_"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"RoboWriteMultiOrgOAuth":["robowrite:content:all_orgs","robowrite:organizations:read"]}],"summary":"Multi Org List Briefs","tags":["public-api"]},"post":{"description":"Create a brief and approve it so it is immediately ready for generation.\n\nSupply brand_id to target an owned brand; omission or null returns **422**.\nA supplied pillar must belong to the selected brand. An ``outline`` (ordered\nH2 titles) is saved as structured sections. Returns **201**.\n\nThe ``Idempotency-Key`` header is **optional**. With one, a retry of the\nsame body replays the original brief (``Idempotency-Replayed: true``)\ninstead of creating a second one, and the same key with a different body\nreturns **409**. Without one there is no deduplication and a retried POST\ncreates a second brief.\n\n``facts`` needs the v2 article pipeline: while it is not enabled a brief\nwith facts is refused with **409** ``article_pipeline_not_v2``. A fact a\nregulated workspace sends without a ``source_url``, or whose\n``source_url`` the brand source policy or blocked hosts refuse, is a\n**422** with ``detail.code`` (``user_fact_source_url_required`` /\n``user_fact_source_url_ineligible``), as on the kit-fact route.\n\n``article_spec`` marks each article element required, optional or off\nand sets citation, FAQ, length and other targets; omit it for the\nstandard article. An invalid spec is a **422** naming the field; a\nrequired source missing from ``source_urls`` is a **422** with\n``detail.code`` ``article_spec_required_source_not_in_brief``.","operationId":"multi_org_create_brief_api_public_v1_briefs_post","parameters":[{"in":"path","name":"organization_id","required":true,"schema":{"pattern":"^org_[A-Za-z0-9_]+$","title":"Organization Id","type":"string"}},{"in":"header","name":"Idempotency-Key","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicBriefCreate"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicBrief"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Idempotency-Key reused with a different payload, or a concurrent create with the same key is in progress"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"RoboWriteMultiOrgOAuth":["robowrite:content:all_orgs","robowrite:organizations:read"]}],"summary":"Multi Org Create Brief","tags":["public-api"]}},"/api/public/v2/organizations/{organization_id}/briefs/{brief_id}":{"get":{"description":"Read an owned brief and its current linked-content graph.","operationId":"multi_org_get_brief_api_public_v1_briefs__brief_id__get","parameters":[{"in":"path","name":"brief_id","required":true,"schema":{"format":"uuid","title":"Brief Id","type":"string"}},{"in":"path","name":"organization_id","required":true,"schema":{"pattern":"^org_[A-Za-z0-9_]+$","title":"Organization Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicBrief"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Brief not found"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"RoboWriteMultiOrgOAuth":["robowrite:content:all_orgs","robowrite:organizations:read"]}],"summary":"Multi Org Get Brief","tags":["public-api"]},"patch":{"description":"Partially update a brief's content.\n\nOnly supplied fields change. ``status`` and ``brand_id`` are server-managed\nand not editable here. Missing or foreign brief/pillar ids return **404**.\nEditing any generation-relevant field (everything except ``pillar_id``) on\nan ``approved`` or ``ready`` brief moves its status back to ``draft`` so\nthe next generation re-enters review; re-approve with ``POST\n/briefs/{brief_id}/approve``. Supplying ``facts`` needs the v2 article\npipeline (**409** ``article_pipeline_not_v2`` otherwise) and meets the\nsame workspace and brand-policy rules as on create (**422**); ``[]`` or\n``null`` removes every fact. ``article_spec`` replaces the whole spec\n(``null`` resets it to the standard article); a required source must stay\nin ``source_urls``, including after a ``source_urls``-only edit\n(**422** ``article_spec_required_source_not_in_brief``).","operationId":"multi_org_update_brief_api_public_v1_briefs__brief_id__patch","parameters":[{"in":"path","name":"brief_id","required":true,"schema":{"format":"uuid","title":"Brief Id","type":"string"}},{"in":"path","name":"organization_id","required":true,"schema":{"pattern":"^org_[A-Za-z0-9_]+$","title":"Organization Id","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicBriefUpdate"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicBrief"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Brief or referenced pillar not found"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"RoboWriteMultiOrgOAuth":["robowrite:content:all_orgs","robowrite:organizations:read"]}],"summary":"Multi Org Update Brief","tags":["public-api"]}},"/api/public/v2/organizations/{organization_id}/briefs/{brief_id}/approve":{"post":{"description":"Approve a brief, most commonly to re-approve one a content edit moved back to draft. Legal only from draft or in_review; a brief that is already approved returns 422 rather than a no-op. Do not send an Idempotency-Key.","operationId":"multi_org_approve_brief_api_public_v1_briefs__brief_id__approve_post","parameters":[{"in":"path","name":"brief_id","required":true,"schema":{"format":"uuid","title":"Brief Id","type":"string"}},{"in":"path","name":"organization_id","required":true,"schema":{"pattern":"^org_[A-Za-z0-9_]+$","title":"Organization Id","type":"string"}},{"in":"header","name":"Idempotency-Key","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicBrief"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Brief not found"},"422":{"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/PublicErrorBody"},{"$ref":"#/components/schemas/HTTPValidationError"}]}}},"description":"Schema validation failed (field-error detail array), an Idempotency-Key was sent to a route that does not accept one, or the brief's current status does not permit approval (string detail)."}},"security":[{"RoboWriteMultiOrgOAuth":["robowrite:content:all_orgs","robowrite:organizations:read"]}],"summary":"Multi Org Approve Brief","tags":["public-api"]}},"/api/public/v2/organizations/{organization_id}/categories":{"get":{"description":"List a brand's categories in pages of up to 200.","operationId":"multi_org_list_categories_api_public_v1_categories_get","parameters":[{"in":"path","name":"organization_id","required":true,"schema":{"pattern":"^org_[A-Za-z0-9_]+$","title":"Organization Id","type":"string"}},{"description":"Brand whose categories to list","in":"query","name":"brand_id","required":true,"schema":{"description":"Brand whose categories to list","format":"uuid","title":"Brand Id","type":"string"}},{"description":"Results per page","in":"query","name":"limit","required":false,"schema":{"default":50,"description":"Results per page","maximum":200,"minimum":1,"title":"Limit","type":"integer"}},{"description":"Pagination offset","in":"query","name":"offset","required":false,"schema":{"default":0,"description":"Pagination offset","minimum":0,"title":"Offset","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicPage_PublicCategory_"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"RoboWriteMultiOrgOAuth":["robowrite:content:all_orgs","robowrite:organizations:read"]}],"summary":"Multi Org List Categories","tags":["public-api"]},"post":{"description":"Create a category for a brand you own.\n\nThe ``Idempotency-Key`` header is **optional**: with one, a retry of the\nsame body replays the original category (``Idempotency-Replayed: true``);\nthe same key with a different body returns **409**.","operationId":"multi_org_create_category_api_public_v1_categories_post","parameters":[{"in":"path","name":"organization_id","required":true,"schema":{"pattern":"^org_[A-Za-z0-9_]+$","title":"Organization Id","type":"string"}},{"in":"header","name":"Idempotency-Key","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicCategoryCreate"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicCategory"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Brand not found (absent or not owned by the org)"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Slug already exists for this brand, or the Idempotency-Key was reused with a different payload"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"RoboWriteMultiOrgOAuth":["robowrite:content:all_orgs","robowrite:organizations:read"]}],"summary":"Multi Org Create Category","tags":["public-api"]}},"/api/public/v2/organizations/{organization_id}/categories/{category_id}":{"delete":{"description":"Delete a category. Returns 204 with no body; 404 when it does not exist or belongs to another organization.","operationId":"multi_org_delete_category_api_public_v1_categories__category_id__delete","parameters":[{"in":"path","name":"category_id","required":true,"schema":{"format":"uuid","title":"Category Id","type":"string"}},{"in":"path","name":"organization_id","required":true,"schema":{"pattern":"^org_[A-Za-z0-9_]+$","title":"Organization Id","type":"string"}}],"responses":{"204":{"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Category not found (absent or not owned by the org)"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"RoboWriteMultiOrgOAuth":["robowrite:content:all_orgs","robowrite:organizations:read"]}],"summary":"Multi Org Delete Category","tags":["public-api"]},"get":{"description":"Read one category, including its parent, display settings, and usage count.","operationId":"multi_org_get_category_api_public_v1_categories__category_id__get","parameters":[{"in":"path","name":"category_id","required":true,"schema":{"format":"uuid","title":"Category Id","type":"string"}},{"in":"path","name":"organization_id","required":true,"schema":{"pattern":"^org_[A-Za-z0-9_]+$","title":"Organization Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicCategory"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Category not found (absent or not owned by the org)"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"RoboWriteMultiOrgOAuth":["robowrite:content:all_orgs","robowrite:organizations:read"]}],"summary":"Multi Org Get Category","tags":["public-api"]},"patch":{"description":"Partially update a category: omitted fields stay unchanged. Returns 409 when the new slug is already used by the brand.","operationId":"multi_org_update_category_api_public_v1_categories__category_id__patch","parameters":[{"in":"path","name":"category_id","required":true,"schema":{"format":"uuid","title":"Category Id","type":"string"}},{"in":"path","name":"organization_id","required":true,"schema":{"pattern":"^org_[A-Za-z0-9_]+$","title":"Organization Id","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicCategoryUpdate"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicCategory"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Category not found (absent or not owned by the org)"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Slug already exists for this brand"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"RoboWriteMultiOrgOAuth":["robowrite:content:all_orgs","robowrite:organizations:read"]}],"summary":"Multi Org Update Category","tags":["public-api"]}},"/api/public/v2/organizations/{organization_id}/content":{"get":{"description":"Search content using AND filters and exact filtered pagination.\n\nq is a case-insensitive literal title/slug substring; keyword is a whole\nphrase in brief targets or the latest saved revision's SEO keywords.\nDates select created_at in [created_from, created_before), normalized to UTC.\nA ``latest_attempt`` whose run ended holding the item's kit for review reads ``awaiting_review``. A run still waiting in place reads ``running`` here; poll ``GET /jobs/{job_id}`` for its review state.","operationId":"multi_org_list_content_api_public_v1_content_get","parameters":[{"in":"path","name":"organization_id","required":true,"schema":{"pattern":"^org_[A-Za-z0-9_]+$","title":"Organization Id","type":"string"}},{"in":"query","name":"brand_id","required":false,"schema":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Brand Id"}},{"in":"query","name":"property_id","required":false,"schema":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Property Id"}},{"in":"query","name":"status","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/TaskStatus"},{"type":"null"}],"title":"Status"}},{"in":"query","name":"format","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/ContentFormat"},{"type":"null"}],"title":"Format"}},{"in":"query","name":"pillar_id","required":false,"schema":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Pillar Id"}},{"in":"query","name":"created_from","required":false,"schema":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Created From"}},{"in":"query","name":"created_before","required":false,"schema":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Created Before"}},{"in":"query","name":"q","required":false,"schema":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"title":"Q"}},{"in":"query","name":"keyword","required":false,"schema":{"anyOf":[{"maxLength":255,"type":"string"},{"type":"null"}],"title":"Keyword"}},{"in":"query","name":"limit","required":false,"schema":{"default":50,"maximum":200,"minimum":1,"title":"Limit","type":"integer"}},{"in":"query","name":"offset","required":false,"schema":{"default":0,"minimum":0,"title":"Offset","type":"integer"}},{"in":"query","name":"content_type","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/ContentFormat"},{"type":"null"}],"title":"Content Type"}},{"in":"query","name":"brief_id","required":false,"schema":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Brief Id"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicPage_PublicContentSummary_"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"RoboWriteMultiOrgOAuth":["robowrite:content:all_orgs","robowrite:organizations:read"]}],"summary":"Multi Org List Content","tags":["public-api"]}},"/api/public/v2/organizations/{organization_id}/content/items":{"post":{"description":"Bind a brief to a publishing property and create a content item.\n\nResolves the item brand from the chosen property (which must belong to\nyour organization). The brief and property must share the same brand\n(**422** on mismatch). A missing or foreign brief/property returns **404**.\n\nAn ``Idempotency-Key`` is **required**. A retry with the same key and body\nreplays the original item (``Idempotency-Replayed: true``) instead of\ncreating a second row. Different body on the same key returns **409**.\nCreating items is not content-generation-quota gated; generation is gated\nseparately when you start a generate job. A per-org daily create cap may\nreturn **429** when exceeded (replays do not count toward the cap).","operationId":"multi_org_create_content_item_api_public_v1_content_items_post","parameters":[{"in":"path","name":"organization_id","required":true,"schema":{"pattern":"^org_[A-Za-z0-9_]+$","title":"Organization Id","type":"string"}},{"description":"Required. Dedupes this billed create; a retry with the same key replays the original item instead of creating (and billing) a second.","in":"header","name":"Idempotency-Key","required":true,"schema":{"description":"Required. Dedupes this billed create; a retry with the same key replays the original item instead of creating (and billing) a second.","title":"Idempotency-Key","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicContentItemCreate"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicContentItemDetail"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Property not found / not owned, or brief not found"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Idempotency-Key reused with a different payload, a concurrent create with the same key is in progress, or a live content item already exists for this brief"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Per-org daily content-item create limit exceeded","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"},"Retry-After":{"$ref":"#/components/headers/Retry-After"}}}},"security":[{"RoboWriteMultiOrgOAuth":["robowrite:content:all_orgs","robowrite:organizations:read"]}],"summary":"Multi Org Create Content Item","tags":["public-api"]}},"/api/public/v2/organizations/{organization_id}/content/items/{content_item_id}/versions/{version_id}/relevant-links":{"get":{"description":"Read the website links approved for one saved generation version, including the index locale frozen on that version at generation time. Returns an empty list when the version has no website-index links. Returns 404 when the content item does not exist, is not owned by the caller, or the version does not belong to the item.","operationId":"multi_org_download_version_relevant_links_api_public_v1_content_items__content_item_id__versions__version_id__relevant_links_get","parameters":[{"in":"path","name":"content_item_id","required":true,"schema":{"format":"uuid","title":"Content Item Id","type":"string"}},{"in":"path","name":"version_id","required":true,"schema":{"format":"uuid","title":"Version Id","type":"string"}},{"in":"path","name":"organization_id","required":true,"schema":{"pattern":"^org_[A-Za-z0-9_]+$","title":"Organization Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicVersionedRelevantLinks"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Content item or version not found (or not owned by the org)"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"RoboWriteMultiOrgOAuth":["robowrite:content:all_orgs","robowrite:organizations:read"]}],"summary":"Multi Org Download Version Relevant Links","tags":["public-api"]}},"/api/public/v2/organizations/{organization_id}/content/items/{item_id}/generate":{"post":{"description":"Start generation for an existing content item.\n\nSupply an ``Idempotency-Key`` so retries replay the original job (no second\ngeneration charge). When absent, a key is generated and echoed so the\ncaller can capture-and-resend. A previously failed generation is **not**\nreplayed: the same key re-dispatches as new, quota-charged work\n(``replayed=false``, no ``Idempotency-Replayed`` header). Over-quota\nrequests return **429**.","operationId":"multi_org_generate_content_item_api_public_v1_content_items__item_id__generate_post","parameters":[{"in":"path","name":"item_id","required":true,"schema":{"format":"uuid","title":"Item Id","type":"string"}},{"in":"path","name":"organization_id","required":true,"schema":{"pattern":"^org_[A-Za-z0-9_]+$","title":"Organization Id","type":"string"}},{"in":"header","name":"Idempotency-Key","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/PublicGenerateItemRequest"},{"type":"null"}],"title":"Body"}}}},"responses":{"202":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicGenerateResponse"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Content item not found (absent or not owned by the org)"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Item not generatable: brief not in a generatable state (`brief_not_approved` / `item_not_generatable`), or another generation of the item is still running (`article_run_active`; wait for it to finish, then retry or review its kit)"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Generation backend temporarily unavailable; retry. A concurrent first call that has not finished dispatch yet is not a 503 — it returns 202 with status=queued for polling."}},"security":[{"RoboWriteMultiOrgOAuth":["robowrite:content:all_orgs","robowrite:organizations:read"]}],"summary":"Multi Org Generate Content Item","tags":["public-api"]}},"/api/public/v2/organizations/{organization_id}/content/items/{item_id}/kit":{"get":{"description":"Read a content item's kit: outline, claims, components and review state.\n\nUse ``kit_revision`` as ``expected_kit_revision`` on every kit write.","operationId":"multi_org_get_content_kit_api_public_v1_content_items__item_id__kit_get","parameters":[{"in":"path","name":"item_id","required":true,"schema":{"format":"uuid","title":"Item Id","type":"string"}},{"in":"path","name":"organization_id","required":true,"schema":{"pattern":"^org_[A-Za-z0-9_]+$","title":"Organization Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicContentKitRead"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Content item or kit not found (absent or not owned by the org)"},"409":{"description":"kit_revision_stale: the kit changed since expected_kit_revision; re-read it. article_pipeline_not_v2: content kits need the v2 article pipeline."},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"RoboWriteMultiOrgOAuth":["robowrite:content:all_orgs","robowrite:organizations:read"]}],"summary":"Multi Org Get Content Kit","tags":["public-api"]}},"/api/public/v2/organizations/{organization_id}/content/items/{item_id}/kit/approve":{"post":{"description":"Approve the kit at this revision so the article is written from it.\n\nThe approval is stored first; ``write`` says whether the write started.\nAn agent (OAuth) approval is recorded as ``decided_by=agent``.","operationId":"multi_org_approve_content_kit_api_public_v1_content_items__item_id__kit_approve_post","parameters":[{"in":"path","name":"item_id","required":true,"schema":{"format":"uuid","title":"Item Id","type":"string"}},{"in":"path","name":"organization_id","required":true,"schema":{"pattern":"^org_[A-Za-z0-9_]+$","title":"Organization Id","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicKitDecisionInput"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicKitApproval"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Content item or kit not found (absent or not owned by the org)"},"409":{"description":"kit_revision_stale: the kit changed since expected_kit_revision; re-read it. article_pipeline_not_v2: content kits need the v2 article pipeline."},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"RoboWriteMultiOrgOAuth":["robowrite:content:all_orgs","robowrite:organizations:read"]}],"summary":"Multi Org Approve Content Kit","tags":["public-api"]}},"/api/public/v2/organizations/{organization_id}/content/items/{item_id}/kit/components":{"post":{"description":"Add a component, or replace the one with this ``id``, from a typed\npayload. The payload is rebuilt against the kit's claims; raw Markdown and\nthe ``sources`` kind are refused (422). An edit moves an approved kit back\nto ``needs_review``.","operationId":"multi_org_upsert_content_kit_component_api_public_v1_content_items__item_id__kit_components_post","parameters":[{"in":"path","name":"item_id","required":true,"schema":{"format":"uuid","title":"Item Id","type":"string"}},{"in":"path","name":"organization_id","required":true,"schema":{"pattern":"^org_[A-Za-z0-9_]+$","title":"Organization Id","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicKitComponentInput"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicContentKit"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Content item or kit not found (absent or not owned by the org)"},"409":{"description":"kit_revision_stale: the kit changed since expected_kit_revision; re-read it. article_pipeline_not_v2: content kits need the v2 article pipeline."},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"RoboWriteMultiOrgOAuth":["robowrite:content:all_orgs","robowrite:organizations:read"]}],"summary":"Multi Org Upsert Content Kit Component","tags":["public-api"]}},"/api/public/v2/organizations/{organization_id}/content/items/{item_id}/kit/components/{component_id}":{"delete":{"description":"Remove a component; later kit rebuilds do not bring it back. Send the\ncurrent revision in the ``Expected-Kit-Revision`` header.","operationId":"multi_org_delete_content_kit_component_api_public_v1_content_items__item_id__kit_components__component_id__delete","parameters":[{"in":"path","name":"item_id","required":true,"schema":{"format":"uuid","title":"Item Id","type":"string"}},{"in":"path","name":"component_id","required":true,"schema":{"title":"Component Id","type":"string"}},{"in":"path","name":"organization_id","required":true,"schema":{"pattern":"^org_[A-Za-z0-9_]+$","title":"Organization Id","type":"string"}},{"in":"header","name":"Expected-Kit-Revision","required":true,"schema":{"pattern":"^[a-f0-9]{64}$","title":"Expected-Kit-Revision","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicContentKit"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Content item or kit not found (absent or not owned by the org)"},"409":{"description":"kit_revision_stale: the kit changed since expected_kit_revision; re-read it. article_pipeline_not_v2: content kits need the v2 article pipeline."},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"RoboWriteMultiOrgOAuth":["robowrite:content:all_orgs","robowrite:organizations:read"]}],"summary":"Multi Org Delete Content Kit Component","tags":["public-api"]}},"/api/public/v2/organizations/{organization_id}/content/items/{item_id}/kit/components/{component_id}/lock":{"post":{"description":"Lock a component so later kit rebuilds keep it exactly as it is.","operationId":"multi_org_lock_content_kit_component_api_public_v1_content_items__item_id__kit_components__component_id__lock_post","parameters":[{"in":"path","name":"item_id","required":true,"schema":{"format":"uuid","title":"Item Id","type":"string"}},{"in":"path","name":"component_id","required":true,"schema":{"title":"Component Id","type":"string"}},{"in":"path","name":"organization_id","required":true,"schema":{"pattern":"^org_[A-Za-z0-9_]+$","title":"Organization Id","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicKitRevisionInput"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicContentKit"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Content item or kit not found (absent or not owned by the org)"},"409":{"description":"kit_revision_stale: the kit changed since expected_kit_revision; re-read it. article_pipeline_not_v2: content kits need the v2 article pipeline."},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"RoboWriteMultiOrgOAuth":["robowrite:content:all_orgs","robowrite:organizations:read"]}],"summary":"Multi Org Lock Content Kit Component","tags":["public-api"]}},"/api/public/v2/organizations/{organization_id}/content/items/{item_id}/kit/facts":{"post":{"description":"Add one supplied fact to the kit. A ``source_url`` is fetched and\ncited only when its page states the fact (``source_url_cited``;\n``source_check`` says why not). ``section_ids`` maps it to outline\nsections, so it counts as their evidence and may be stated there. Kit\nfacts survive kit rebuilds; brief facts live on the brief.","operationId":"multi_org_add_content_kit_fact_api_public_v1_content_items__item_id__kit_facts_post","parameters":[{"in":"path","name":"item_id","required":true,"schema":{"format":"uuid","title":"Item Id","type":"string"}},{"in":"path","name":"organization_id","required":true,"schema":{"pattern":"^org_[A-Za-z0-9_]+$","title":"Organization Id","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicKitFactInput"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicKitFactAdded"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Content item or kit not found (absent or not owned by the org)"},"409":{"description":"kit_revision_stale: the kit changed since expected_kit_revision; re-read it. article_pipeline_not_v2: content kits need the v2 article pipeline."},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"RoboWriteMultiOrgOAuth":["robowrite:content:all_orgs","robowrite:organizations:read"]}],"summary":"Multi Org Add Content Kit Fact","tags":["public-api"]}},"/api/public/v2/organizations/{organization_id}/content/items/{item_id}/kit/facts/{claim_id}":{"delete":{"description":"Remove a fact added on the kit (``user:k-``). Brief facts are edited\non the brief. A fact a locked or edited component still cites is a 422.","operationId":"multi_org_delete_content_kit_fact_api_public_v1_content_items__item_id__kit_facts__claim_id__delete","parameters":[{"in":"path","name":"item_id","required":true,"schema":{"format":"uuid","title":"Item Id","type":"string"}},{"in":"path","name":"claim_id","required":true,"schema":{"title":"Claim Id","type":"string"}},{"in":"path","name":"organization_id","required":true,"schema":{"pattern":"^org_[A-Za-z0-9_]+$","title":"Organization Id","type":"string"}},{"in":"header","name":"Expected-Kit-Revision","required":true,"schema":{"pattern":"^[a-f0-9]{64}$","title":"Expected-Kit-Revision","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicContentKit"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Content item or kit not found (absent or not owned by the org)"},"409":{"description":"kit_revision_stale: the kit changed since expected_kit_revision; re-read it. article_pipeline_not_v2: content kits need the v2 article pipeline."},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"RoboWriteMultiOrgOAuth":["robowrite:content:all_orgs","robowrite:organizations:read"]}],"summary":"Multi Org Delete Content Kit Fact","tags":["public-api"]}},"/api/public/v2/organizations/{organization_id}/content/items/{item_id}/kit/reject":{"post":{"description":"Reject the kit: it stays held (``needs_review``) and nothing is\nwritten. Edit and approve it, or regenerate to rebuild it.","operationId":"multi_org_reject_content_kit_api_public_v1_content_items__item_id__kit_reject_post","parameters":[{"in":"path","name":"item_id","required":true,"schema":{"format":"uuid","title":"Item Id","type":"string"}},{"in":"path","name":"organization_id","required":true,"schema":{"pattern":"^org_[A-Za-z0-9_]+$","title":"Organization Id","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicKitDecisionInput"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicContentKit"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Content item or kit not found (absent or not owned by the org)"},"409":{"description":"kit_revision_stale: the kit changed since expected_kit_revision; re-read it. article_pipeline_not_v2: content kits need the v2 article pipeline."},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"RoboWriteMultiOrgOAuth":["robowrite:content:all_orgs","robowrite:organizations:read"]}],"summary":"Multi Org Reject Content Kit","tags":["public-api"]}},"/api/public/v2/organizations/{organization_id}/content/items/{item_id}/kit/source-exclusions":{"post":{"description":"Exclude a source domain (and its subdomains) from the kit.\n\nIts claims and the components built from them leave the kit, and the\nsources list is rebuilt. Navigation links in the brief are unaffected.\n``evidence`` shows what the kit still holds; approve to write from it.","operationId":"multi_org_exclude_content_kit_source_domain_api_public_v1_content_items__item_id__kit_source_exclusions_post","parameters":[{"in":"path","name":"item_id","required":true,"schema":{"format":"uuid","title":"Item Id","type":"string"}},{"in":"path","name":"organization_id","required":true,"schema":{"pattern":"^org_[A-Za-z0-9_]+$","title":"Organization Id","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicKitSourceExclusionInput"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicKitSourceExclusion"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Content item or kit not found (absent or not owned by the org)"},"409":{"description":"kit_revision_stale: the kit changed since expected_kit_revision; re-read it. article_pipeline_not_v2: content kits need the v2 article pipeline."},"422":{"description":"source_domain_invalid, source_domain_not_in_kit, source_has_locked_components (details.component_ids) or source_domain_cited_by_facts (details.claim_ids)."}},"security":[{"RoboWriteMultiOrgOAuth":["robowrite:content:all_orgs","robowrite:organizations:read"]}],"summary":"Multi Org Exclude Content Kit Source Domain","tags":["public-api"]}},"/api/public/v2/organizations/{organization_id}/content/items/{item_id}/restore-archive":{"post":{"description":"Return an archived failed draft to inventory. Repeating a restore is safe.","operationId":"multi_org_restore_archived_failed_draft_api_public_v1_content_items__item_id__restore_archive_post","parameters":[{"in":"path","name":"item_id","required":true,"schema":{"format":"uuid","title":"Item Id","type":"string"}},{"in":"path","name":"organization_id","required":true,"schema":{"pattern":"^org_[A-Za-z0-9_]+$","title":"Organization Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDraftInventoryRestore"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"RoboWriteMultiOrgOAuth":["robowrite:content:all_orgs","robowrite:organizations:read"]}],"summary":"Multi Org Restore Archived Failed Draft","tags":["public-api"]}},"/api/public/v2/organizations/{organization_id}/content/{content_item_id}":{"get":{"description":"Download a content item and a page of its versions.\n\n``versions`` is a ``PublicPage`` envelope: default window is the newest 50\n(standard public ``limit`` 1–200). Pass ``latest_only=true`` or\n``version=N`` to pin without paging.\n\nOptional projections are opt-in via ``?include=`` (``scoring``,\n``sources``, ``compliance``; combine with commas). When not requested,\nthose fields stay null. Scoring is per-version: each version surfaces\nits own quality signals when ``include=scoring`` is set.","operationId":"multi_org_download_content_api_public_v1_content__content_item_id__get","parameters":[{"in":"path","name":"content_item_id","required":true,"schema":{"format":"uuid","title":"Content Item Id","type":"string"}},{"in":"path","name":"organization_id","required":true,"schema":{"pattern":"^org_[A-Za-z0-9_]+$","title":"Organization Id","type":"string"}},{"description":"Comma-separated optional projections. Pass 'scoring' to include per-version quality signals (geo/draft scores, warnings); pass 'sources' to include the research sources cited in each version (marker, source_name, source_url, origin); pass 'assertion_provenance' to include the per-assertion provenance receipt (sentence, sentence_index, url, marker, origin); pass 'compliance' to include each version's regulated-content policy findings (kind, message, excerpt); pass 'supplied_facts' to include the facts you supplied with no source URL (claim_id, text, attribution). Any may be combined.","in":"query","name":"include","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated optional projections. Pass 'scoring' to include per-version quality signals (geo/draft scores, warnings); pass 'sources' to include the research sources cited in each version (marker, source_name, source_url, origin); pass 'assertion_provenance' to include the per-assertion provenance receipt (sentence, sentence_index, url, marker, origin); pass 'compliance' to include each version's regulated-content policy findings (kind, message, excerpt); pass 'supplied_facts' to include the facts you supplied with no source URL (claim_id, text, attribution). Any may be combined.","title":"Include"}},{"description":"Return only the current version instead of paging the revision history. Use this for page-by-page download.","in":"query","name":"latest_only","required":false,"schema":{"default":false,"description":"Return only the current version instead of paging the revision history. Use this for page-by-page download.","title":"Latest Only","type":"boolean"}},{"description":"Return only this version number. Mutually exclusive with `latest_only`; an unknown version number is a 404.","in":"query","name":"version","required":false,"schema":{"anyOf":[{"minimum":1,"type":"integer"},{"type":"null"}],"description":"Return only this version number. Mutually exclusive with `latest_only`; an unknown version number is a 404.","title":"Version"}},{"description":"Versions page size. Ignored when latest_only or version is set. Newest version first. Standard public pagination bounds (1–200, default 50).","in":"query","name":"limit","required":false,"schema":{"default":50,"description":"Versions page size. Ignored when latest_only or version is set. Newest version first. Standard public pagination bounds (1–200, default 50).","maximum":200,"minimum":1,"title":"Limit","type":"integer"}},{"description":"Versions page offset. Ignored when latest_only or version is set.","in":"query","name":"offset","required":false,"schema":{"default":0,"description":"Versions page offset. Ignored when latest_only or version is set.","minimum":0,"title":"Offset","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicContentItem"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Content item not found (absent or not owned by the org)"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"RoboWriteMultiOrgOAuth":["robowrite:content:all_orgs","robowrite:organizations:read"]}],"summary":"Multi Org Download Content","tags":["public-api"]}},"/api/public/v2/organizations/{organization_id}/content/{content_item_id}/checks":{"post":{"description":"Start an explicit quality check of the current saved version. This does not edit Markdown. Do not send Idempotency-Key.","operationId":"multi_org_check_draft_api_public_v1_content__content_item_id__checks_post","parameters":[{"in":"path","name":"content_item_id","required":true,"schema":{"format":"uuid","title":"Content Item Id","type":"string"}},{"in":"path","name":"organization_id","required":true,"schema":{"pattern":"^org_[A-Za-z0-9_]+$","title":"Organization Id","type":"string"}},{"in":"header","name":"Idempotency-Key","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EditorialCheckRequest"}}},"required":true},"responses":{"202":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EditorialJobAccepted"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"RoboWriteMultiOrgOAuth":["robowrite:content:all_orgs","robowrite:organizations:read"]}],"summary":"Multi Org Check Draft","tags":["public-api"]}},"/api/public/v2/organizations/{organization_id}/content/{content_item_id}/diff":{"get":{"description":"Compare Markdown of two immutable versions of the same item.","operationId":"multi_org_diff_draft_api_public_v1_content__content_item_id__diff_get","parameters":[{"in":"path","name":"content_item_id","required":true,"schema":{"format":"uuid","title":"Content Item Id","type":"string"}},{"in":"path","name":"organization_id","required":true,"schema":{"pattern":"^org_[A-Za-z0-9_]+$","title":"Organization Id","type":"string"}},{"in":"query","name":"from_version_id","required":true,"schema":{"format":"uuid","title":"From Version Id","type":"string"}},{"in":"query","name":"to_version_id","required":true,"schema":{"format":"uuid","title":"To Version Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EditorialDiffResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"RoboWriteMultiOrgOAuth":["robowrite:content:all_orgs","robowrite:organizations:read"]}],"summary":"Multi Org Diff Draft","tags":["public-api"]}},"/api/public/v2/organizations/{organization_id}/content/{content_item_id}/edits":{"post":{"description":"Save a new immutable Markdown version of the current draft. Send the exact expected_base_version_id. Whole-body replacement uses markdown_body; exact patches use a unique target substring. Reuse request_id after a lost response. Do not send Idempotency-Key.","operationId":"multi_org_edit_draft_api_public_v1_content__content_item_id__edits_post","parameters":[{"in":"path","name":"content_item_id","required":true,"schema":{"format":"uuid","title":"Content Item Id","type":"string"}},{"in":"path","name":"organization_id","required":true,"schema":{"pattern":"^org_[A-Za-z0-9_]+$","title":"Organization Id","type":"string"}},{"in":"header","name":"Idempotency-Key","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EditorialEditRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EditorialVersionReceipt"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"RoboWriteMultiOrgOAuth":["robowrite:content:all_orgs","robowrite:organizations:read"]}],"summary":"Multi Org Edit Draft","tags":["public-api"]}},"/api/public/v2/organizations/{organization_id}/content/{content_item_id}/restores":{"post":{"description":"Copy an earlier immutable version into a new current revision with restoration lineage. Supply the current expected_base_version_id. Do not send Idempotency-Key.","operationId":"multi_org_restore_draft_api_public_v1_content__content_item_id__restores_post","parameters":[{"in":"path","name":"content_item_id","required":true,"schema":{"format":"uuid","title":"Content Item Id","type":"string"}},{"in":"path","name":"organization_id","required":true,"schema":{"pattern":"^org_[A-Za-z0-9_]+$","title":"Organization Id","type":"string"}},{"in":"header","name":"Idempotency-Key","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EditorialRestoreRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EditorialVersionReceipt"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"RoboWriteMultiOrgOAuth":["robowrite:content:all_orgs","robowrite:organizations:read"]}],"summary":"Multi Org Restore Draft","tags":["public-api"]}},"/api/public/v2/organizations/{organization_id}/content/{content_item_id}/review-card":{"get":{"description":"Read persisted editorial checks for the current saved version. This does not start a check or a provider call. Do not send Idempotency-Key.","operationId":"multi_org_get_review_card_api_public_v1_content__content_item_id__review_card_get","parameters":[{"in":"path","name":"content_item_id","required":true,"schema":{"format":"uuid","title":"Content Item Id","type":"string"}},{"in":"path","name":"organization_id","required":true,"schema":{"pattern":"^org_[A-Za-z0-9_]+$","title":"Organization Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EditorialReviewCard"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"RoboWriteMultiOrgOAuth":["robowrite:content:all_orgs","robowrite:organizations:read"]}],"summary":"Multi Org Get Review Card","tags":["public-api"]}},"/api/public/v2/organizations/{organization_id}/content/{content_item_id}/rewrites":{"post":{"description":"Start an in-item AI rewrite of the current version. Section rewrites keep outside-section bytes identical unless allow_broader_repair is true. Failed verification saves no version. Requires Idempotency-Key. The first AI rewrite of a handwritten-only item uses the content allowance. AI rewrites of items that already have a generated version use the revisions allowance. While another generation of the item is pending or running this returns 409 article_run_active before any charge.","operationId":"multi_org_rewrite_draft_api_public_v1_content__content_item_id__rewrites_post","parameters":[{"in":"path","name":"content_item_id","required":true,"schema":{"format":"uuid","title":"Content Item Id","type":"string"}},{"in":"path","name":"organization_id","required":true,"schema":{"pattern":"^org_[A-Za-z0-9_]+$","title":"Organization Id","type":"string"}},{"in":"header","name":"Idempotency-Key","required":true,"schema":{"title":"Idempotency-Key","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EditorialRewriteRequest"}}},"required":true},"responses":{"202":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EditorialJobAccepted"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"RoboWriteMultiOrgOAuth":["robowrite:content:all_orgs","robowrite:organizations:read"]}],"summary":"Multi Org Rewrite Draft","tags":["public-api"]}},"/api/public/v2/organizations/{organization_id}/content/{content_item_id}/sections":{"get":{"description":"Parser-derived H2 section ids for a saved version. Duplicate headings are disambiguated; headings inside code fences are ignored.","operationId":"multi_org_list_draft_sections_api_public_v1_content__content_item_id__sections_get","parameters":[{"in":"path","name":"content_item_id","required":true,"schema":{"format":"uuid","title":"Content Item Id","type":"string"}},{"in":"path","name":"organization_id","required":true,"schema":{"pattern":"^org_[A-Za-z0-9_]+$","title":"Organization Id","type":"string"}},{"in":"query","name":"content_version_id","required":true,"schema":{"format":"uuid","title":"Content Version Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/EditorialHeadingSection"},"title":"Response Multi Org List Draft Sections Api Public V1 Content  Content Item Id  Sections Get","type":"array"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"RoboWriteMultiOrgOAuth":["robowrite:content:all_orgs","robowrite:organizations:read"]}],"summary":"Multi Org List Draft Sections","tags":["public-api"]}},"/api/public/v2/organizations/{organization_id}/content/{item_id}/publish":{"post":{"description":"Publish or schedule a content item to this org's connected CMS. Completes the public loop: generate -> review -> **publish**. Prerequisites: the item's property must have ``publish_policy=cms_publish`` (a ``draft_only`` property returns **409** — collect the page with ``GET /content/{content_item_id}`` instead), and the item must be live (not soft-deleted) and have a resolvable CMS destination — either an existing single publish target on the item, or a human-selected org default destination used to provision one. Zero targets with no valid default, or more than one target, both return 409. This surface never invents a collection UID and never picks among ambiguous targets. Exactly-once: a retry of an already-enqueued publish returns **202 with the original job_id** and ``was_duplicate_lookup=true``. It does not enqueue a second publish and is deliberately not a 409. Clients may retry freely. Provenance is set server-side and is never read from the request body. Modes are ``draft`` / ``live`` / ``schedule`` / ``unpublish``. ``unpublish`` tears the remote document down again and is the one mode that skips both readiness gates: it is allowed on a ``draft_only`` property (a page can be live on the destination CMS without this API having published it, and that is exactly the case worth reversing), and it never provisions a default destination — an item with no publish target returns **409** because there is nothing linked to tear down. Because that exactly-once dedupe is derived from the item/version/mode rather than from a client key, this route does **not** accept an ``Idempotency-Key`` — sending one returns **422** rather than being silently discarded.","operationId":"multi_org_publish_content_item_api_public_v1_content__item_id__publish_post","parameters":[{"in":"path","name":"item_id","required":true,"schema":{"format":"uuid","title":"Item Id","type":"string"}},{"in":"path","name":"organization_id","required":true,"schema":{"pattern":"^org_[A-Za-z0-9_]+$","title":"Organization Id","type":"string"}},{"in":"header","name":"Idempotency-Key","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicPublishRequest"}}},"required":true},"responses":{"202":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicPublishAccepted"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Content item not found, not owned by this org, or soft-deleted"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"The item's property has publish_policy=draft_only, so there is nothing to publish to (not raised for mode=unpublish); or no CMS publish destination is available for this item (no target and no human-selected org default); or more than one target makes the destination ambiguous; or mode=unpublish was sent for an item with no publish target, leaving nothing to tear down"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Publish dispatch temporarily unavailable"}},"security":[{"RoboWriteMultiOrgOAuth":["robowrite:content:all_orgs","robowrite:organizations:read","robowrite:publish:all_orgs"]}],"summary":"Multi Org Publish Content Item","tags":["public-api"]}},"/api/public/v2/organizations/{organization_id}/documents":{"get":{"description":"List the org's library documents, optionally filtered and paginated.\n\n``category``, ``status``, and ``q`` combine with AND; ``total`` and\n``has_more`` reflect the composed filter.","operationId":"multi_org_list_documents_api_public_v1_documents_get","parameters":[{"in":"path","name":"organization_id","required":true,"schema":{"pattern":"^org_[A-Za-z0-9_]+$","title":"Organization Id","type":"string"}},{"description":"Optional document-category filter","in":"query","name":"category","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/DocumentCategory"},{"type":"null"}],"description":"Optional document-category filter","title":"Category"}},{"description":"Optional processing-status filter","in":"query","name":"status","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/DocumentStatus"},{"type":"null"}],"description":"Optional processing-status filter","title":"Status"}},{"description":"Optional case-insensitive filename substring filter","in":"query","name":"q","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional case-insensitive filename substring filter","title":"Q"}},{"description":"Results per page","in":"query","name":"limit","required":false,"schema":{"default":50,"description":"Results per page","maximum":200,"minimum":1,"title":"Limit","type":"integer"}},{"description":"Pagination offset","in":"query","name":"offset","required":false,"schema":{"default":0,"description":"Pagination offset","minimum":0,"title":"Offset","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicPage_PublicDocument_"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"RoboWriteMultiOrgOAuth":["robowrite:content:all_orgs","robowrite:organizations:read"]}],"summary":"Multi Org List Documents","tags":["public-api"]}},"/api/public/v2/organizations/{organization_id}/documents/{document_id}":{"get":{"description":"Retrieve a single document owned by your organization.\n\nDoes not include extracted text. Missing or foreign document ids return\n**404**.","operationId":"multi_org_get_document_api_public_v1_documents__document_id__get","parameters":[{"in":"path","name":"document_id","required":true,"schema":{"format":"uuid","title":"Document Id","type":"string"}},{"in":"path","name":"organization_id","required":true,"schema":{"pattern":"^org_[A-Za-z0-9_]+$","title":"Organization Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDocument"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Document not found (absent or not owned by the org)"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"RoboWriteMultiOrgOAuth":["robowrite:content:all_orgs","robowrite:organizations:read"]}],"summary":"Multi Org Get Document","tags":["public-api"]}},"/api/public/v2/organizations/{organization_id}/jobs":{"get":{"description":"List your organization's jobs to resume progress after a disconnected session. Filters combine with AND. Dates require a UTC offset; created_from is inclusive and created_before exclusive. Results use descending creation time and job ID, with a full filtered total. A run that ended holding its content kit for review reads awaiting_review, as on GET /jobs/{job_id}; the status filter, total and paging use its stored status (completed). A run still waiting in place reads running here; poll GET /jobs/{job_id} for its review state.","operationId":"multi_org_list_jobs_api_public_v1_jobs_get","parameters":[{"in":"path","name":"organization_id","required":true,"schema":{"pattern":"^org_[A-Za-z0-9_]+$","title":"Organization Id","type":"string"}},{"description":"Exact stored job-type name, including retired types. Must not be blank.","in":"query","name":"job_type","required":false,"schema":{"anyOf":[{"minLength":1,"pattern":"\\S","type":"string"},{"type":"null"}],"description":"Exact stored job-type name, including retired types. Must not be blank.","title":"Job Type"}},{"in":"query","name":"status","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/JobStatus"},{"type":"null"}],"title":"Status"}},{"in":"query","name":"created_from","required":false,"schema":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Created From"}},{"in":"query","name":"created_before","required":false,"schema":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Created Before"}},{"in":"query","name":"brand_id","required":false,"schema":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Brand Id"}},{"in":"query","name":"property_id","required":false,"schema":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Property Id"}},{"in":"query","name":"brief_id","required":false,"schema":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Brief Id"}},{"in":"query","name":"content_item_id","required":false,"schema":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Content Item Id"}},{"in":"query","name":"limit","required":false,"schema":{"default":50,"maximum":200,"minimum":1,"title":"Limit","type":"integer"}},{"in":"query","name":"offset","required":false,"schema":{"default":0,"minimum":0,"title":"Offset","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicPage_PublicJobSummary_"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"RoboWriteMultiOrgOAuth":["robowrite:content:all_orgs","robowrite:organizations:read"]}],"summary":"Multi Org List Jobs","tags":["public-api"]}},"/api/public/v2/organizations/{organization_id}/jobs/{job_id}":{"get":{"description":"Poll a generation job. ``content_item_id`` populates once the run produces it.\n\nFor an article run, ``kit_status`` / ``kit_revision`` describe the item's\ncontent kit and ``review_reasons`` why it needs a person. A run that held\nits kit for review reads ``awaiting_review`` while the kit is still held\nand the run is the one an approval would write (not after a newer run\nreplaced it or its write finished).","operationId":"multi_org_get_job_status_api_public_v1_jobs__job_id__get","parameters":[{"in":"path","name":"job_id","required":true,"schema":{"format":"uuid","title":"Job Id","type":"string"}},{"in":"path","name":"organization_id","required":true,"schema":{"pattern":"^org_[A-Za-z0-9_]+$","title":"Organization Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicJobStatus"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Job not found (absent or not owned by the org)"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"RoboWriteMultiOrgOAuth":["robowrite:content:all_orgs","robowrite:organizations:read"]}],"summary":"Multi Org Get Job Status","tags":["public-api"]}},"/api/public/v2/organizations/{organization_id}/pillar-strategies":{"post":{"description":"Generate a clusters-first pillar strategy for a brand.\n\nDeduplication here is derived from the REQUEST, not from a client key: a\ncompleted snapshot for the same (org, brand, seeds, ``num_pillars``)\nsignature is returned as a free **200**, an in-flight run for the same\nsignature as a free **202**, and ``force_refresh: true`` is the deliberate\nbypass that starts a fresh charged run. A client key has nothing to add and\nwould defeat ``force_refresh``, so this route does **not** accept an\n``Idempotency-Key`` — sending one returns **422** rather than being\nsilently discarded.","operationId":"multi_org_create_pillar_strategy_api_public_v1_pillar_strategies_post","parameters":[{"in":"path","name":"organization_id","required":true,"schema":{"pattern":"^org_[A-Za-z0-9_]+$","title":"Organization Id","type":"string"}},{"in":"header","name":"Idempotency-Key","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicPillarStrategyRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Brand not found (absent or not owned by the org)"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"RoboWriteMultiOrgOAuth":["robowrite:content:all_orgs","robowrite:organizations:read"]}],"summary":"Multi Org Create Pillar Strategy","tags":["public-api"]}},"/api/public/v2/organizations/{organization_id}/pillar-strategies/{run_id}":{"get":{"description":"Poll a pillar strategy run started by POST /pillar-strategies. Returns the completed strategy, a failed or cancelled status with an error detail, or a generating status while the run is in progress.","operationId":"multi_org_get_pillar_strategy_api_public_v1_pillar_strategies__run_id__get","parameters":[{"in":"path","name":"run_id","required":true,"schema":{"format":"uuid","title":"Run Id","type":"string"}},{"in":"path","name":"organization_id","required":true,"schema":{"pattern":"^org_[A-Za-z0-9_]+$","title":"Organization Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Pillar strategy run not found (absent or not owned by the org)"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"RoboWriteMultiOrgOAuth":["robowrite:content:all_orgs","robowrite:organizations:read"]}],"summary":"Multi Org Get Pillar Strategy","tags":["public-api"]}},"/api/public/v2/organizations/{organization_id}/pillars":{"get":{"description":"List content pillars for the organization, with filter and pagination.","operationId":"multi_org_list_pillars_api_public_v1_pillars_get","parameters":[{"in":"path","name":"organization_id","required":true,"schema":{"pattern":"^org_[A-Za-z0-9_]+$","title":"Organization Id","type":"string"}},{"description":"Filter by brand","in":"query","name":"brand_id","required":false,"schema":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"description":"Filter by brand","title":"Brand Id"}},{"in":"query","name":"active_only","required":false,"schema":{"default":true,"title":"Active Only","type":"boolean"}},{"in":"query","name":"status","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/ContentStatus"},{"type":"null"}],"title":"Status"}},{"description":"Results per page","in":"query","name":"limit","required":false,"schema":{"default":50,"description":"Results per page","maximum":200,"minimum":1,"title":"Limit","type":"integer"}},{"description":"Pagination offset","in":"query","name":"offset","required":false,"schema":{"default":0,"description":"Pagination offset","minimum":0,"title":"Offset","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicPage_PublicPillar_"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"RoboWriteMultiOrgOAuth":["robowrite:content:all_orgs","robowrite:organizations:read"]}],"summary":"Multi Org List Pillars","tags":["public-api"]},"post":{"description":"Create a content pillar for a brand you own.\n\nThe ``Idempotency-Key`` header is **optional**: with one, a retry of the\nsame body replays the original pillar (``Idempotency-Replayed: true``); the\nsame key with a different body returns **409**.","operationId":"multi_org_create_pillar_api_public_v1_pillars_post","parameters":[{"in":"path","name":"organization_id","required":true,"schema":{"pattern":"^org_[A-Za-z0-9_]+$","title":"Organization Id","type":"string"}},{"in":"header","name":"Idempotency-Key","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicPillarCreate"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicPillar"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Brand not found (absent or not owned by the org)"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Idempotency-Key reused with a different payload"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"RoboWriteMultiOrgOAuth":["robowrite:content:all_orgs","robowrite:organizations:read"]}],"summary":"Multi Org Create Pillar","tags":["public-api"]}},"/api/public/v2/organizations/{organization_id}/pillars/{pillar_id}":{"get":{"description":"Read one content pillar, including its keywords, goals, and linked audiences.","operationId":"multi_org_get_pillar_api_public_v1_pillars__pillar_id__get","parameters":[{"in":"path","name":"pillar_id","required":true,"schema":{"format":"uuid","title":"Pillar Id","type":"string"}},{"in":"path","name":"organization_id","required":true,"schema":{"pattern":"^org_[A-Za-z0-9_]+$","title":"Organization Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicPillar"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Pillar not found (absent or not owned by the org)"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"RoboWriteMultiOrgOAuth":["robowrite:content:all_orgs","robowrite:organizations:read"]}],"summary":"Multi Org Get Pillar","tags":["public-api"]},"patch":{"description":"Partially update a content pillar: omitted fields stay unchanged. Returns the updated pillar.","operationId":"multi_org_update_pillar_api_public_v1_pillars__pillar_id__patch","parameters":[{"in":"path","name":"pillar_id","required":true,"schema":{"format":"uuid","title":"Pillar Id","type":"string"}},{"in":"path","name":"organization_id","required":true,"schema":{"pattern":"^org_[A-Za-z0-9_]+$","title":"Organization Id","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicPillarUpdate"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicPillar"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Pillar not found (absent or not owned by the org)"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"RoboWriteMultiOrgOAuth":["robowrite:content:all_orgs","robowrite:organizations:read"]}],"summary":"Multi Org Update Pillar","tags":["public-api"]}},"/api/public/v2/organizations/{organization_id}/properties":{"get":{"description":"List the org's publishing properties, optionally filtered and paginated.\n\n``channel_type`` and ``verified_only`` combine with AND; ``total`` and\n``has_more`` reflect the composed filter.","operationId":"multi_org_list_properties_api_public_v1_properties_get","parameters":[{"in":"path","name":"organization_id","required":true,"schema":{"pattern":"^org_[A-Za-z0-9_]+$","title":"Organization Id","type":"string"}},{"description":"Optional channel-type filter","in":"query","name":"channel_type","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/ChannelType"},{"type":"null"}],"description":"Optional channel-type filter","title":"Channel Type"}},{"description":"Only return verified properties","in":"query","name":"verified_only","required":false,"schema":{"default":false,"description":"Only return verified properties","title":"Verified Only","type":"boolean"}},{"description":"Results per page","in":"query","name":"limit","required":false,"schema":{"default":50,"description":"Results per page","maximum":200,"minimum":1,"title":"Limit","type":"integer"}},{"description":"Pagination offset","in":"query","name":"offset","required":false,"schema":{"default":0,"description":"Pagination offset","minimum":0,"title":"Offset","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicPage_PublicProperty_"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"RoboWriteMultiOrgOAuth":["robowrite:content:all_orgs","robowrite:organizations:read"]}],"summary":"Multi Org List Properties","tags":["public-api"]},"post":{"description":"Create a publishing property from the caller's own input.\n\nDuplicate URL → **409**. ``brand_id`` is required, including for\nsingle-brand organizations. Missing or null brand input returns **422**;\nan unknown or foreign brand returns **404**.\n\nSet ``publish_policy`` to ``draft_only`` for a headless integration: pages\ngenerated for the property then finish on their own and are collected with\n``GET /content/{content_item_id}``. The default, ``cms_publish``, requires a\nconnected CMS — without one, generation runs stop and wait for a person in\nthe RoboWrite dashboard.\n\nThe ``Idempotency-Key`` header is **optional**: with one, a retry of the\nsame body replays the original property (``Idempotency-Replayed: true``);\nthe same key with a different body returns **409**.","operationId":"multi_org_create_property_api_public_v1_properties_post","parameters":[{"in":"path","name":"organization_id","required":true,"schema":{"pattern":"^org_[A-Za-z0-9_]+$","title":"Organization Id","type":"string"}},{"in":"header","name":"Idempotency-Key","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicPropertyCreate"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicProperty"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"A property with this URL already exists, or the Idempotency-Key was reused with a different payload"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"RoboWriteMultiOrgOAuth":["robowrite:content:all_orgs","robowrite:organizations:read"]}],"summary":"Multi Org Create Property","tags":["public-api"]}},"/api/public/v2/organizations/{organization_id}/properties/{property_id}":{"get":{"description":"Retrieve a single property owned by the org.","operationId":"multi_org_get_property_api_public_v1_properties__property_id__get","parameters":[{"in":"path","name":"property_id","required":true,"schema":{"format":"uuid","title":"Property Id","type":"string"}},{"in":"path","name":"organization_id","required":true,"schema":{"pattern":"^org_[A-Za-z0-9_]+$","title":"Organization Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicProperty"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Property not found (absent or not owned by the org)"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"RoboWriteMultiOrgOAuth":["robowrite:content:all_orgs","robowrite:organizations:read"]}],"summary":"Multi Org Get Property","tags":["public-api"]}},"/api/public/v2/organizations/{organization_id}/reviewers":{"get":{"description":"List current organization members eligible for editorial review.","operationId":"multi_org_list_reviewers_api_public_v1_reviewers_get","parameters":[{"in":"path","name":"organization_id","required":true,"schema":{"pattern":"^org_[A-Za-z0-9_]+$","title":"Organization Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/OrgMember"},"title":"Response Multi Org List Reviewers Api Public V1 Reviewers Get","type":"array"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"RoboWriteMultiOrgOAuth":["robowrite:content:all_orgs","robowrite:organizations:read"]}],"summary":"Multi Org List Reviewers","tags":["public-api"]}},"/api/public/v2/organizations/{organization_id}/reviews":{"get":{"description":"Read durable editorial reviews and their exact version references after a disconnected session. An approved review authorizes editorial use and export only. Check is_current before using it.","operationId":"multi_org_list_reviews_api_public_v1_reviews_get","parameters":[{"in":"path","name":"organization_id","required":true,"schema":{"pattern":"^org_[A-Za-z0-9_]+$","title":"Organization Id","type":"string"}},{"in":"query","name":"content_item_id","required":false,"schema":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Content Item Id"}},{"in":"query","name":"limit","required":false,"schema":{"default":50,"maximum":200,"minimum":1,"title":"Limit","type":"integer"}},{"in":"query","name":"offset","required":false,"schema":{"default":0,"minimum":0,"title":"Offset","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReviewList"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"RoboWriteMultiOrgOAuth":["robowrite:content:all_orgs","robowrite:organizations:read"]}],"summary":"Multi Org List Reviews","tags":["public-api"]},"post":{"description":"Request editorial review of the current saved nonempty version. Repeating the same version recovers its review. This does not start generation or publication.","operationId":"multi_org_request_review_api_public_v1_reviews_post","parameters":[{"in":"path","name":"organization_id","required":true,"schema":{"pattern":"^org_[A-Za-z0-9_]+$","title":"Organization Id","type":"string"}},{"in":"header","name":"Idempotency-Key","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReviewCreateRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EditorialReview"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"RoboWriteMultiOrgOAuth":["robowrite:content:all_orgs","robowrite:organizations:read"]}],"summary":"Multi Org Request Review","tags":["public-api"]}},"/api/public/v2/organizations/{organization_id}/reviews/{review_id}":{"get":{"description":"Read one editorial review and its persisted decision even after the original job ends. This read never generates content or publishes.","operationId":"multi_org_get_review_api_public_v1_reviews__review_id__get","parameters":[{"in":"path","name":"review_id","required":true,"schema":{"format":"uuid","title":"Review Id","type":"string"}},{"in":"path","name":"organization_id","required":true,"schema":{"pattern":"^org_[A-Za-z0-9_]+$","title":"Organization Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EditorialReview"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"RoboWriteMultiOrgOAuth":["robowrite:content:all_orgs","robowrite:organizations:read"]}],"summary":"Multi Org Get Review","tags":["public-api"]}},"/api/public/v2/organizations/{organization_id}/reviews/{review_id}/assignments":{"post":{"description":"Claim an unassigned review for yourself, or assign/reassign a current organization member as an organization admin. Supply the exact version and current assignment revision. Reuse request_id with identical input on retries; changed assignments conflict.","operationId":"multi_org_assign_review_api_public_v1_reviews__review_id__assignments_post","parameters":[{"in":"path","name":"review_id","required":true,"schema":{"format":"uuid","title":"Review Id","type":"string"}},{"in":"path","name":"organization_id","required":true,"schema":{"pattern":"^org_[A-Za-z0-9_]+$","title":"Organization Id","type":"string"}},{"in":"header","name":"Idempotency-Key","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReviewAssignmentRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReviewAssignment"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"RoboWriteMultiOrgOAuth":["robowrite:content:all_orgs","robowrite:organizations:read"]}],"summary":"Multi Org Assign Review","tags":["public-api"]}},"/api/public/v2/organizations/{organization_id}/reviews/{review_id}/decisions":{"post":{"description":"Apply an editorial decision to the exact current version. Only the assigned current member or an organization admin may decide. Reuse request_id with identical input after a lost response. Approval never publishes; rejection retains the draft; a revision request records feedback and stops. Editing or rewriting requires another explicit action.","operationId":"multi_org_decide_review_api_public_v1_reviews__review_id__decisions_post","parameters":[{"in":"path","name":"review_id","required":true,"schema":{"format":"uuid","title":"Review Id","type":"string"}},{"in":"path","name":"organization_id","required":true,"schema":{"pattern":"^org_[A-Za-z0-9_]+$","title":"Organization Id","type":"string"}},{"in":"header","name":"Idempotency-Key","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReviewDecisionRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReviewDecision"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"RoboWriteMultiOrgOAuth":["robowrite:content:all_orgs","robowrite:organizations:read"]}],"summary":"Multi Org Decide Review","tags":["public-api"]}},"/api/public/v2/organizations/{organization_id}/selection":{"get":{"description":"Verify one intended workspace for content work. Pass its organization_id explicitly on subsequent calls and read its account before work. This stores no shared selection and changes no content or billing.","operationId":"select_organization_api_public_v2_organizations__organization_id__selection_get","parameters":[{"in":"path","name":"organization_id","required":true,"schema":{"pattern":"^org_[A-Za-z0-9_]+$","title":"Organization Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrganizationSelection"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"RoboWriteMultiOrgOAuth":["robowrite:content:all_orgs","robowrite:organizations:read"]}],"summary":"Select Organization","tags":["public-api"]}},"/api/public/v2/organizations/{organization_id}/tags":{"get":{"description":"List a brand's tags in pages of up to 200.","operationId":"multi_org_list_tags_api_public_v1_tags_get","parameters":[{"in":"path","name":"organization_id","required":true,"schema":{"pattern":"^org_[A-Za-z0-9_]+$","title":"Organization Id","type":"string"}},{"description":"Brand whose tags to list","in":"query","name":"brand_id","required":true,"schema":{"description":"Brand whose tags to list","format":"uuid","title":"Brand Id","type":"string"}},{"description":"Results per page","in":"query","name":"limit","required":false,"schema":{"default":50,"description":"Results per page","maximum":200,"minimum":1,"title":"Limit","type":"integer"}},{"description":"Pagination offset","in":"query","name":"offset","required":false,"schema":{"default":0,"description":"Pagination offset","minimum":0,"title":"Offset","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicPage_PublicTag_"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"RoboWriteMultiOrgOAuth":["robowrite:content:all_orgs","robowrite:organizations:read"]}],"summary":"Multi Org List Tags","tags":["public-api"]},"post":{"description":"Create a tag for a brand you own.\n\nThe ``Idempotency-Key`` header is **optional**: with one, a retry of the\nsame body replays the original tag (``Idempotency-Replayed: true``); the\nsame key with a different body returns **409**.","operationId":"multi_org_create_tag_api_public_v1_tags_post","parameters":[{"in":"path","name":"organization_id","required":true,"schema":{"pattern":"^org_[A-Za-z0-9_]+$","title":"Organization Id","type":"string"}},{"in":"header","name":"Idempotency-Key","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicTagCreate"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicTag"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Brand not found (absent or not owned by the org)"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Slug already exists for this brand, or the Idempotency-Key was reused with a different payload"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"RoboWriteMultiOrgOAuth":["robowrite:content:all_orgs","robowrite:organizations:read"]}],"summary":"Multi Org Create Tag","tags":["public-api"]}},"/api/public/v2/organizations/{organization_id}/tags/{tag_id}":{"delete":{"description":"Delete a tag. Returns 204 with no body; 404 when it does not exist or belongs to another organization.","operationId":"multi_org_delete_tag_api_public_v1_tags__tag_id__delete","parameters":[{"in":"path","name":"tag_id","required":true,"schema":{"format":"uuid","title":"Tag Id","type":"string"}},{"in":"path","name":"organization_id","required":true,"schema":{"pattern":"^org_[A-Za-z0-9_]+$","title":"Organization Id","type":"string"}}],"responses":{"204":{"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Tag not found (absent or not owned by the org)"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"RoboWriteMultiOrgOAuth":["robowrite:content:all_orgs","robowrite:organizations:read"]}],"summary":"Multi Org Delete Tag","tags":["public-api"]},"get":{"description":"Read one tag, including its parent and usage count.","operationId":"multi_org_get_tag_api_public_v1_tags__tag_id__get","parameters":[{"in":"path","name":"tag_id","required":true,"schema":{"format":"uuid","title":"Tag Id","type":"string"}},{"in":"path","name":"organization_id","required":true,"schema":{"pattern":"^org_[A-Za-z0-9_]+$","title":"Organization Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicTag"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Tag not found (absent or not owned by the org)"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"RoboWriteMultiOrgOAuth":["robowrite:content:all_orgs","robowrite:organizations:read"]}],"summary":"Multi Org Get Tag","tags":["public-api"]},"patch":{"description":"Partially update a tag: omitted fields stay unchanged. Returns 409 when the new slug is already used by the brand.","operationId":"multi_org_update_tag_api_public_v1_tags__tag_id__patch","parameters":[{"in":"path","name":"tag_id","required":true,"schema":{"format":"uuid","title":"Tag Id","type":"string"}},{"in":"path","name":"organization_id","required":true,"schema":{"pattern":"^org_[A-Za-z0-9_]+$","title":"Organization Id","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicTagUpdate"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicTag"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Tag not found (absent or not owned by the org)"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Slug already exists for this brand"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"RoboWriteMultiOrgOAuth":["robowrite:content:all_orgs","robowrite:organizations:read"]}],"summary":"Multi Org Update Tag","tags":["public-api"]}},"/api/public/v2/organizations/{organization_id}/topics":{"get":{"description":"List a brand's topic-bank ideas with filter, search, sort, and pagination.\n\nRequires ``brand_id``. Returns a page of topics with eligibility and\nscoring fields where available.","operationId":"multi_org_list_topics_api_public_v1_topics_get","parameters":[{"in":"path","name":"organization_id","required":true,"schema":{"pattern":"^org_[A-Za-z0-9_]+$","title":"Organization Id","type":"string"}},{"description":"Brand whose topics to list","in":"query","name":"brand_id","required":true,"schema":{"description":"Brand whose topics to list","format":"uuid","title":"Brand Id","type":"string"}},{"description":"Filter by pillar","in":"query","name":"pillar_id","required":false,"schema":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"description":"Filter by pillar","title":"Pillar Id"}},{"description":"Filter by keyword across title, primary, and secondary keywords","in":"query","name":"keyword","required":false,"schema":{"anyOf":[{"maxLength":120,"minLength":1,"type":"string"},{"type":"null"}],"description":"Filter by keyword across title, primary, and secondary keywords","title":"Keyword"}},{"description":"Filter by status","in":"query","name":"status","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/TopicIdeaStatus"},{"type":"null"}],"description":"Filter by status","title":"Status"}},{"description":"Minimum total score","in":"query","name":"min_score","required":false,"schema":{"default":0,"description":"Minimum total score","maximum":5,"minimum":0,"title":"Min Score","type":"number"}},{"description":"Property context for scores","in":"query","name":"property_id","required":false,"schema":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"description":"Property context for scores","title":"Property Id"}},{"description":"Results per page","in":"query","name":"limit","required":false,"schema":{"default":50,"description":"Results per page","maximum":200,"minimum":1,"title":"Limit","type":"integer"}},{"description":"Pagination offset","in":"query","name":"offset","required":false,"schema":{"default":0,"description":"Pagination offset","minimum":0,"title":"Offset","type":"integer"}},{"description":"Sort field","in":"query","name":"sort_by","required":false,"schema":{"$ref":"#/components/schemas/_TopicSortBy","default":"total_score","description":"Sort field"}},{"description":"Sort order","in":"query","name":"sort_order","required":false,"schema":{"$ref":"#/components/schemas/SortDirection","default":"desc","description":"Sort order"}},{"description":"Minimum search volume","in":"query","name":"min_volume","required":false,"schema":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"Minimum search volume","title":"Min Volume"}},{"description":"Maximum keyword difficulty","in":"query","name":"max_difficulty","required":false,"schema":{"anyOf":[{"maximum":100,"minimum":0,"type":"number"},{"type":"null"}],"description":"Maximum keyword difficulty","title":"Max Difficulty"}},{"description":"Search intent filter","in":"query","name":"intent","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/SearchIntent"},{"type":"null"}],"description":"Search intent filter","title":"Intent"}},{"description":"Filter by editorial routing band","in":"query","name":"decision_band","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/DecisionBand"},{"type":"null"}],"description":"Filter by editorial routing band","title":"Decision Band"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicPage_PublicTopic_"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"RoboWriteMultiOrgOAuth":["robowrite:content:all_orgs","robowrite:organizations:read"]}],"summary":"Multi Org List Topics","tags":["public-api"]}},"/api/public/v2/organizations/{organization_id}/topics/{topic_id}/content":{"get":{"description":"List content through direct topic-to-brief lineage, with AND filters.","operationId":"multi_org_list_topic_content_api_public_v1_topics__topic_id__content_get","parameters":[{"in":"path","name":"topic_id","required":true,"schema":{"format":"uuid","title":"Topic Id","type":"string"}},{"in":"path","name":"organization_id","required":true,"schema":{"pattern":"^org_[A-Za-z0-9_]+$","title":"Organization Id","type":"string"}},{"in":"query","name":"brand_id","required":false,"schema":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Brand Id"}},{"in":"query","name":"property_id","required":false,"schema":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Property Id"}},{"in":"query","name":"status","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/TaskStatus"},{"type":"null"}],"title":"Status"}},{"in":"query","name":"format","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/ContentFormat"},{"type":"null"}],"title":"Format"}},{"in":"query","name":"pillar_id","required":false,"schema":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Pillar Id"}},{"in":"query","name":"created_from","required":false,"schema":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Created From"}},{"in":"query","name":"created_before","required":false,"schema":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Created Before"}},{"in":"query","name":"q","required":false,"schema":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"title":"Q"}},{"in":"query","name":"keyword","required":false,"schema":{"anyOf":[{"maxLength":255,"type":"string"},{"type":"null"}],"title":"Keyword"}},{"in":"query","name":"limit","required":false,"schema":{"default":50,"maximum":200,"minimum":1,"title":"Limit","type":"integer"}},{"in":"query","name":"offset","required":false,"schema":{"default":0,"minimum":0,"title":"Offset","type":"integer"}},{"in":"query","name":"content_type","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/ContentFormat"},{"type":"null"}],"title":"Content Type"}},{"in":"query","name":"brief_id","required":false,"schema":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Brief Id"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicPage_PublicContentSummary_"}}},"description":"Successful Response","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicErrorBody"}}},"description":"Topic not found (absent or not owned by the org)"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"RoboWriteMultiOrgOAuth":["robowrite:content:all_orgs","robowrite:organizations:read"]}],"summary":"Multi Org List Topic Content","tags":["public-api"]}}},"security":[{"HTTPBearer":[]}],"servers":[{"description":"Production. RoboWrite's Public API is served from api.roboad.ai, the shared RoboAd platform host: RoboAd and RoboWrite are the same platform, and there is no robowrite.ai API hostname to call instead.","url":"https://api.roboad.ai"}]}