{ "components": { "schemas": { "AgentJobErrorCategory": { "enum": [ "FAILED_SCHEMA_VALIDATION", "CLI_EXIT_CODE_FAILURE", "TIMEOUT", "MISSING_OUTPUT_FILE", "UNSUPPORTED_CLAIMS_FOUND", "SOURCE_RETRIEVAL_FAILED", "RESEARCH_ARTIFACT_UPLOAD_FAILED", "PUBLISH_DRY_RUN_FAILED", "GIT_CHECKOUT_FAILED", "GIT_COMMIT_FAILED", "GIT_PUSH_NON_FAST_FORWARD", "PUBLISH_VERIFICATION_FAILED" ], "title": "AgentJobErrorCategory", "type": "string" }, "AgentJobListResponse": { "additionalProperties": false, "properties": { "jobs": { "items": { "$ref": "#/components/schemas/AgentJobSummary" }, "title": "Jobs", "type": "array" } }, "required": [ "jobs" ], "title": "AgentJobListResponse", "type": "object" }, "AgentJobOutput": { "additionalProperties": false, "properties": { "artifacts": { "items": { "$ref": "#/components/schemas/ResearchArtifactSummary" }, "title": "Artifacts", "type": "array" }, "error_category": { "anyOf": [ { "$ref": "#/components/schemas/AgentJobErrorCategory" }, { "type": "null" } ], "default": null }, "error_message": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Error Message" }, "output_files": { "items": { "$ref": "#/components/schemas/RunnerFileRef" }, "title": "Output Files", "type": "array" }, "payload": { "additionalProperties": true, "title": "Payload", "type": "object" }, "status": { "$ref": "#/components/schemas/AgentJobStatus" } }, "required": [ "status" ], "title": "AgentJobOutput", "type": "object" }, "AgentJobResponse": { "additionalProperties": false, "properties": { "job": { "$ref": "#/components/schemas/AgentJobSummary" } }, "required": [ "job" ], "title": "AgentJobResponse", "type": "object" }, "AgentJobStatus": { "enum": [ "QUEUED", "RUNNING", "SUCCEEDED", "FAILED", "CANCELLED" ], "title": "AgentJobStatus", "type": "string" }, "AgentJobSummary": { "additionalProperties": false, "properties": { "agent_profile": { "minLength": 1, "title": "Agent Profile", "type": "string" }, "article_id": { "anyOf": [ { "format": "uuid", "type": "string" }, { "type": "null" } ], "default": null, "title": "Article Id" }, "attempt": { "default": 1, "minimum": 1, "title": "Attempt", "type": "integer" }, "duration_ms": { "anyOf": [ { "minimum": 0, "type": "integer" }, { "type": "null" } ], "default": null, "title": "Duration Ms" }, "error_category": { "anyOf": [ { "$ref": "#/components/schemas/AgentJobErrorCategory" }, { "type": "null" } ], "default": null }, "error_message": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Error Message" }, "exit_code": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "default": null, "title": "Exit Code" }, "finished_at": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ], "default": null, "title": "Finished At" }, "id": { "format": "uuid", "title": "Id", "type": "string" }, "input_files": { "items": { "$ref": "#/components/schemas/RunnerFileRef" }, "title": "Input Files", "type": "array" }, "job_type": { "$ref": "#/components/schemas/AgentJobType" }, "output_files": { "items": { "$ref": "#/components/schemas/RunnerFileRef" }, "title": "Output Files", "type": "array" }, "parent_job_id": { "anyOf": [ { "format": "uuid", "type": "string" }, { "type": "null" } ], "default": null, "title": "Parent Job Id" }, "payload": { "additionalProperties": true, "title": "Payload", "type": "object" }, "queued_at": { "format": "date-time", "title": "Queued At", "type": "string" }, "started_at": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ], "default": null, "title": "Started At" }, "status": { "$ref": "#/components/schemas/AgentJobStatus" }, "stderr": { "default": "", "title": "Stderr", "type": "string" }, "stdout": { "default": "", "title": "Stdout", "type": "string" }, "workspace_path": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Workspace Path" } }, "required": [ "id", "job_type", "agent_profile", "status", "queued_at" ], "title": "AgentJobSummary", "type": "object" }, "AgentJobTestCodexRequest": { "additionalProperties": false, "properties": { "fake_result": { "default": "valid", "pattern": "^(valid|invalid_schema)$", "title": "Fake Result", "type": "string" } }, "title": "AgentJobTestCodexRequest", "type": "object" }, "AgentJobType": { "enum": [ "BOUNDARY_QUESTIONS", "PLAN_GENERATION", "RESEARCH", "EVIDENCE_MATRIX", "SECTION_SCAFFOLD", "DRAFT_ASSEMBLY", "SEO_REVIEW", "LANGUAGE_REVIEW", "PUBLISH_DRY_RUN", "PUBLISH_COMMIT", "TEST_CODEX" ], "title": "AgentJobType", "type": "string" }, "ArticleCreateRequest": { "additionalProperties": false, "properties": { "assigned_editor_id": { "anyOf": [ { "format": "uuid", "type": "string" }, { "type": "null" } ], "default": null, "title": "Assigned Editor Id" }, "brief_description": { "minLength": 1, "title": "Brief Description", "type": "string" }, "content_type": { "default": "longform_guide", "minLength": 1, "title": "Content Type", "type": "string" }, "language": { "default": "en", "minLength": 2, "title": "Language", "type": "string" }, "primary_keyword": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Primary Keyword" }, "target_site_id": { "format": "uuid", "title": "Target Site Id", "type": "string" }, "working_title": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Working Title" } }, "required": [ "target_site_id", "brief_description" ], "title": "ArticleCreateRequest", "type": "object" }, "ArticleCreateResponse": { "additionalProperties": false, "properties": { "article": { "$ref": "#/components/schemas/ArticleSummary" } }, "required": [ "article" ], "title": "ArticleCreateResponse", "type": "object" }, "ArticleDetailResponse": { "additionalProperties": false, "properties": { "agent_jobs": { "items": { "$ref": "#/components/schemas/AgentJobSummary" }, "title": "Agent Jobs", "type": "array" }, "article": { "$ref": "#/components/schemas/ArticleSummary" }, "assets": { "items": { "$ref": "#/components/schemas/AssetSummary" }, "title": "Assets", "type": "array" }, "boundary_questions": { "items": { "$ref": "#/components/schemas/BoundaryQuestionSummary" }, "title": "Boundary Questions", "type": "array" }, "claims": { "items": { "$ref": "#/components/schemas/ClaimSummary" }, "title": "Claims", "type": "array" }, "draft": { "anyOf": [ { "$ref": "#/components/schemas/DraftSummary" }, { "type": "null" } ], "default": null }, "evidence": { "items": { "$ref": "#/components/schemas/EvidenceSummary" }, "title": "Evidence", "type": "array" }, "plan": { "anyOf": [ { "$ref": "#/components/schemas/PlanSummary" }, { "type": "null" } ], "default": null }, "publish_commit": { "anyOf": [ { "$ref": "#/components/schemas/PublishCommitSummary" }, { "type": "null" } ], "default": null }, "research_manifests": { "items": { "$ref": "#/components/schemas/ResearchArtifactManifestSummary" }, "title": "Research Manifests", "type": "array" }, "reviews": { "items": { "$ref": "#/components/schemas/ReviewSummary" }, "title": "Reviews", "type": "array" }, "target_site": { "anyOf": [ { "$ref": "#/components/schemas/TargetSiteConfig" }, { "type": "null" } ], "default": null }, "workflow_events": { "items": { "$ref": "#/components/schemas/WorkflowEventSummary" }, "title": "Workflow Events", "type": "array" } }, "required": [ "article" ], "title": "ArticleDetailResponse", "type": "object" }, "ArticleListResponse": { "additionalProperties": false, "properties": { "articles": { "items": { "$ref": "#/components/schemas/ArticleSummary" }, "title": "Articles", "type": "array" } }, "required": [ "articles" ], "title": "ArticleListResponse", "type": "object" }, "ArticleSummary": { "additionalProperties": false, "properties": { "assigned_editor_id": { "anyOf": [ { "format": "uuid", "type": "string" }, { "type": "null" } ], "default": null, "title": "Assigned Editor Id" }, "brief_description": { "title": "Brief Description", "type": "string" }, "content_type": { "title": "Content Type", "type": "string" }, "created_at": { "format": "date-time", "title": "Created At", "type": "string" }, "id": { "format": "uuid", "title": "Id", "type": "string" }, "language": { "title": "Language", "type": "string" }, "primary_keyword": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Primary Keyword" }, "publishing_status": { "$ref": "#/components/schemas/PublishingStatus" }, "status": { "$ref": "#/components/schemas/ArticleWorkflowStatus" }, "target_site_id": { "format": "uuid", "title": "Target Site Id", "type": "string" }, "updated_at": { "format": "date-time", "title": "Updated At", "type": "string" }, "working_title": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Working Title" } }, "required": [ "id", "target_site_id", "status", "publishing_status", "brief_description", "language", "content_type", "created_at", "updated_at" ], "title": "ArticleSummary", "type": "object" }, "ArticleWorkflowStatus": { "enum": [ "ARTICLE_BRIEF_CREATED", "BOUNDARY_QUESTIONS_GENERATED", "BOUNDARY_ANSWERS_SUBMITTED", "PLAN_GENERATED", "PLAN_REVIEW_REQUIRED", "PLAN_REVISION_REQUIRED", "RESEARCH_RUNNING", "EVIDENCE_MATRIX_READY", "PARALLEL_PRODUCTION_RUNNING", "DRAFT_ASSEMBLED", "SEO_AND_LANGUAGE_REVIEW_READY", "FINAL_REVIEW_REQUIRED", "FINAL_REVISION_REQUIRED", "PUBLISH_DRY_RUN_REQUIRED", "PUBLISH_COMMIT_READY", "PUBLISH_COMMIT_CREATED" ], "title": "ArticleWorkflowStatus", "type": "string" }, "AssetGenerateSpecsResponse": { "additionalProperties": false, "properties": { "assets": { "items": { "$ref": "#/components/schemas/AssetSummary" }, "title": "Assets", "type": "array" } }, "title": "AssetGenerateSpecsResponse", "type": "object" }, "AssetListResponse": { "additionalProperties": false, "properties": { "assets": { "items": { "$ref": "#/components/schemas/AssetSummary" }, "title": "Assets", "type": "array" } }, "title": "AssetListResponse", "type": "object" }, "AssetResponse": { "additionalProperties": false, "properties": { "asset": { "$ref": "#/components/schemas/AssetSummary" } }, "required": [ "asset" ], "title": "AssetResponse", "type": "object" }, "AssetRevisionSummary": { "additionalProperties": false, "properties": { "action": { "minLength": 1, "title": "Action", "type": "string" }, "actor_user_id": { "anyOf": [ { "format": "uuid", "type": "string" }, { "type": "null" } ], "default": null, "title": "Actor User Id" }, "article_id": { "format": "uuid", "title": "Article Id", "type": "string" }, "asset_id": { "format": "uuid", "title": "Asset Id", "type": "string" }, "created_at": { "format": "date-time", "title": "Created At", "type": "string" }, "id": { "format": "uuid", "title": "Id", "type": "string" }, "payload": { "additionalProperties": true, "title": "Payload", "type": "object" }, "revision_index": { "minimum": 1, "title": "Revision Index", "type": "integer" } }, "required": [ "id", "asset_id", "article_id", "revision_index", "action", "created_at" ], "title": "AssetRevisionSummary", "type": "object" }, "AssetStatus": { "enum": [ "PENDING", "GENERATED", "APPROVED", "REJECTED" ], "title": "AssetStatus", "type": "string" }, "AssetSummary": { "additionalProperties": false, "properties": { "alt_text": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Alt Text" }, "article_id": { "format": "uuid", "title": "Article Id", "type": "string" }, "asset_type": { "$ref": "#/components/schemas/AssetType" }, "caption": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Caption" }, "created_at": { "format": "date-time", "title": "Created At", "type": "string" }, "file_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "File Url" }, "history": { "items": { "$ref": "#/components/schemas/AssetRevisionSummary" }, "title": "History", "type": "array" }, "id": { "format": "uuid", "title": "Id", "type": "string" }, "object_key": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Object Key" }, "prompt": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Prompt" }, "section_id": { "anyOf": [ { "format": "uuid", "type": "string" }, { "type": "null" } ], "default": null, "title": "Section Id" }, "status": { "$ref": "#/components/schemas/AssetStatus" }, "title": { "minLength": 1, "title": "Title", "type": "string" }, "updated_at": { "format": "date-time", "title": "Updated At", "type": "string" } }, "required": [ "id", "article_id", "asset_type", "title", "status", "created_at", "updated_at" ], "title": "AssetSummary", "type": "object" }, "AssetType": { "enum": [ "hero_image", "diagram", "table", "flowchart", "comparison_matrix", "architecture_diagram", "inline_image" ], "title": "AssetType", "type": "string" }, "AssetUpdateRequest": { "additionalProperties": false, "properties": { "alt_text": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Alt Text" }, "caption": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Caption" }, "prompt": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Prompt" }, "section_id": { "anyOf": [ { "format": "uuid", "type": "string" }, { "type": "null" } ], "default": null, "title": "Section Id" }, "status": { "anyOf": [ { "$ref": "#/components/schemas/AssetStatus" }, { "type": "null" } ], "default": null }, "title": { "anyOf": [ { "minLength": 1, "type": "string" }, { "type": "null" } ], "default": null, "title": "Title" } }, "title": "AssetUpdateRequest", "type": "object" }, "AssetUploadRequest": { "additionalProperties": false, "properties": { "content_base64": { "minLength": 1, "title": "Content Base64", "type": "string" }, "content_type": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Content Type" }, "filename": { "minLength": 1, "title": "Filename", "type": "string" } }, "required": [ "filename", "content_base64" ], "title": "AssetUploadRequest", "type": "object" }, "AssetUploadResponse": { "additionalProperties": false, "properties": { "asset": { "$ref": "#/components/schemas/AssetSummary" } }, "required": [ "asset" ], "title": "AssetUploadResponse", "type": "object" }, "BoundaryQuestionListResponse": { "additionalProperties": false, "properties": { "job": { "anyOf": [ { "$ref": "#/components/schemas/AgentJobSummary" }, { "type": "null" } ], "default": null }, "questions": { "items": { "$ref": "#/components/schemas/BoundaryQuestionSummary" }, "title": "Questions", "type": "array" } }, "required": [ "questions" ], "title": "BoundaryQuestionListResponse", "type": "object" }, "BoundaryQuestionResponse": { "additionalProperties": false, "properties": { "question": { "$ref": "#/components/schemas/BoundaryQuestionSummary" } }, "required": [ "question" ], "title": "BoundaryQuestionResponse", "type": "object" }, "BoundaryQuestionSummary": { "additionalProperties": false, "properties": { "answer": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Answer" }, "article_id": { "format": "uuid", "title": "Article Id", "type": "string" }, "category": { "minLength": 1, "title": "Category", "type": "string" }, "created_at": { "format": "date-time", "title": "Created At", "type": "string" }, "id": { "format": "uuid", "title": "Id", "type": "string" }, "is_required": { "default": true, "title": "Is Required", "type": "boolean" }, "question": { "minLength": 1, "title": "Question", "type": "string" }, "sort_order": { "minimum": 1, "title": "Sort Order", "type": "integer" }, "updated_at": { "format": "date-time", "title": "Updated At", "type": "string" } }, "required": [ "id", "article_id", "sort_order", "category", "question", "created_at", "updated_at" ], "title": "BoundaryQuestionSummary", "type": "object" }, "BoundaryQuestionUpdateRequest": { "additionalProperties": false, "properties": { "answer": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Answer" } }, "title": "BoundaryQuestionUpdateRequest", "type": "object" }, "ClaimRiskLevel": { "enum": [ "low", "medium", "high" ], "title": "ClaimRiskLevel", "type": "string" }, "ClaimSummary": { "additionalProperties": false, "properties": { "article_id": { "format": "uuid", "title": "Article Id", "type": "string" }, "claim_text": { "minLength": 1, "title": "Claim Text", "type": "string" }, "evidence_item_ids": { "items": { "format": "uuid", "type": "string" }, "title": "Evidence Item Ids", "type": "array" }, "id": { "format": "uuid", "title": "Id", "type": "string" }, "risk_level": { "$ref": "#/components/schemas/ClaimRiskLevel" }, "section_id": { "anyOf": [ { "format": "uuid", "type": "string" }, { "type": "null" } ], "default": null, "title": "Section Id" }, "support_status": { "$ref": "#/components/schemas/ClaimSupportStatus" } }, "required": [ "id", "article_id", "claim_text", "support_status", "risk_level" ], "title": "ClaimSummary", "type": "object" }, "ClaimSupportStatus": { "enum": [ "SUPPORTED", "UNSUPPORTED", "NEEDS_REVIEW" ], "title": "ClaimSupportStatus", "type": "string" }, "ContentReviewIssueSummary": { "additionalProperties": false, "properties": { "id": { "minLength": 1, "title": "Id", "type": "string" }, "location": { "minLength": 1, "title": "Location", "type": "string" }, "message": { "minLength": 1, "title": "Message", "type": "string" }, "severity": { "minLength": 1, "title": "Severity", "type": "string" }, "status": { "$ref": "#/components/schemas/ReviewSuggestionStatus" }, "suggested_fix": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Suggested Fix" }, "suggested_rewrite": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Suggested Rewrite" }, "suggestion_id": { "format": "uuid", "title": "Suggestion Id", "type": "string" } }, "required": [ "id", "suggestion_id", "severity", "location", "message", "status" ], "title": "ContentReviewIssueSummary", "type": "object" }, "ContentReviewKind": { "enum": [ "SEO", "LANGUAGE" ], "title": "ContentReviewKind", "type": "string" }, "ContentReviewReportSummary": { "additionalProperties": false, "properties": { "article_id": { "format": "uuid", "title": "Article Id", "type": "string" }, "created_at": { "format": "date-time", "title": "Created At", "type": "string" }, "draft_id": { "format": "uuid", "title": "Draft Id", "type": "string" }, "id": { "format": "uuid", "title": "Id", "type": "string" }, "issues": { "items": { "$ref": "#/components/schemas/ContentReviewIssueSummary" }, "title": "Issues", "type": "array" }, "recommended_slug": { "minLength": 1, "title": "Recommended Slug", "type": "string" }, "recommended_title": { "minLength": 1, "title": "Recommended Title", "type": "string" }, "review_kind": { "$ref": "#/components/schemas/ContentReviewKind" }, "rules_snapshot": { "additionalProperties": true, "title": "Rules Snapshot", "type": "object" }, "schema_json": { "additionalProperties": true, "title": "Schema Json", "type": "object" }, "score": { "maximum": 100, "minimum": 0, "title": "Score", "type": "integer" } }, "required": [ "id", "article_id", "review_kind", "draft_id", "score", "recommended_slug", "recommended_title", "created_at" ], "title": "ContentReviewReportSummary", "type": "object" }, "ContentReviewSuggestionSummary": { "additionalProperties": false, "properties": { "applied_text": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Applied Text" }, "article_id": { "format": "uuid", "title": "Article Id", "type": "string" }, "created_at": { "format": "date-time", "title": "Created At", "type": "string" }, "id": { "format": "uuid", "title": "Id", "type": "string" }, "location": { "minLength": 1, "title": "Location", "type": "string" }, "message": { "minLength": 1, "title": "Message", "type": "string" }, "patch": { "additionalProperties": true, "title": "Patch", "type": "object" }, "report_id": { "format": "uuid", "title": "Report Id", "type": "string" }, "review_kind": { "$ref": "#/components/schemas/ContentReviewKind" }, "severity": { "minLength": 1, "title": "Severity", "type": "string" }, "status": { "$ref": "#/components/schemas/ReviewSuggestionStatus" }, "suggested_fix": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Suggested Fix" }, "suggested_rewrite": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Suggested Rewrite" }, "suggestion_key": { "minLength": 1, "title": "Suggestion Key", "type": "string" }, "updated_at": { "format": "date-time", "title": "Updated At", "type": "string" } }, "required": [ "id", "article_id", "review_kind", "report_id", "suggestion_key", "severity", "location", "message", "status", "created_at", "updated_at" ], "title": "ContentReviewSuggestionSummary", "type": "object" }, "CurrentUser": { "additionalProperties": false, "properties": { "display_name": { "minLength": 1, "title": "Display Name", "type": "string" }, "email": { "minLength": 1, "title": "Email", "type": "string" }, "id": { "format": "uuid", "title": "Id", "type": "string" }, "role": { "$ref": "#/components/schemas/Role" } }, "required": [ "id", "email", "display_name", "role" ], "title": "CurrentUser", "type": "object" }, "CurrentUserResponse": { "additionalProperties": false, "properties": { "user": { "$ref": "#/components/schemas/CurrentUser" } }, "required": [ "user" ], "title": "CurrentUserResponse", "type": "object" }, "DraftAssembleResponse": { "additionalProperties": false, "properties": { "draft": { "$ref": "#/components/schemas/DraftSummary" } }, "required": [ "draft" ], "title": "DraftAssembleResponse", "type": "object" }, "DraftFaqItem": { "additionalProperties": false, "properties": { "answer": { "minLength": 1, "title": "Answer", "type": "string" }, "question": { "minLength": 1, "title": "Question", "type": "string" } }, "required": [ "question", "answer" ], "title": "DraftFaqItem", "type": "object" }, "DraftListResponse": { "additionalProperties": false, "properties": { "drafts": { "items": { "$ref": "#/components/schemas/DraftSummary" }, "title": "Drafts", "type": "array" } }, "title": "DraftListResponse", "type": "object" }, "DraftResponse": { "additionalProperties": false, "properties": { "draft": { "$ref": "#/components/schemas/DraftSummary" } }, "required": [ "draft" ], "title": "DraftResponse", "type": "object" }, "DraftSummary": { "additionalProperties": false, "properties": { "article_id": { "format": "uuid", "title": "Article Id", "type": "string" }, "based_on_draft_id": { "anyOf": [ { "format": "uuid", "type": "string" }, { "type": "null" } ], "default": null, "title": "Based On Draft Id" }, "body_markdown": { "default": "", "title": "Body Markdown", "type": "string" }, "body_object_key": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Body Object Key" }, "created_at": { "format": "date-time", "title": "Created At", "type": "string" }, "evidence_references": { "items": { "format": "uuid", "type": "string" }, "title": "Evidence References", "type": "array" }, "faq_items": { "items": { "$ref": "#/components/schemas/DraftFaqItem" }, "title": "Faq Items", "type": "array" }, "id": { "format": "uuid", "title": "Id", "type": "string" }, "meta_description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Meta Description" }, "meta_title": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Meta Title" }, "slug": { "minLength": 1, "title": "Slug", "type": "string" }, "status": { "$ref": "#/components/schemas/ArticleWorkflowStatus" }, "title": { "minLength": 1, "title": "Title", "type": "string" }, "unsupported_claim_warnings": { "items": { "type": "string" }, "title": "Unsupported Claim Warnings", "type": "array" }, "updated_at": { "format": "date-time", "title": "Updated At", "type": "string" }, "version": { "minimum": 1, "title": "Version", "type": "integer" }, "visual_placeholders": { "items": { "type": "string" }, "title": "Visual Placeholders", "type": "array" } }, "required": [ "id", "article_id", "version", "title", "slug", "status", "created_at", "updated_at" ], "title": "DraftSummary", "type": "object" }, "DraftUpdateRequest": { "additionalProperties": false, "properties": { "body_markdown": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Body Markdown" }, "evidence_references": { "anyOf": [ { "items": { "format": "uuid", "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Evidence References" }, "faq_items": { "anyOf": [ { "items": { "$ref": "#/components/schemas/DraftFaqItem" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Faq Items" }, "meta_description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Meta Description" }, "meta_title": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Meta Title" }, "title": { "anyOf": [ { "minLength": 1, "type": "string" }, { "type": "null" } ], "default": null, "title": "Title" }, "unsupported_claim_warnings": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Unsupported Claim Warnings" }, "visual_placeholders": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Visual Placeholders" } }, "title": "DraftUpdateRequest", "type": "object" }, "EvidenceCreateRequest": { "additionalProperties": false, "properties": { "claim_text": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Claim Text" }, "risk_level": { "$ref": "#/components/schemas/ClaimRiskLevel", "default": "low" }, "section_id": { "anyOf": [ { "format": "uuid", "type": "string" }, { "type": "null" } ], "default": null, "title": "Section Id" }, "source_quality_score": { "default": 0.7, "maximum": 1, "minimum": 0, "title": "Source Quality Score", "type": "number" }, "source_title": { "minLength": 1, "title": "Source Title", "type": "string" }, "source_type": { "minLength": 1, "title": "Source Type", "type": "string" }, "source_url": { "minLength": 1, "title": "Source Url", "type": "string" }, "summary": { "minLength": 1, "title": "Summary", "type": "string" }, "support_status": { "$ref": "#/components/schemas/ClaimSupportStatus", "default": "SUPPORTED" } }, "required": [ "source_title", "source_url", "source_type", "summary" ], "title": "EvidenceCreateRequest", "type": "object" }, "EvidenceMatrixResponse": { "additionalProperties": false, "properties": { "article": { "$ref": "#/components/schemas/ArticleSummary" }, "claims": { "items": { "$ref": "#/components/schemas/ClaimSummary" }, "title": "Claims", "type": "array" }, "evidence": { "items": { "$ref": "#/components/schemas/EvidenceSummary" }, "title": "Evidence", "type": "array" }, "insufficient_evidence_reasons": { "items": { "type": "string" }, "title": "Insufficient Evidence Reasons", "type": "array" } }, "required": [ "article" ], "title": "EvidenceMatrixResponse", "type": "object" }, "EvidenceResponse": { "additionalProperties": false, "properties": { "evidence": { "$ref": "#/components/schemas/EvidenceSummary" } }, "required": [ "evidence" ], "title": "EvidenceResponse", "type": "object" }, "EvidenceSummary": { "additionalProperties": false, "properties": { "article_id": { "format": "uuid", "title": "Article Id", "type": "string" }, "artifact_manifest_id": { "format": "uuid", "title": "Artifact Manifest Id", "type": "string" }, "id": { "format": "uuid", "title": "Id", "type": "string" }, "retrieved_at": { "format": "date-time", "title": "Retrieved At", "type": "string" }, "review_status": { "default": "PENDING", "minLength": 1, "title": "Review Status", "type": "string" }, "source_quality_score": { "maximum": 1, "minimum": 0, "title": "Source Quality Score", "type": "number" }, "source_title": { "minLength": 1, "title": "Source Title", "type": "string" }, "source_type": { "minLength": 1, "title": "Source Type", "type": "string" }, "source_url": { "minLength": 1, "title": "Source Url", "type": "string" }, "summary": { "minLength": 1, "title": "Summary", "type": "string" }, "supports_claims": { "items": { "format": "uuid", "type": "string" }, "title": "Supports Claims", "type": "array" } }, "required": [ "id", "article_id", "source_title", "source_url", "source_type", "source_quality_score", "summary", "artifact_manifest_id", "retrieved_at" ], "title": "EvidenceSummary", "type": "object" }, "EvidenceUpdateRequest": { "additionalProperties": false, "properties": { "review_status": { "anyOf": [ { "pattern": "^(PENDING|APPROVED|REJECTED)$", "type": "string" }, { "type": "null" } ], "default": null, "title": "Review Status" } }, "title": "EvidenceUpdateRequest", "type": "object" }, "FinalApprovalChecklistItemSummary": { "additionalProperties": false, "properties": { "blocker": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Blocker" }, "completed": { "title": "Completed", "type": "boolean" }, "key": { "minLength": 1, "title": "Key", "type": "string" }, "title": { "minLength": 1, "title": "Title", "type": "string" } }, "required": [ "key", "title", "completed" ], "title": "FinalApprovalChecklistItemSummary", "type": "object" }, "FinalApprovalChecklistResponse": { "additionalProperties": false, "properties": { "article_id": { "format": "uuid", "title": "Article Id", "type": "string" }, "blockers": { "items": { "type": "string" }, "title": "Blockers", "type": "array" }, "can_approve": { "title": "Can Approve", "type": "boolean" }, "completed_items": { "items": { "type": "string" }, "title": "Completed Items", "type": "array" }, "draft_version": { "anyOf": [ { "minimum": 1, "type": "integer" }, { "type": "null" } ], "default": null, "title": "Draft Version" }, "items": { "items": { "$ref": "#/components/schemas/FinalApprovalChecklistItemSummary" }, "title": "Items", "type": "array" }, "requested_draft_version": { "anyOf": [ { "minimum": 1, "type": "integer" }, { "type": "null" } ], "default": null, "title": "Requested Draft Version" } }, "required": [ "article_id", "can_approve" ], "title": "FinalApprovalChecklistResponse", "type": "object" }, "FinalApprovalPublishingSettings": { "additionalProperties": false, "properties": { "author": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Author" }, "content_path": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Content Path" }, "frontmatter": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Frontmatter" }, "publishing_mode": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Publishing Mode" } }, "title": "FinalApprovalPublishingSettings", "type": "object" }, "FinalApprovalRequest": { "additionalProperties": false, "properties": { "draft_version": { "anyOf": [ { "minimum": 1, "type": "integer" }, { "type": "null" } ], "default": null, "title": "Draft Version" }, "publishing_settings": { "anyOf": [ { "$ref": "#/components/schemas/FinalApprovalPublishingSettings" }, { "type": "null" } ], "default": null } }, "title": "FinalApprovalRequest", "type": "object" }, "FinalApprovalResponse": { "additionalProperties": false, "properties": { "article": { "$ref": "#/components/schemas/ArticleSummary" }, "checklist": { "$ref": "#/components/schemas/FinalApprovalChecklistResponse" } }, "required": [ "article", "checklist" ], "title": "FinalApprovalResponse", "type": "object" }, "FinalReviewIssueSummary": { "additionalProperties": false, "properties": { "location": { "minLength": 1, "title": "Location", "type": "string" }, "message": { "minLength": 1, "title": "Message", "type": "string" }, "review_kind": { "$ref": "#/components/schemas/ContentReviewKind" }, "severity": { "minLength": 1, "title": "Severity", "type": "string" }, "status": { "$ref": "#/components/schemas/ReviewSuggestionStatus" }, "suggestion_id": { "format": "uuid", "title": "Suggestion Id", "type": "string" } }, "required": [ "review_kind", "suggestion_id", "severity", "location", "message", "status" ], "title": "FinalReviewIssueSummary", "type": "object" }, "FinalReviewIssuesResponse": { "additionalProperties": false, "properties": { "article_id": { "format": "uuid", "title": "Article Id", "type": "string" }, "unresolved_count": { "minimum": 0, "title": "Unresolved Count", "type": "integer" }, "unresolved_issues": { "items": { "$ref": "#/components/schemas/FinalReviewIssueSummary" }, "title": "Unresolved Issues", "type": "array" } }, "required": [ "article_id", "unresolved_count" ], "title": "FinalReviewIssuesResponse", "type": "object" }, "FinalRevisionRequest": { "additionalProperties": false, "properties": { "draft_version": { "anyOf": [ { "minimum": 1, "type": "integer" }, { "type": "null" } ], "default": null, "title": "Draft Version" }, "reason": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Reason" } }, "title": "FinalRevisionRequest", "type": "object" }, "FinalRevisionRequestResponse": { "additionalProperties": false, "properties": { "article": { "$ref": "#/components/schemas/ArticleSummary" }, "checklist": { "$ref": "#/components/schemas/FinalApprovalChecklistResponse" } }, "required": [ "article", "checklist" ], "title": "FinalRevisionRequestResponse", "type": "object" }, "HTTPValidationError": { "properties": { "detail": { "items": { "$ref": "#/components/schemas/ValidationError" }, "title": "Detail", "type": "array" } }, "title": "HTTPValidationError", "type": "object" }, "LanguageReviewReportResponse": { "additionalProperties": false, "properties": { "report": { "$ref": "#/components/schemas/ContentReviewReportSummary" } }, "required": [ "report" ], "title": "LanguageReviewReportResponse", "type": "object" }, "LanguageReviewRunResponse": { "additionalProperties": false, "properties": { "report": { "$ref": "#/components/schemas/ContentReviewReportSummary" } }, "required": [ "report" ], "title": "LanguageReviewRunResponse", "type": "object" }, "PlanListResponse": { "additionalProperties": false, "properties": { "plans": { "items": { "$ref": "#/components/schemas/PlanSummary" }, "title": "Plans", "type": "array" } }, "required": [ "plans" ], "title": "PlanListResponse", "type": "object" }, "PlanResponse": { "additionalProperties": false, "properties": { "plan": { "$ref": "#/components/schemas/PlanSummary" } }, "required": [ "plan" ], "title": "PlanResponse", "type": "object" }, "PlanReviewStatus": { "enum": [ "PENDING_REVIEW", "APPROVED", "REVISION_REQUESTED" ], "title": "PlanReviewStatus", "type": "string" }, "PlanRevisionRequest": { "additionalProperties": false, "properties": { "notes": { "minLength": 1, "title": "Notes", "type": "string" } }, "required": [ "notes" ], "title": "PlanRevisionRequest", "type": "object" }, "PlanSectionEditRequest": { "additionalProperties": false, "properties": { "claims_to_support": { "items": { "type": "string" }, "title": "Claims To Support", "type": "array" }, "evidence_needs": { "items": { "type": "string" }, "title": "Evidence Needs", "type": "array" }, "heading": { "minLength": 1, "title": "Heading", "type": "string" }, "key_points": { "items": { "type": "string" }, "title": "Key Points", "type": "array" }, "purpose": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Purpose" }, "target_word_count": { "anyOf": [ { "minimum": 1, "type": "integer" }, { "type": "null" } ], "default": null, "title": "Target Word Count" } }, "required": [ "heading" ], "title": "PlanSectionEditRequest", "type": "object" }, "PlanSectionSummary": { "additionalProperties": false, "properties": { "article_plan_id": { "format": "uuid", "title": "Article Plan Id", "type": "string" }, "claims_to_support": { "items": { "type": "string" }, "title": "Claims To Support", "type": "array" }, "evidence_needs": { "items": { "type": "string" }, "title": "Evidence Needs", "type": "array" }, "heading": { "minLength": 1, "title": "Heading", "type": "string" }, "id": { "format": "uuid", "title": "Id", "type": "string" }, "key_points": { "items": { "type": "string" }, "title": "Key Points", "type": "array" }, "purpose": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Purpose" }, "sort_order": { "minimum": 1, "title": "Sort Order", "type": "integer" }, "target_word_count": { "anyOf": [ { "minimum": 1, "type": "integer" }, { "type": "null" } ], "default": null, "title": "Target Word Count" } }, "required": [ "id", "article_plan_id", "sort_order", "heading" ], "title": "PlanSectionSummary", "type": "object" }, "PlanSummary": { "additionalProperties": false, "properties": { "article_id": { "format": "uuid", "title": "Article Id", "type": "string" }, "audience": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Audience" }, "claims_to_prove": { "items": { "type": "string" }, "title": "Claims To Prove", "type": "array" }, "created_at": { "format": "date-time", "title": "Created At", "type": "string" }, "evidence_needs": { "items": { "type": "string" }, "title": "Evidence Needs", "type": "array" }, "excluded_sources": { "items": { "type": "string" }, "title": "Excluded Sources", "type": "array" }, "id": { "format": "uuid", "title": "Id", "type": "string" }, "reader_persona": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Reader Persona" }, "recommended_title": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Recommended Title" }, "risks": { "items": { "type": "string" }, "title": "Risks", "type": "array" }, "search_intent": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Search Intent" }, "sections": { "items": { "$ref": "#/components/schemas/PlanSectionSummary" }, "title": "Sections", "type": "array" }, "seo_notes": { "items": { "type": "string" }, "title": "Seo Notes", "type": "array" }, "source_requirements": { "items": { "type": "string" }, "title": "Source Requirements", "type": "array" }, "status": { "$ref": "#/components/schemas/PlanReviewStatus" }, "thesis": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Thesis" }, "title_options": { "items": { "type": "string" }, "title": "Title Options", "type": "array" }, "tone": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Tone" }, "version": { "minimum": 1, "title": "Version", "type": "integer" }, "visual_needs": { "items": { "type": "string" }, "title": "Visual Needs", "type": "array" } }, "required": [ "id", "article_id", "version", "status", "created_at" ], "title": "PlanSummary", "type": "object" }, "PlanUpdateRequest": { "additionalProperties": false, "properties": { "audience": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Audience" }, "claims_to_prove": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Claims To Prove" }, "evidence_needs": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Evidence Needs" }, "excluded_sources": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Excluded Sources" }, "reader_persona": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Reader Persona" }, "recommended_title": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Recommended Title" }, "risks": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Risks" }, "search_intent": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Search Intent" }, "sections": { "anyOf": [ { "items": { "$ref": "#/components/schemas/PlanSectionEditRequest" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Sections" }, "seo_notes": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Seo Notes" }, "source_requirements": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Source Requirements" }, "thesis": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Thesis" }, "title_options": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Title Options" }, "tone": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Tone" }, "visual_needs": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Visual Needs" } }, "title": "PlanUpdateRequest", "type": "object" }, "PublishCommitSummary": { "additionalProperties": false, "properties": { "article_id": { "format": "uuid", "title": "Article Id", "type": "string" }, "branch": { "minLength": 1, "title": "Branch", "type": "string" }, "commit_sha": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Commit Sha" }, "content_bundle_manifest": { "additionalProperties": true, "title": "Content Bundle Manifest", "type": "object" }, "created_at": { "format": "date-time", "title": "Created At", "type": "string" }, "deployment_status": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Deployment Status" }, "id": { "format": "uuid", "title": "Id", "type": "string" }, "repository_url": { "minLength": 1, "title": "Repository Url", "type": "string" }, "status": { "$ref": "#/components/schemas/PublishingStatus" }, "target_site_id": { "format": "uuid", "title": "Target Site Id", "type": "string" } }, "required": [ "id", "article_id", "target_site_id", "repository_url", "branch", "status", "created_at" ], "title": "PublishCommitSummary", "type": "object" }, "PublishingRules": { "additionalProperties": false, "properties": { "asset_path_template": { "minLength": 1, "title": "Asset Path Template", "type": "string" }, "content_format": { "default": "mdx", "minLength": 1, "title": "Content Format", "type": "string" }, "content_path_template": { "minLength": 1, "title": "Content Path Template", "type": "string" }, "dry_run_renderer": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Dry Run Renderer" }, "frontmatter_mapping": { "additionalProperties": true, "title": "Frontmatter Mapping", "type": "object" }, "production_branch": { "minLength": 1, "title": "Production Branch", "type": "string" }, "repository_url": { "minLength": 1, "title": "Repository Url", "type": "string" }, "transform_script_version_id": { "anyOf": [ { "format": "uuid", "type": "string" }, { "type": "null" } ], "default": null, "title": "Transform Script Version Id" } }, "required": [ "repository_url", "production_branch", "content_path_template", "asset_path_template" ], "title": "PublishingRules", "type": "object" }, "PublishingStatus": { "enum": [ "PUBLISH_NOT_STARTED", "PUBLISH_DRY_RUN_REQUIRED", "PUBLISH_DRY_RUN_RUNNING", "PUBLISH_DRY_RUN_FAILED", "PUBLISH_COMMIT_READY", "PUBLISH_COMMIT_CREATED", "PUBLISH_VERIFICATION_FAILED" ], "title": "PublishingStatus", "type": "string" }, "ResearchArtifactManifestSummary": { "additionalProperties": false, "properties": { "agent_job_id": { "format": "uuid", "title": "Agent Job Id", "type": "string" }, "article_id": { "format": "uuid", "title": "Article Id", "type": "string" }, "artifacts": { "items": { "$ref": "#/components/schemas/ResearchArtifactSummary" }, "title": "Artifacts", "type": "array" }, "created_at": { "format": "date-time", "title": "Created At", "type": "string" }, "id": { "format": "uuid", "title": "Id", "type": "string" }, "s3_prefix": { "minLength": 1, "title": "S3 Prefix", "type": "string" } }, "required": [ "id", "article_id", "agent_job_id", "s3_prefix", "created_at" ], "title": "ResearchArtifactManifestSummary", "type": "object" }, "ResearchArtifactSummary": { "additionalProperties": false, "properties": { "artifact_type": { "minLength": 1, "title": "Artifact Type", "type": "string" }, "content_hash": { "minLength": 1, "title": "Content Hash", "type": "string" }, "metadata": { "additionalProperties": true, "title": "Metadata", "type": "object" }, "object_key": { "minLength": 1, "title": "Object Key", "type": "string" }, "source_url": { "minLength": 1, "title": "Source Url", "type": "string" } }, "required": [ "artifact_type", "source_url", "object_key", "content_hash" ], "title": "ResearchArtifactSummary", "type": "object" }, "ResearchListResponse": { "additionalProperties": false, "properties": { "evidence": { "items": { "$ref": "#/components/schemas/EvidenceSummary" }, "title": "Evidence", "type": "array" }, "manifests": { "items": { "$ref": "#/components/schemas/ResearchArtifactManifestSummary" }, "title": "Manifests", "type": "array" } }, "title": "ResearchListResponse", "type": "object" }, "ResearchStartResponse": { "additionalProperties": false, "properties": { "article": { "$ref": "#/components/schemas/ArticleSummary" }, "job": { "$ref": "#/components/schemas/AgentJobSummary" }, "manifest": { "$ref": "#/components/schemas/ResearchArtifactManifestSummary" } }, "required": [ "article", "job", "manifest" ], "title": "ResearchStartResponse", "type": "object" }, "ReviewActionResponse": { "additionalProperties": false, "properties": { "review": { "$ref": "#/components/schemas/ReviewSummary" } }, "required": [ "review" ], "title": "ReviewActionResponse", "type": "object" }, "ReviewStatus": { "enum": [ "PENDING", "APPROVED", "CHANGES_REQUESTED" ], "title": "ReviewStatus", "type": "string" }, "ReviewSuggestionActionResponse": { "additionalProperties": false, "properties": { "draft": { "anyOf": [ { "$ref": "#/components/schemas/DraftSummary" }, { "type": "null" } ], "default": null }, "suggestion": { "$ref": "#/components/schemas/ContentReviewSuggestionSummary" } }, "required": [ "suggestion" ], "title": "ReviewSuggestionActionResponse", "type": "object" }, "ReviewSuggestionEditRequest": { "additionalProperties": false, "properties": { "applied_text": { "minLength": 1, "title": "Applied Text", "type": "string" } }, "required": [ "applied_text" ], "title": "ReviewSuggestionEditRequest", "type": "object" }, "ReviewSuggestionStatus": { "enum": [ "PENDING", "ACCEPTED", "REJECTED", "EDITED" ], "title": "ReviewSuggestionStatus", "type": "string" }, "ReviewSummary": { "additionalProperties": false, "properties": { "article_id": { "format": "uuid", "title": "Article Id", "type": "string" }, "created_at": { "format": "date-time", "title": "Created At", "type": "string" }, "id": { "format": "uuid", "title": "Id", "type": "string" }, "notes": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Notes" }, "review_type": { "$ref": "#/components/schemas/ReviewType" }, "reviewer_id": { "anyOf": [ { "format": "uuid", "type": "string" }, { "type": "null" } ], "default": null, "title": "Reviewer Id" }, "status": { "$ref": "#/components/schemas/ReviewStatus" } }, "required": [ "id", "article_id", "review_type", "status", "created_at" ], "title": "ReviewSummary", "type": "object" }, "ReviewType": { "enum": [ "PLAN", "EVIDENCE", "ASSET", "SEO_LANGUAGE", "FINAL" ], "title": "ReviewType", "type": "string" }, "Role": { "enum": [ "ADMIN", "EDITOR" ], "title": "Role", "type": "string" }, "RunnerFileRef": { "additionalProperties": false, "properties": { "content_hash": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Content Hash" }, "path": { "minLength": 1, "title": "Path", "type": "string" } }, "required": [ "path" ], "title": "RunnerFileRef", "type": "object" }, "ScriptConfigVersionCreateRequest": { "additionalProperties": false, "properties": { "activate": { "default": false, "title": "Activate", "type": "boolean" }, "diff": { "additionalProperties": true, "title": "Diff", "type": "object" }, "publishing_yaml": { "minLength": 1, "title": "Publishing Yaml", "type": "string" }, "rollback_target_version_id": { "anyOf": [ { "format": "uuid", "type": "string" }, { "type": "null" } ], "default": null, "title": "Rollback Target Version Id" }, "transform_script": { "minLength": 1, "title": "Transform Script", "type": "string" }, "version": { "anyOf": [ { "minimum": 1, "type": "integer" }, { "type": "null" } ], "default": null, "title": "Version" } }, "required": [ "publishing_yaml", "transform_script" ], "title": "ScriptConfigVersionCreateRequest", "type": "object" }, "ScriptConfigVersionListResponse": { "additionalProperties": false, "properties": { "versions": { "items": { "$ref": "#/components/schemas/ScriptConfigVersionSummary" }, "title": "Versions", "type": "array" } }, "required": [ "versions" ], "title": "ScriptConfigVersionListResponse", "type": "object" }, "ScriptConfigVersionResponse": { "additionalProperties": false, "properties": { "version": { "$ref": "#/components/schemas/ScriptConfigVersionSummary" } }, "required": [ "version" ], "title": "ScriptConfigVersionResponse", "type": "object" }, "ScriptConfigVersionStatus": { "enum": [ "DRAFT", "ACTIVE", "DEPRECATED" ], "title": "ScriptConfigVersionStatus", "type": "string" }, "ScriptConfigVersionSummary": { "additionalProperties": false, "properties": { "activated_at": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ], "default": null, "title": "Activated At" }, "created_at": { "format": "date-time", "title": "Created At", "type": "string" }, "created_by": { "format": "uuid", "title": "Created By", "type": "string" }, "diff": { "additionalProperties": true, "title": "Diff", "type": "object" }, "id": { "format": "uuid", "title": "Id", "type": "string" }, "publishing_yaml_hash": { "minLength": 1, "title": "Publishing Yaml Hash", "type": "string" }, "rollback_target_version_id": { "anyOf": [ { "format": "uuid", "type": "string" }, { "type": "null" } ], "default": null, "title": "Rollback Target Version Id" }, "status": { "$ref": "#/components/schemas/ScriptConfigVersionStatus" }, "target_site_id": { "format": "uuid", "title": "Target Site Id", "type": "string" }, "transform_script_hash": { "minLength": 1, "title": "Transform Script Hash", "type": "string" }, "version": { "minimum": 1, "title": "Version", "type": "integer" } }, "required": [ "id", "target_site_id", "version", "status", "publishing_yaml_hash", "transform_script_hash", "created_by", "created_at" ], "title": "ScriptConfigVersionSummary", "type": "object" }, "SeoReviewReportResponse": { "additionalProperties": false, "properties": { "report": { "$ref": "#/components/schemas/ContentReviewReportSummary" } }, "required": [ "report" ], "title": "SeoReviewReportResponse", "type": "object" }, "SeoReviewRunResponse": { "additionalProperties": false, "properties": { "report": { "$ref": "#/components/schemas/ContentReviewReportSummary" } }, "required": [ "report" ], "title": "SeoReviewRunResponse", "type": "object" }, "TargetSiteConfig": { "additionalProperties": false, "properties": { "active_script_config_version_id": { "anyOf": [ { "format": "uuid", "type": "string" }, { "type": "null" } ], "default": null, "title": "Active Script Config Version Id" }, "audience": { "minLength": 1, "title": "Audience", "type": "string" }, "brand_voice": { "minLength": 1, "title": "Brand Voice", "type": "string" }, "created_at": { "format": "date-time", "title": "Created At", "type": "string" }, "default_language": { "default": "en", "minLength": 2, "title": "Default Language", "type": "string" }, "id": { "format": "uuid", "title": "Id", "type": "string" }, "name": { "minLength": 1, "title": "Name", "type": "string" }, "publishing_rules": { "$ref": "#/components/schemas/PublishingRules" }, "publishing_type": { "default": "git_next", "minLength": 1, "title": "Publishing Type", "type": "string" }, "seo_rules": { "additionalProperties": true, "title": "Seo Rules", "type": "object" }, "slug": { "minLength": 1, "title": "Slug", "type": "string" }, "source_rules": { "additionalProperties": true, "title": "Source Rules", "type": "object" }, "updated_at": { "format": "date-time", "title": "Updated At", "type": "string" }, "visual_rules": { "additionalProperties": true, "title": "Visual Rules", "type": "object" } }, "required": [ "id", "name", "slug", "brand_voice", "audience", "publishing_rules", "created_at", "updated_at" ], "title": "TargetSiteConfig", "type": "object" }, "TargetSiteConfigCreateRequest": { "additionalProperties": false, "properties": { "active_script_config_version_id": { "anyOf": [ { "format": "uuid", "type": "string" }, { "type": "null" } ], "default": null, "title": "Active Script Config Version Id" }, "audience": { "minLength": 1, "title": "Audience", "type": "string" }, "brand_voice": { "minLength": 1, "title": "Brand Voice", "type": "string" }, "default_language": { "default": "en", "minLength": 2, "title": "Default Language", "type": "string" }, "name": { "minLength": 1, "title": "Name", "type": "string" }, "publishing_rules": { "$ref": "#/components/schemas/PublishingRules" }, "publishing_type": { "default": "git_next", "minLength": 1, "title": "Publishing Type", "type": "string" }, "seo_rules": { "additionalProperties": true, "title": "Seo Rules", "type": "object" }, "slug": { "minLength": 1, "title": "Slug", "type": "string" }, "source_rules": { "additionalProperties": true, "title": "Source Rules", "type": "object" }, "visual_rules": { "additionalProperties": true, "title": "Visual Rules", "type": "object" } }, "required": [ "name", "slug", "brand_voice", "audience", "publishing_rules" ], "title": "TargetSiteConfigCreateRequest", "type": "object" }, "TargetSiteConfigResponse": { "additionalProperties": false, "properties": { "site": { "$ref": "#/components/schemas/TargetSiteConfig" } }, "required": [ "site" ], "title": "TargetSiteConfigResponse", "type": "object" }, "TargetSiteConfigUpdateRequest": { "additionalProperties": false, "properties": { "active_script_config_version_id": { "anyOf": [ { "format": "uuid", "type": "string" }, { "type": "null" } ], "default": null, "title": "Active Script Config Version Id" }, "audience": { "anyOf": [ { "minLength": 1, "type": "string" }, { "type": "null" } ], "default": null, "title": "Audience" }, "brand_voice": { "anyOf": [ { "minLength": 1, "type": "string" }, { "type": "null" } ], "default": null, "title": "Brand Voice" }, "default_language": { "anyOf": [ { "minLength": 2, "type": "string" }, { "type": "null" } ], "default": null, "title": "Default Language" }, "name": { "anyOf": [ { "minLength": 1, "type": "string" }, { "type": "null" } ], "default": null, "title": "Name" }, "publishing_rules": { "anyOf": [ { "$ref": "#/components/schemas/PublishingRules" }, { "type": "null" } ], "default": null }, "publishing_type": { "anyOf": [ { "minLength": 1, "type": "string" }, { "type": "null" } ], "default": null, "title": "Publishing Type" }, "seo_rules": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Seo Rules" }, "slug": { "anyOf": [ { "minLength": 1, "type": "string" }, { "type": "null" } ], "default": null, "title": "Slug" }, "source_rules": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Source Rules" }, "visual_rules": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Visual Rules" } }, "title": "TargetSiteConfigUpdateRequest", "type": "object" }, "UserSummary": { "additionalProperties": false, "properties": { "display_name": { "minLength": 1, "title": "Display Name", "type": "string" }, "id": { "format": "uuid", "title": "Id", "type": "string" }, "role": { "$ref": "#/components/schemas/Role" } }, "required": [ "id", "display_name", "role" ], "title": "UserSummary", "type": "object" }, "ValidationError": { "properties": { "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" }, "WorkflowEventSummary": { "additionalProperties": false, "properties": { "actor_user_id": { "anyOf": [ { "format": "uuid", "type": "string" }, { "type": "null" } ], "default": null, "title": "Actor User Id" }, "article_id": { "format": "uuid", "title": "Article Id", "type": "string" }, "created_at": { "format": "date-time", "title": "Created At", "type": "string" }, "event_type": { "minLength": 1, "title": "Event Type", "type": "string" }, "from_status": { "anyOf": [ { "$ref": "#/components/schemas/ArticleWorkflowStatus" }, { "type": "null" } ], "default": null }, "id": { "format": "uuid", "title": "Id", "type": "string" }, "payload": { "additionalProperties": true, "title": "Payload", "type": "object" }, "to_status": { "anyOf": [ { "$ref": "#/components/schemas/ArticleWorkflowStatus" }, { "type": "null" } ], "default": null } }, "required": [ "id", "article_id", "event_type", "created_at" ], "title": "WorkflowEventSummary", "type": "object" } } }, "info": { "title": "AI Content Pipeline Backend", "version": "0.1.0" }, "openapi": "3.1.0", "paths": { "/api/agent-jobs": { "get": { "operationId": "get_agent_jobs_api_agent_jobs_get", "parameters": [ { "in": "header", "name": "X-Demo-User-Email", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Demo-User-Email" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AgentJobListResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Get Agent Jobs", "tags": [ "agent-jobs" ] } }, "/api/agent-jobs/test-codex": { "post": { "operationId": "post_test_codex_job_api_agent_jobs_test_codex_post", "parameters": [ { "in": "header", "name": "X-Demo-User-Email", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Demo-User-Email" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AgentJobTestCodexRequest" } } } }, "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AgentJobResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Post Test Codex Job", "tags": [ "agent-jobs" ] } }, "/api/agent-jobs/{job_id}": { "get": { "operationId": "get_agent_job_route_api_agent_jobs__job_id__get", "parameters": [ { "in": "path", "name": "job_id", "required": true, "schema": { "format": "uuid", "title": "Job Id", "type": "string" } }, { "in": "header", "name": "X-Demo-User-Email", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Demo-User-Email" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AgentJobResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Get Agent Job Route", "tags": [ "agent-jobs" ] } }, "/api/agent-jobs/{job_id}/cancel": { "post": { "operationId": "post_cancel_agent_job_api_agent_jobs__job_id__cancel_post", "parameters": [ { "in": "path", "name": "job_id", "required": true, "schema": { "format": "uuid", "title": "Job Id", "type": "string" } }, { "in": "header", "name": "X-Demo-User-Email", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Demo-User-Email" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AgentJobResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Post Cancel Agent Job", "tags": [ "agent-jobs" ] } }, "/api/agent-jobs/{job_id}/retry": { "post": { "operationId": "post_retry_agent_job_api_agent_jobs__job_id__retry_post", "parameters": [ { "in": "path", "name": "job_id", "required": true, "schema": { "format": "uuid", "title": "Job Id", "type": "string" } }, { "in": "header", "name": "X-Demo-User-Email", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Demo-User-Email" } } ], "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AgentJobResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Post Retry Agent Job", "tags": [ "agent-jobs" ] } }, "/api/articles": { "get": { "operationId": "list_articles_route_api_articles_get", "parameters": [ { "in": "header", "name": "X-Demo-User-Email", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Demo-User-Email" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ArticleListResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "List Articles Route", "tags": [ "articles" ] }, "post": { "operationId": "post_article_api_articles_post", "parameters": [ { "in": "header", "name": "X-Demo-User-Email", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Demo-User-Email" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ArticleCreateRequest" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ArticleCreateResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Post Article", "tags": [ "articles" ] } }, "/api/articles/{article_id}": { "get": { "operationId": "get_article_api_articles__article_id__get", "parameters": [ { "in": "path", "name": "article_id", "required": true, "schema": { "format": "uuid", "title": "Article Id", "type": "string" } }, { "in": "header", "name": "X-Demo-User-Email", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Demo-User-Email" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ArticleDetailResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Get Article", "tags": [ "articles" ] } }, "/api/articles/{article_id}/assets": { "get": { "operationId": "get_article_assets_api_articles__article_id__assets_get", "parameters": [ { "in": "path", "name": "article_id", "required": true, "schema": { "format": "uuid", "title": "Article Id", "type": "string" } }, { "in": "header", "name": "X-Demo-User-Email", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Demo-User-Email" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AssetListResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Get Article Assets", "tags": [ "assets" ] } }, "/api/articles/{article_id}/assets/generate-specs": { "post": { "operationId": "post_generate_asset_specs_api_articles__article_id__assets_generate_specs_post", "parameters": [ { "in": "path", "name": "article_id", "required": true, "schema": { "format": "uuid", "title": "Article Id", "type": "string" } }, { "in": "header", "name": "X-Demo-User-Email", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Demo-User-Email" } } ], "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AssetGenerateSpecsResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Post Generate Asset Specs", "tags": [ "assets" ] } }, "/api/articles/{article_id}/assets/{asset_id}": { "patch": { "operationId": "patch_article_asset_api_articles__article_id__assets__asset_id__patch", "parameters": [ { "in": "path", "name": "article_id", "required": true, "schema": { "format": "uuid", "title": "Article Id", "type": "string" } }, { "in": "path", "name": "asset_id", "required": true, "schema": { "format": "uuid", "title": "Asset Id", "type": "string" } }, { "in": "header", "name": "X-Demo-User-Email", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Demo-User-Email" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AssetUpdateRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AssetResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Patch Article Asset", "tags": [ "assets" ] } }, "/api/articles/{article_id}/assets/{asset_id}/approve": { "post": { "operationId": "post_approve_asset_api_articles__article_id__assets__asset_id__approve_post", "parameters": [ { "in": "path", "name": "article_id", "required": true, "schema": { "format": "uuid", "title": "Article Id", "type": "string" } }, { "in": "path", "name": "asset_id", "required": true, "schema": { "format": "uuid", "title": "Asset Id", "type": "string" } }, { "in": "header", "name": "X-Demo-User-Email", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Demo-User-Email" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AssetResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Post Approve Asset", "tags": [ "assets" ] } }, "/api/articles/{article_id}/assets/{asset_id}/upload": { "post": { "operationId": "post_upload_asset_file_api_articles__article_id__assets__asset_id__upload_post", "parameters": [ { "in": "path", "name": "article_id", "required": true, "schema": { "format": "uuid", "title": "Article Id", "type": "string" } }, { "in": "path", "name": "asset_id", "required": true, "schema": { "format": "uuid", "title": "Asset Id", "type": "string" } }, { "in": "header", "name": "X-Demo-User-Email", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Demo-User-Email" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AssetUploadRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AssetUploadResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Post Upload Asset File", "tags": [ "assets" ] } }, "/api/articles/{article_id}/boundary-questions": { "get": { "operationId": "get_boundary_questions_api_articles__article_id__boundary_questions_get", "parameters": [ { "in": "path", "name": "article_id", "required": true, "schema": { "format": "uuid", "title": "Article Id", "type": "string" } }, { "in": "header", "name": "X-Demo-User-Email", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Demo-User-Email" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BoundaryQuestionListResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Get Boundary Questions", "tags": [ "boundary-questions" ] } }, "/api/articles/{article_id}/boundary-questions/generate": { "post": { "operationId": "post_generate_boundary_questions_api_articles__article_id__boundary_questions_generate_post", "parameters": [ { "in": "path", "name": "article_id", "required": true, "schema": { "format": "uuid", "title": "Article Id", "type": "string" } }, { "in": "header", "name": "X-Demo-User-Email", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Demo-User-Email" } } ], "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BoundaryQuestionListResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Post Generate Boundary Questions", "tags": [ "boundary-questions" ] } }, "/api/articles/{article_id}/boundary-questions/submit": { "post": { "operationId": "post_submit_boundary_questions_api_articles__article_id__boundary_questions_submit_post", "parameters": [ { "in": "path", "name": "article_id", "required": true, "schema": { "format": "uuid", "title": "Article Id", "type": "string" } }, { "in": "header", "name": "X-Demo-User-Email", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Demo-User-Email" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ArticleCreateResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Post Submit Boundary Questions", "tags": [ "boundary-questions" ] } }, "/api/articles/{article_id}/boundary-questions/{question_id}": { "patch": { "operationId": "patch_boundary_question_api_articles__article_id__boundary_questions__question_id__patch", "parameters": [ { "in": "path", "name": "article_id", "required": true, "schema": { "format": "uuid", "title": "Article Id", "type": "string" } }, { "in": "path", "name": "question_id", "required": true, "schema": { "format": "uuid", "title": "Question Id", "type": "string" } }, { "in": "header", "name": "X-Demo-User-Email", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Demo-User-Email" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BoundaryQuestionUpdateRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BoundaryQuestionResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Patch Boundary Question", "tags": [ "boundary-questions" ] } }, "/api/articles/{article_id}/draft/assemble": { "post": { "operationId": "post_assemble_draft_api_articles__article_id__draft_assemble_post", "parameters": [ { "in": "path", "name": "article_id", "required": true, "schema": { "format": "uuid", "title": "Article Id", "type": "string" } }, { "in": "header", "name": "X-Demo-User-Email", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Demo-User-Email" } } ], "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DraftAssembleResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Post Assemble Draft", "tags": [ "drafts" ] } }, "/api/articles/{article_id}/draft/start": { "post": { "operationId": "post_start_draft_api_articles__article_id__draft_start_post", "parameters": [ { "in": "path", "name": "article_id", "required": true, "schema": { "format": "uuid", "title": "Article Id", "type": "string" } }, { "in": "header", "name": "X-Demo-User-Email", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Demo-User-Email" } } ], "responses": { "202": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AgentJobListResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Post Start Draft", "tags": [ "evidence" ] } }, "/api/articles/{article_id}/drafts": { "get": { "operationId": "get_article_drafts_api_articles__article_id__drafts_get", "parameters": [ { "in": "path", "name": "article_id", "required": true, "schema": { "format": "uuid", "title": "Article Id", "type": "string" } }, { "in": "header", "name": "X-Demo-User-Email", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Demo-User-Email" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DraftListResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Get Article Drafts", "tags": [ "drafts" ] } }, "/api/articles/{article_id}/drafts/{draft_id}": { "get": { "operationId": "get_article_draft_api_articles__article_id__drafts__draft_id__get", "parameters": [ { "in": "path", "name": "article_id", "required": true, "schema": { "format": "uuid", "title": "Article Id", "type": "string" } }, { "in": "path", "name": "draft_id", "required": true, "schema": { "format": "uuid", "title": "Draft Id", "type": "string" } }, { "in": "header", "name": "X-Demo-User-Email", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Demo-User-Email" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DraftResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Get Article Draft", "tags": [ "drafts" ] }, "patch": { "operationId": "patch_article_draft_api_articles__article_id__drafts__draft_id__patch", "parameters": [ { "in": "path", "name": "article_id", "required": true, "schema": { "format": "uuid", "title": "Article Id", "type": "string" } }, { "in": "path", "name": "draft_id", "required": true, "schema": { "format": "uuid", "title": "Draft Id", "type": "string" } }, { "in": "header", "name": "X-Demo-User-Email", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Demo-User-Email" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DraftUpdateRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DraftResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Patch Article Draft", "tags": [ "drafts" ] } }, "/api/articles/{article_id}/evidence": { "get": { "operationId": "get_article_evidence_api_articles__article_id__evidence_get", "parameters": [ { "in": "path", "name": "article_id", "required": true, "schema": { "format": "uuid", "title": "Article Id", "type": "string" } }, { "in": "header", "name": "X-Demo-User-Email", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Demo-User-Email" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EvidenceMatrixResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Get Article Evidence", "tags": [ "evidence" ] }, "post": { "operationId": "post_evidence_api_articles__article_id__evidence_post", "parameters": [ { "in": "path", "name": "article_id", "required": true, "schema": { "format": "uuid", "title": "Article Id", "type": "string" } }, { "in": "header", "name": "X-Demo-User-Email", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Demo-User-Email" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EvidenceCreateRequest" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EvidenceResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Post Evidence", "tags": [ "evidence" ] } }, "/api/articles/{article_id}/evidence/{evidence_id}": { "delete": { "operationId": "delete_evidence_api_articles__article_id__evidence__evidence_id__delete", "parameters": [ { "in": "path", "name": "article_id", "required": true, "schema": { "format": "uuid", "title": "Article Id", "type": "string" } }, { "in": "path", "name": "evidence_id", "required": true, "schema": { "format": "uuid", "title": "Evidence Id", "type": "string" } }, { "in": "header", "name": "X-Demo-User-Email", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Demo-User-Email" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "title": "Response Delete Evidence Api Articles Article Id Evidence Evidence Id Delete", "type": "null" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Delete Evidence", "tags": [ "evidence" ] }, "patch": { "operationId": "patch_evidence_api_articles__article_id__evidence__evidence_id__patch", "parameters": [ { "in": "path", "name": "article_id", "required": true, "schema": { "format": "uuid", "title": "Article Id", "type": "string" } }, { "in": "path", "name": "evidence_id", "required": true, "schema": { "format": "uuid", "title": "Evidence Id", "type": "string" } }, { "in": "header", "name": "X-Demo-User-Email", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Demo-User-Email" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EvidenceUpdateRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EvidenceResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Patch Evidence", "tags": [ "evidence" ] } }, "/api/articles/{article_id}/final-approval": { "post": { "operationId": "post_article_final_approval_api_articles__article_id__final_approval_post", "parameters": [ { "in": "path", "name": "article_id", "required": true, "schema": { "format": "uuid", "title": "Article Id", "type": "string" } }, { "in": "header", "name": "X-Demo-User-Email", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Demo-User-Email" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FinalApprovalRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FinalApprovalResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Post Article Final Approval", "tags": [ "final-approval" ] } }, "/api/articles/{article_id}/final-approval/checklist": { "get": { "operationId": "get_article_final_approval_checklist_api_articles__article_id__final_approval_checklist_get", "parameters": [ { "in": "path", "name": "article_id", "required": true, "schema": { "format": "uuid", "title": "Article Id", "type": "string" } }, { "in": "header", "name": "X-Demo-User-Email", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Demo-User-Email" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FinalApprovalChecklistResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Get Article Final Approval Checklist", "tags": [ "final-approval" ] } }, "/api/articles/{article_id}/final-review/issues": { "get": { "operationId": "get_article_final_review_issues_api_articles__article_id__final_review_issues_get", "parameters": [ { "in": "path", "name": "article_id", "required": true, "schema": { "format": "uuid", "title": "Article Id", "type": "string" } }, { "in": "header", "name": "X-Demo-User-Email", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Demo-User-Email" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FinalReviewIssuesResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Get Article Final Review Issues", "tags": [ "reviews" ] } }, "/api/articles/{article_id}/final-revision-request": { "post": { "operationId": "post_article_final_revision_request_api_articles__article_id__final_revision_request_post", "parameters": [ { "in": "path", "name": "article_id", "required": true, "schema": { "format": "uuid", "title": "Article Id", "type": "string" } }, { "in": "header", "name": "X-Demo-User-Email", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Demo-User-Email" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FinalRevisionRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FinalRevisionRequestResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Post Article Final Revision Request", "tags": [ "final-approval" ] } }, "/api/articles/{article_id}/final/approve": { "post": { "operationId": "post_final_approve_api_articles__article_id__final_approve_post", "parameters": [ { "in": "path", "name": "article_id", "required": true, "schema": { "format": "uuid", "title": "Article Id", "type": "string" } }, { "in": "header", "name": "X-Demo-User-Email", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Demo-User-Email" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ArticleCreateResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Post Final Approve", "tags": [ "evidence" ] } }, "/api/articles/{article_id}/language/report": { "get": { "operationId": "get_article_language_report_api_articles__article_id__language_report_get", "parameters": [ { "in": "path", "name": "article_id", "required": true, "schema": { "format": "uuid", "title": "Article Id", "type": "string" } }, { "in": "header", "name": "X-Demo-User-Email", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Demo-User-Email" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LanguageReviewReportResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Get Article Language Report", "tags": [ "reviews" ] } }, "/api/articles/{article_id}/language/review": { "post": { "operationId": "post_run_language_review_api_articles__article_id__language_review_post", "parameters": [ { "in": "path", "name": "article_id", "required": true, "schema": { "format": "uuid", "title": "Article Id", "type": "string" } }, { "in": "header", "name": "X-Demo-User-Email", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Demo-User-Email" } } ], "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LanguageReviewRunResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Post Run Language Review", "tags": [ "reviews" ] } }, "/api/articles/{article_id}/language/suggestions/{suggestion_id}/accept": { "post": { "operationId": "post_accept_language_suggestion_api_articles__article_id__language_suggestions__suggestion_id__accept_post", "parameters": [ { "in": "path", "name": "article_id", "required": true, "schema": { "format": "uuid", "title": "Article Id", "type": "string" } }, { "in": "path", "name": "suggestion_id", "required": true, "schema": { "format": "uuid", "title": "Suggestion Id", "type": "string" } }, { "in": "header", "name": "X-Demo-User-Email", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Demo-User-Email" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReviewSuggestionActionResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Post Accept Language Suggestion", "tags": [ "reviews" ] } }, "/api/articles/{article_id}/language/suggestions/{suggestion_id}/edit": { "post": { "operationId": "post_edit_language_suggestion_api_articles__article_id__language_suggestions__suggestion_id__edit_post", "parameters": [ { "in": "path", "name": "article_id", "required": true, "schema": { "format": "uuid", "title": "Article Id", "type": "string" } }, { "in": "path", "name": "suggestion_id", "required": true, "schema": { "format": "uuid", "title": "Suggestion Id", "type": "string" } }, { "in": "header", "name": "X-Demo-User-Email", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Demo-User-Email" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReviewSuggestionEditRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReviewSuggestionActionResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Post Edit Language Suggestion", "tags": [ "reviews" ] } }, "/api/articles/{article_id}/language/suggestions/{suggestion_id}/reject": { "post": { "operationId": "post_reject_language_suggestion_api_articles__article_id__language_suggestions__suggestion_id__reject_post", "parameters": [ { "in": "path", "name": "article_id", "required": true, "schema": { "format": "uuid", "title": "Article Id", "type": "string" } }, { "in": "path", "name": "suggestion_id", "required": true, "schema": { "format": "uuid", "title": "Suggestion Id", "type": "string" } }, { "in": "header", "name": "X-Demo-User-Email", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Demo-User-Email" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReviewSuggestionActionResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Post Reject Language Suggestion", "tags": [ "reviews" ] } }, "/api/articles/{article_id}/plan/generate": { "post": { "operationId": "post_generate_plan_api_articles__article_id__plan_generate_post", "parameters": [ { "in": "path", "name": "article_id", "required": true, "schema": { "format": "uuid", "title": "Article Id", "type": "string" } }, { "in": "header", "name": "X-Demo-User-Email", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Demo-User-Email" } } ], "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PlanResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Post Generate Plan", "tags": [ "plans" ] } }, "/api/articles/{article_id}/plans": { "get": { "operationId": "get_plans_api_articles__article_id__plans_get", "parameters": [ { "in": "path", "name": "article_id", "required": true, "schema": { "format": "uuid", "title": "Article Id", "type": "string" } }, { "in": "header", "name": "X-Demo-User-Email", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Demo-User-Email" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PlanListResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Get Plans", "tags": [ "plans" ] } }, "/api/articles/{article_id}/plans/generate": { "post": { "operationId": "post_generate_plan_api_articles__article_id__plans_generate_post", "parameters": [ { "in": "path", "name": "article_id", "required": true, "schema": { "format": "uuid", "title": "Article Id", "type": "string" } }, { "in": "header", "name": "X-Demo-User-Email", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Demo-User-Email" } } ], "responses": { "202": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AgentJobListResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Post Generate Plan", "tags": [ "boundary-questions" ] } }, "/api/articles/{article_id}/plans/{plan_id}": { "get": { "operationId": "get_plan_route_api_articles__article_id__plans__plan_id__get", "parameters": [ { "in": "path", "name": "article_id", "required": true, "schema": { "format": "uuid", "title": "Article Id", "type": "string" } }, { "in": "path", "name": "plan_id", "required": true, "schema": { "format": "uuid", "title": "Plan Id", "type": "string" } }, { "in": "header", "name": "X-Demo-User-Email", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Demo-User-Email" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PlanResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Get Plan Route", "tags": [ "plans" ] }, "patch": { "operationId": "patch_plan_api_articles__article_id__plans__plan_id__patch", "parameters": [ { "in": "path", "name": "article_id", "required": true, "schema": { "format": "uuid", "title": "Article Id", "type": "string" } }, { "in": "path", "name": "plan_id", "required": true, "schema": { "format": "uuid", "title": "Plan Id", "type": "string" } }, { "in": "header", "name": "X-Demo-User-Email", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Demo-User-Email" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PlanUpdateRequest" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PlanResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Patch Plan", "tags": [ "plans" ] } }, "/api/articles/{article_id}/plans/{plan_id}/approve": { "post": { "operationId": "post_approve_plan_api_articles__article_id__plans__plan_id__approve_post", "parameters": [ { "in": "path", "name": "article_id", "required": true, "schema": { "format": "uuid", "title": "Article Id", "type": "string" } }, { "in": "path", "name": "plan_id", "required": true, "schema": { "format": "uuid", "title": "Plan Id", "type": "string" } }, { "in": "header", "name": "X-Demo-User-Email", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Demo-User-Email" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReviewActionResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Post Approve Plan", "tags": [ "plans" ] } }, "/api/articles/{article_id}/plans/{plan_id}/request-revision": { "post": { "operationId": "post_request_plan_revision_api_articles__article_id__plans__plan_id__request_revision_post", "parameters": [ { "in": "path", "name": "article_id", "required": true, "schema": { "format": "uuid", "title": "Article Id", "type": "string" } }, { "in": "path", "name": "plan_id", "required": true, "schema": { "format": "uuid", "title": "Plan Id", "type": "string" } }, { "in": "header", "name": "X-Demo-User-Email", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Demo-User-Email" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PlanRevisionRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReviewActionResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Post Request Plan Revision", "tags": [ "plans" ] } }, "/api/articles/{article_id}/research": { "get": { "operationId": "get_research_api_articles__article_id__research_get", "parameters": [ { "in": "path", "name": "article_id", "required": true, "schema": { "format": "uuid", "title": "Article Id", "type": "string" } }, { "in": "header", "name": "X-Demo-User-Email", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Demo-User-Email" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResearchListResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Get Research", "tags": [ "plans" ] } }, "/api/articles/{article_id}/research/start": { "post": { "operationId": "post_start_research_api_articles__article_id__research_start_post", "parameters": [ { "in": "path", "name": "article_id", "required": true, "schema": { "format": "uuid", "title": "Article Id", "type": "string" } }, { "in": "header", "name": "X-Demo-User-Email", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Demo-User-Email" } } ], "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResearchStartResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Post Start Research", "tags": [ "plans" ] } }, "/api/articles/{article_id}/seo/report": { "get": { "operationId": "get_article_seo_report_api_articles__article_id__seo_report_get", "parameters": [ { "in": "path", "name": "article_id", "required": true, "schema": { "format": "uuid", "title": "Article Id", "type": "string" } }, { "in": "header", "name": "X-Demo-User-Email", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Demo-User-Email" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeoReviewReportResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Get Article Seo Report", "tags": [ "reviews" ] } }, "/api/articles/{article_id}/seo/review": { "post": { "operationId": "post_run_seo_review_api_articles__article_id__seo_review_post", "parameters": [ { "in": "path", "name": "article_id", "required": true, "schema": { "format": "uuid", "title": "Article Id", "type": "string" } }, { "in": "header", "name": "X-Demo-User-Email", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Demo-User-Email" } } ], "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SeoReviewRunResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Post Run Seo Review", "tags": [ "reviews" ] } }, "/api/articles/{article_id}/seo/suggestions/{suggestion_id}/accept": { "post": { "operationId": "post_accept_seo_suggestion_api_articles__article_id__seo_suggestions__suggestion_id__accept_post", "parameters": [ { "in": "path", "name": "article_id", "required": true, "schema": { "format": "uuid", "title": "Article Id", "type": "string" } }, { "in": "path", "name": "suggestion_id", "required": true, "schema": { "format": "uuid", "title": "Suggestion Id", "type": "string" } }, { "in": "header", "name": "X-Demo-User-Email", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Demo-User-Email" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReviewSuggestionActionResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Post Accept Seo Suggestion", "tags": [ "reviews" ] } }, "/api/articles/{article_id}/seo/suggestions/{suggestion_id}/edit": { "post": { "operationId": "post_edit_seo_suggestion_api_articles__article_id__seo_suggestions__suggestion_id__edit_post", "parameters": [ { "in": "path", "name": "article_id", "required": true, "schema": { "format": "uuid", "title": "Article Id", "type": "string" } }, { "in": "path", "name": "suggestion_id", "required": true, "schema": { "format": "uuid", "title": "Suggestion Id", "type": "string" } }, { "in": "header", "name": "X-Demo-User-Email", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Demo-User-Email" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReviewSuggestionEditRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReviewSuggestionActionResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Post Edit Seo Suggestion", "tags": [ "reviews" ] } }, "/api/articles/{article_id}/seo/suggestions/{suggestion_id}/reject": { "post": { "operationId": "post_reject_seo_suggestion_api_articles__article_id__seo_suggestions__suggestion_id__reject_post", "parameters": [ { "in": "path", "name": "article_id", "required": true, "schema": { "format": "uuid", "title": "Article Id", "type": "string" } }, { "in": "path", "name": "suggestion_id", "required": true, "schema": { "format": "uuid", "title": "Suggestion Id", "type": "string" } }, { "in": "header", "name": "X-Demo-User-Email", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Demo-User-Email" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReviewSuggestionActionResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Post Reject Seo Suggestion", "tags": [ "reviews" ] } }, "/api/me": { "get": { "operationId": "get_me_api_me_get", "parameters": [ { "in": "header", "name": "X-Demo-User-Email", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Demo-User-Email" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CurrentUserResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Get Me", "tags": [ "auth" ] } }, "/api/sites": { "get": { "operationId": "list_sites_api_sites_get", "parameters": [ { "in": "header", "name": "X-Demo-User-Email", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Demo-User-Email" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "items": { "$ref": "#/components/schemas/TargetSiteConfigResponse" }, "title": "Response List Sites Api Sites Get", "type": "array" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "List Sites", "tags": [ "sites" ] }, "post": { "operationId": "post_site_api_sites_post", "parameters": [ { "in": "header", "name": "X-Demo-User-Email", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Demo-User-Email" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TargetSiteConfigCreateRequest" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TargetSiteConfigResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Post Site", "tags": [ "sites" ] } }, "/api/sites/{site_id}": { "get": { "operationId": "get_site_api_sites__site_id__get", "parameters": [ { "in": "path", "name": "site_id", "required": true, "schema": { "format": "uuid", "title": "Site Id", "type": "string" } }, { "in": "header", "name": "X-Demo-User-Email", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Demo-User-Email" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TargetSiteConfigResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Get Site", "tags": [ "sites" ] }, "patch": { "operationId": "patch_site_api_sites__site_id__patch", "parameters": [ { "in": "path", "name": "site_id", "required": true, "schema": { "format": "uuid", "title": "Site Id", "type": "string" } }, { "in": "header", "name": "X-Demo-User-Email", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Demo-User-Email" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TargetSiteConfigUpdateRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TargetSiteConfigResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Patch Site", "tags": [ "sites" ] } }, "/api/sites/{site_id}/publishing-config/versions": { "get": { "operationId": "get_script_config_versions_api_sites__site_id__publishing_config_versions_get", "parameters": [ { "in": "path", "name": "site_id", "required": true, "schema": { "format": "uuid", "title": "Site Id", "type": "string" } }, { "in": "header", "name": "X-Demo-User-Email", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Demo-User-Email" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ScriptConfigVersionListResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Get Script Config Versions", "tags": [ "sites" ] }, "post": { "operationId": "post_script_config_version_api_sites__site_id__publishing_config_versions_post", "parameters": [ { "in": "path", "name": "site_id", "required": true, "schema": { "format": "uuid", "title": "Site Id", "type": "string" } }, { "in": "header", "name": "X-Demo-User-Email", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Demo-User-Email" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ScriptConfigVersionCreateRequest" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ScriptConfigVersionResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Post Script Config Version", "tags": [ "sites" ] } }, "/api/sites/{site_id}/publishing-config/versions/{version_id}/activate": { "post": { "operationId": "post_activate_script_config_version_api_sites__site_id__publishing_config_versions__version_id__activate_post", "parameters": [ { "in": "path", "name": "site_id", "required": true, "schema": { "format": "uuid", "title": "Site Id", "type": "string" } }, { "in": "path", "name": "version_id", "required": true, "schema": { "format": "uuid", "title": "Version Id", "type": "string" } }, { "in": "header", "name": "X-Demo-User-Email", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Demo-User-Email" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ScriptConfigVersionResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Post Activate Script Config Version", "tags": [ "sites" ] } }, "/api/sites/{site_id}/publishing-config/versions/{version_id}/rollback": { "post": { "operationId": "post_rollback_script_config_version_api_sites__site_id__publishing_config_versions__version_id__rollback_post", "parameters": [ { "in": "path", "name": "site_id", "required": true, "schema": { "format": "uuid", "title": "Site Id", "type": "string" } }, { "in": "path", "name": "version_id", "required": true, "schema": { "format": "uuid", "title": "Version Id", "type": "string" } }, { "in": "header", "name": "X-Demo-User-Email", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Demo-User-Email" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ScriptConfigVersionResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Post Rollback Script Config Version", "tags": [ "sites" ] } }, "/health": { "get": { "operationId": "health_health_get", "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": { "type": "string" }, "title": "Response Health Health Get", "type": "object" } } }, "description": "Successful Response" } }, "summary": "Health" } }, "/health/dependencies": { "get": { "operationId": "dependency_health_health_dependencies_get", "responses": { "200": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" } }, "summary": "Dependency Health" } } } }