Files
content-factory/packages/shared/openapi.json
T

10207 lines
256 KiB
JSON

{
"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"
},
"cancel_eligible": {
"default": false,
"title": "Cancel Eligible",
"type": "boolean"
},
"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"
},
"retry_block_reason": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Retry Block Reason"
},
"retry_eligible": {
"default": false,
"title": "Retry Eligible",
"type": "boolean"
},
"safe_failure_summary": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Safe Failure Summary"
},
"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"
},
"workflow_template_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Workflow Template Id"
},
"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
},
"timeline": {
"items": {
"$ref": "#/components/schemas/ObservabilityTimelineEventSummary"
},
"title": "Timeline",
"type": "array"
},
"workflow_events": {
"items": {
"$ref": "#/components/schemas/WorkflowEventSummary"
},
"title": "Workflow Events",
"type": "array"
},
"workflow_template_snapshot": {
"anyOf": [
{
"$ref": "#/components/schemas/WorkflowTemplateSnapshot"
},
{
"type": "null"
}
],
"default": null
}
},
"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"
},
"workflow_template_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Workflow Template Id"
},
"workflow_template_version": {
"anyOf": [
{
"minimum": 1,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Workflow Template Version"
},
"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"
},
"ObservabilityTimelineEventSummary": {
"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"
},
"cancel_eligible": {
"default": false,
"title": "Cancel Eligible",
"type": "boolean"
},
"created_at": {
"format": "date-time",
"title": "Created At",
"type": "string"
},
"entry_type": {
"minLength": 1,
"title": "Entry Type",
"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"
},
"job_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Job Id"
},
"job_status": {
"anyOf": [
{
"$ref": "#/components/schemas/AgentJobStatus"
},
{
"type": "null"
}
],
"default": null
},
"job_type": {
"anyOf": [
{
"$ref": "#/components/schemas/AgentJobType"
},
{
"type": "null"
}
],
"default": null
},
"payload": {
"additionalProperties": true,
"title": "Payload",
"type": "object"
},
"retry_eligible": {
"default": false,
"title": "Retry Eligible",
"type": "boolean"
},
"safe_failure_summary": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Safe Failure Summary"
},
"source": {
"minLength": 1,
"title": "Source",
"type": "string"
},
"to_status": {
"anyOf": [
{
"$ref": "#/components/schemas/ArticleWorkflowStatus"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"id",
"article_id",
"entry_type",
"source",
"event_type",
"created_at"
],
"title": "ObservabilityTimelineEventSummary",
"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"
},
"PublishCommitCreateResponse": {
"additionalProperties": false,
"properties": {
"article": {
"$ref": "#/components/schemas/ArticleSummary"
},
"publish_commit": {
"$ref": "#/components/schemas/PublishCommitSummary"
}
},
"required": [
"article",
"publish_commit"
],
"title": "PublishCommitCreateResponse",
"type": "object"
},
"PublishCommitListResponse": {
"additionalProperties": false,
"properties": {
"commits": {
"items": {
"$ref": "#/components/schemas/PublishCommitSummary"
},
"title": "Commits",
"type": "array"
}
},
"title": "PublishCommitListResponse",
"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"
},
"PublishingDryRunResponse": {
"additionalProperties": false,
"properties": {
"article": {
"$ref": "#/components/schemas/ArticleSummary"
},
"content_shape_valid": {
"title": "Content Shape Valid",
"type": "boolean"
},
"errors": {
"items": {
"type": "string"
},
"title": "Errors",
"type": "array"
},
"publish_commit": {
"$ref": "#/components/schemas/PublishCommitSummary"
},
"validation_label": {
"minLength": 1,
"title": "Validation Label",
"type": "string"
}
},
"required": [
"article",
"publish_commit",
"content_shape_valid",
"validation_label"
],
"title": "PublishingDryRunResponse",
"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"
},
"PublishingStatusResponse": {
"additionalProperties": false,
"properties": {
"article": {
"$ref": "#/components/schemas/ArticleSummary"
},
"latest_dry_run": {
"anyOf": [
{
"$ref": "#/components/schemas/PublishCommitSummary"
},
{
"type": "null"
}
],
"default": null
},
"latest_publish_commit": {
"anyOf": [
{
"$ref": "#/components/schemas/PublishCommitSummary"
},
{
"type": "null"
}
],
"default": null
},
"validation_label": {
"minLength": 1,
"title": "Validation Label",
"type": "string"
}
},
"required": [
"article",
"validation_label"
],
"title": "PublishingStatusResponse",
"type": "object"
},
"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"
},
"ScriptConfigVersionAuditEventListResponse": {
"additionalProperties": false,
"properties": {
"events": {
"items": {
"$ref": "#/components/schemas/ScriptConfigVersionAuditEventSummary"
},
"title": "Events",
"type": "array"
}
},
"title": "ScriptConfigVersionAuditEventListResponse",
"type": "object"
},
"ScriptConfigVersionAuditEventSummary": {
"additionalProperties": false,
"properties": {
"actor_user_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Actor User Id"
},
"created_at": {
"format": "date-time",
"title": "Created At",
"type": "string"
},
"diff": {
"additionalProperties": true,
"title": "Diff",
"type": "object"
},
"event_type": {
"minLength": 1,
"title": "Event Type",
"type": "string"
},
"id": {
"format": "uuid",
"title": "Id",
"type": "string"
},
"payload": {
"additionalProperties": true,
"title": "Payload",
"type": "object"
},
"rollback_target_version_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Rollback Target Version Id"
},
"target_site_id": {
"format": "uuid",
"title": "Target Site Id",
"type": "string"
},
"version": {
"anyOf": [
{
"minimum": 1,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Version"
},
"version_id": {
"format": "uuid",
"title": "Version Id",
"type": "string"
}
},
"required": [
"id",
"target_site_id",
"version_id",
"event_type",
"created_at"
],
"title": "ScriptConfigVersionAuditEventSummary",
"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"
},
"WorkflowStageCreateRequest": {
"additionalProperties": false,
"properties": {
"acceptance_criteria": {
"items": {
"type": "string"
},
"title": "Acceptance Criteria",
"type": "array"
},
"description": {
"minLength": 1,
"title": "Description",
"type": "string"
},
"display_name": {
"minLength": 1,
"title": "Display Name",
"type": "string"
},
"expected_outputs": {
"items": {
"type": "string"
},
"title": "Expected Outputs",
"type": "array"
},
"owner_role": {
"$ref": "#/components/schemas/Role"
},
"parts": {
"items": {
"$ref": "#/components/schemas/WorkflowStagePart"
},
"title": "Parts",
"type": "array"
},
"position": {
"anyOf": [
{
"minimum": 1,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Position"
},
"required_inputs": {
"items": {
"type": "string"
},
"title": "Required Inputs",
"type": "array"
},
"requires_human_approval": {
"default": false,
"title": "Requires Human Approval",
"type": "boolean"
},
"retry_policy": {
"additionalProperties": true,
"title": "Retry Policy",
"type": "object"
},
"runner_profile_key": {
"minLength": 1,
"title": "Runner Profile Key",
"type": "string"
},
"stable_key": {
"minLength": 1,
"title": "Stable Key",
"type": "string"
}
},
"required": [
"stable_key",
"display_name",
"description",
"owner_role",
"runner_profile_key"
],
"title": "WorkflowStageCreateRequest",
"type": "object"
},
"WorkflowStagePart": {
"additionalProperties": false,
"properties": {
"acceptance_criteria": {
"items": {
"type": "string"
},
"title": "Acceptance Criteria",
"type": "array"
},
"key": {
"minLength": 1,
"title": "Key",
"type": "string"
},
"payload": {
"additionalProperties": true,
"title": "Payload",
"type": "object"
},
"title": {
"minLength": 1,
"title": "Title",
"type": "string"
},
"type": {
"minLength": 1,
"title": "Type",
"type": "string"
}
},
"required": [
"key",
"type",
"title"
],
"title": "WorkflowStagePart",
"type": "object"
},
"WorkflowStageReorderRequest": {
"additionalProperties": false,
"properties": {
"stage_ids": {
"items": {
"format": "uuid",
"type": "string"
},
"minItems": 1,
"title": "Stage Ids",
"type": "array"
}
},
"required": [
"stage_ids"
],
"title": "WorkflowStageReorderRequest",
"type": "object"
},
"WorkflowStageResponse": {
"additionalProperties": false,
"properties": {
"stage": {
"$ref": "#/components/schemas/WorkflowStageSummary"
}
},
"required": [
"stage"
],
"title": "WorkflowStageResponse",
"type": "object"
},
"WorkflowStageSummary": {
"additionalProperties": false,
"properties": {
"acceptance_criteria": {
"items": {
"type": "string"
},
"title": "Acceptance Criteria",
"type": "array"
},
"created_at": {
"format": "date-time",
"title": "Created At",
"type": "string"
},
"description": {
"minLength": 1,
"title": "Description",
"type": "string"
},
"display_name": {
"minLength": 1,
"title": "Display Name",
"type": "string"
},
"expected_outputs": {
"items": {
"type": "string"
},
"title": "Expected Outputs",
"type": "array"
},
"id": {
"format": "uuid",
"title": "Id",
"type": "string"
},
"owner_role": {
"$ref": "#/components/schemas/Role"
},
"parts": {
"items": {
"$ref": "#/components/schemas/WorkflowStagePart"
},
"title": "Parts",
"type": "array"
},
"position": {
"minimum": 1,
"title": "Position",
"type": "integer"
},
"required_inputs": {
"items": {
"type": "string"
},
"title": "Required Inputs",
"type": "array"
},
"requires_human_approval": {
"default": false,
"title": "Requires Human Approval",
"type": "boolean"
},
"retry_policy": {
"additionalProperties": true,
"title": "Retry Policy",
"type": "object"
},
"runner_profile_key": {
"minLength": 1,
"title": "Runner Profile Key",
"type": "string"
},
"stable_key": {
"minLength": 1,
"title": "Stable Key",
"type": "string"
},
"updated_at": {
"format": "date-time",
"title": "Updated At",
"type": "string"
},
"workflow_id": {
"format": "uuid",
"title": "Workflow Id",
"type": "string"
}
},
"required": [
"id",
"workflow_id",
"stable_key",
"display_name",
"description",
"position",
"owner_role",
"runner_profile_key",
"created_at",
"updated_at"
],
"title": "WorkflowStageSummary",
"type": "object"
},
"WorkflowStageUpdateRequest": {
"additionalProperties": false,
"properties": {
"acceptance_criteria": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Acceptance Criteria"
},
"description": {
"anyOf": [
{
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Description"
},
"display_name": {
"anyOf": [
{
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Display Name"
},
"expected_outputs": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Expected Outputs"
},
"owner_role": {
"anyOf": [
{
"$ref": "#/components/schemas/Role"
},
{
"type": "null"
}
],
"default": null
},
"parts": {
"anyOf": [
{
"items": {
"$ref": "#/components/schemas/WorkflowStagePart"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Parts"
},
"position": {
"anyOf": [
{
"minimum": 1,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Position"
},
"required_inputs": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Required Inputs"
},
"requires_human_approval": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Requires Human Approval"
},
"retry_policy": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Retry Policy"
},
"runner_profile_key": {
"anyOf": [
{
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Runner Profile Key"
},
"stable_key": {
"anyOf": [
{
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Stable Key"
}
},
"title": "WorkflowStageUpdateRequest",
"type": "object"
},
"WorkflowTemplateAuditEventListResponse": {
"additionalProperties": false,
"properties": {
"events": {
"items": {
"$ref": "#/components/schemas/WorkflowTemplateAuditEventSummary"
},
"title": "Events",
"type": "array"
}
},
"title": "WorkflowTemplateAuditEventListResponse",
"type": "object"
},
"WorkflowTemplateAuditEventSummary": {
"additionalProperties": false,
"properties": {
"actor_user_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Actor User Id"
},
"created_at": {
"format": "date-time",
"title": "Created At",
"type": "string"
},
"event_type": {
"minLength": 1,
"title": "Event Type",
"type": "string"
},
"id": {
"format": "uuid",
"title": "Id",
"type": "string"
},
"payload": {
"additionalProperties": true,
"title": "Payload",
"type": "object"
},
"workflow_id": {
"format": "uuid",
"title": "Workflow Id",
"type": "string"
}
},
"required": [
"id",
"workflow_id",
"event_type",
"created_at"
],
"title": "WorkflowTemplateAuditEventSummary",
"type": "object"
},
"WorkflowTemplateCreateRequest": {
"additionalProperties": false,
"properties": {
"description": {
"minLength": 1,
"title": "Description",
"type": "string"
},
"name": {
"minLength": 1,
"title": "Name",
"type": "string"
},
"slug": {
"minLength": 1,
"title": "Slug",
"type": "string"
}
},
"required": [
"name",
"slug",
"description"
],
"title": "WorkflowTemplateCreateRequest",
"type": "object"
},
"WorkflowTemplateListResponse": {
"additionalProperties": false,
"properties": {
"workflows": {
"items": {
"$ref": "#/components/schemas/WorkflowTemplateSummary"
},
"title": "Workflows",
"type": "array"
}
},
"title": "WorkflowTemplateListResponse",
"type": "object"
},
"WorkflowTemplateResponse": {
"additionalProperties": false,
"properties": {
"workflow": {
"$ref": "#/components/schemas/WorkflowTemplateSummary"
}
},
"required": [
"workflow"
],
"title": "WorkflowTemplateResponse",
"type": "object"
},
"WorkflowTemplateSnapshot": {
"additionalProperties": false,
"properties": {
"id": {
"format": "uuid",
"title": "Id",
"type": "string"
},
"name": {
"minLength": 1,
"title": "Name",
"type": "string"
},
"slug": {
"minLength": 1,
"title": "Slug",
"type": "string"
},
"stage_summary": {
"items": {
"$ref": "#/components/schemas/WorkflowTemplateStageSnapshot"
},
"title": "Stage Summary",
"type": "array"
},
"version": {
"minimum": 1,
"title": "Version",
"type": "integer"
}
},
"required": [
"id",
"name",
"slug",
"version"
],
"title": "WorkflowTemplateSnapshot",
"type": "object"
},
"WorkflowTemplateStageSnapshot": {
"additionalProperties": false,
"properties": {
"display_name": {
"minLength": 1,
"title": "Display Name",
"type": "string"
},
"id": {
"format": "uuid",
"title": "Id",
"type": "string"
},
"owner_role": {
"$ref": "#/components/schemas/Role"
},
"position": {
"minimum": 1,
"title": "Position",
"type": "integer"
},
"requires_human_approval": {
"default": false,
"title": "Requires Human Approval",
"type": "boolean"
},
"runner_profile_key": {
"minLength": 1,
"title": "Runner Profile Key",
"type": "string"
},
"stable_key": {
"minLength": 1,
"title": "Stable Key",
"type": "string"
}
},
"required": [
"id",
"stable_key",
"display_name",
"position",
"owner_role",
"runner_profile_key"
],
"title": "WorkflowTemplateStageSnapshot",
"type": "object"
},
"WorkflowTemplateStatus": {
"enum": [
"DRAFT",
"ACTIVE",
"ARCHIVED"
],
"title": "WorkflowTemplateStatus",
"type": "string"
},
"WorkflowTemplateSummary": {
"additionalProperties": false,
"properties": {
"activated_at": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Activated At"
},
"archived_at": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Archived At"
},
"created_at": {
"format": "date-time",
"title": "Created At",
"type": "string"
},
"created_by": {
"format": "uuid",
"title": "Created By",
"type": "string"
},
"description": {
"minLength": 1,
"title": "Description",
"type": "string"
},
"id": {
"format": "uuid",
"title": "Id",
"type": "string"
},
"name": {
"minLength": 1,
"title": "Name",
"type": "string"
},
"slug": {
"minLength": 1,
"title": "Slug",
"type": "string"
},
"stages": {
"items": {
"$ref": "#/components/schemas/WorkflowStageSummary"
},
"title": "Stages",
"type": "array"
},
"status": {
"$ref": "#/components/schemas/WorkflowTemplateStatus"
},
"updated_at": {
"format": "date-time",
"title": "Updated At",
"type": "string"
},
"updated_by": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Updated By"
},
"version": {
"minimum": 1,
"title": "Version",
"type": "integer"
}
},
"required": [
"id",
"name",
"slug",
"description",
"status",
"version",
"created_by",
"created_at",
"updated_at"
],
"title": "WorkflowTemplateSummary",
"type": "object"
},
"WorkflowTemplateUpdateRequest": {
"additionalProperties": false,
"properties": {
"description": {
"anyOf": [
{
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Description"
},
"name": {
"anyOf": [
{
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Name"
},
"slug": {
"anyOf": [
{
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Slug"
}
},
"title": "WorkflowTemplateUpdateRequest",
"type": "object"
}
}
},
"info": {
"title": "AI Content Pipeline Backend",
"version": "0.1.0"
},
"openapi": "3.1.0",
"paths": {
"/api/admin/workflows": {
"get": {
"operationId": "get_workflow_templates_api_admin_workflows_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/WorkflowTemplateListResponse"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Get Workflow Templates",
"tags": [
"workflow_templates"
]
},
"post": {
"operationId": "post_workflow_template_api_admin_workflows_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/WorkflowTemplateCreateRequest"
}
}
},
"required": true
},
"responses": {
"201": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/WorkflowTemplateResponse"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Post Workflow Template",
"tags": [
"workflow_templates"
]
}
},
"/api/admin/workflows/{workflow_id}": {
"get": {
"operationId": "get_workflow_template_detail_api_admin_workflows__workflow_id__get",
"parameters": [
{
"in": "path",
"name": "workflow_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Workflow 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/WorkflowTemplateResponse"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Get Workflow Template Detail",
"tags": [
"workflow_templates"
]
},
"patch": {
"operationId": "patch_workflow_template_api_admin_workflows__workflow_id__patch",
"parameters": [
{
"in": "path",
"name": "workflow_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Workflow 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/WorkflowTemplateUpdateRequest"
}
}
},
"required": true
},
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/WorkflowTemplateResponse"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Patch Workflow Template",
"tags": [
"workflow_templates"
]
}
},
"/api/admin/workflows/{workflow_id}/activate": {
"post": {
"operationId": "post_activate_workflow_template_api_admin_workflows__workflow_id__activate_post",
"parameters": [
{
"in": "path",
"name": "workflow_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Workflow 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/WorkflowTemplateResponse"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Post Activate Workflow Template",
"tags": [
"workflow_templates"
]
}
},
"/api/admin/workflows/{workflow_id}/archive": {
"post": {
"operationId": "post_archive_workflow_template_api_admin_workflows__workflow_id__archive_post",
"parameters": [
{
"in": "path",
"name": "workflow_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Workflow 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/WorkflowTemplateResponse"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Post Archive Workflow Template",
"tags": [
"workflow_templates"
]
}
},
"/api/admin/workflows/{workflow_id}/audit": {
"get": {
"operationId": "get_workflow_template_audit_events_api_admin_workflows__workflow_id__audit_get",
"parameters": [
{
"in": "path",
"name": "workflow_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Workflow 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/WorkflowTemplateAuditEventListResponse"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Get Workflow Template Audit Events",
"tags": [
"workflow_templates"
]
}
},
"/api/admin/workflows/{workflow_id}/stages": {
"post": {
"operationId": "post_workflow_stage_api_admin_workflows__workflow_id__stages_post",
"parameters": [
{
"in": "path",
"name": "workflow_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Workflow 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/WorkflowStageCreateRequest"
}
}
},
"required": true
},
"responses": {
"201": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/WorkflowStageResponse"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Post Workflow Stage",
"tags": [
"workflow_templates"
]
}
},
"/api/admin/workflows/{workflow_id}/stages/reorder": {
"post": {
"operationId": "post_reorder_workflow_stages_api_admin_workflows__workflow_id__stages_reorder_post",
"parameters": [
{
"in": "path",
"name": "workflow_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Workflow 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/WorkflowStageReorderRequest"
}
}
},
"required": true
},
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/WorkflowTemplateResponse"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Post Reorder Workflow Stages",
"tags": [
"workflow_templates"
]
}
},
"/api/admin/workflows/{workflow_id}/stages/{stage_id}": {
"delete": {
"operationId": "delete_workflow_template_stage_api_admin_workflows__workflow_id__stages__stage_id__delete",
"parameters": [
{
"in": "path",
"name": "workflow_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Workflow Id",
"type": "string"
}
},
{
"in": "path",
"name": "stage_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Stage 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/WorkflowTemplateResponse"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Delete Workflow Template Stage",
"tags": [
"workflow_templates"
]
},
"patch": {
"operationId": "patch_workflow_stage_api_admin_workflows__workflow_id__stages__stage_id__patch",
"parameters": [
{
"in": "path",
"name": "workflow_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Workflow Id",
"type": "string"
}
},
{
"in": "path",
"name": "stage_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Stage 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/WorkflowStageUpdateRequest"
}
}
},
"required": true
},
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/WorkflowStageResponse"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Patch Workflow Stage",
"tags": [
"workflow_templates"
]
}
},
"/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}/publishing/commits": {
"get": {
"operationId": "get_article_publishing_commits_api_articles__article_id__publishing_commits_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/PublishCommitListResponse"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Get Article Publishing Commits",
"tags": [
"publishing"
]
}
},
"/api/articles/{article_id}/publishing/create-commit": {
"post": {
"operationId": "post_publishing_create_commit_api_articles__article_id__publishing_create_commit_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/PublishCommitCreateResponse"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Post Publishing Create Commit",
"tags": [
"publishing"
]
}
},
"/api/articles/{article_id}/publishing/dry-run": {
"post": {
"operationId": "post_publishing_dry_run_api_articles__article_id__publishing_dry_run_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/PublishingDryRunResponse"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Post Publishing Dry Run",
"tags": [
"publishing"
]
}
},
"/api/articles/{article_id}/publishing/status": {
"get": {
"operationId": "get_article_publishing_status_api_articles__article_id__publishing_status_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/PublishingStatusResponse"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Get Article Publishing Status",
"tags": [
"publishing"
]
}
},
"/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/audit": {
"get": {
"operationId": "get_script_config_audit_events_api_sites__site_id__publishing_config_audit_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/ScriptConfigVersionAuditEventListResponse"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Get Script Config Audit Events",
"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"
}
}
}
}