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

3788 lines
94 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"
},
"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"
},
"queued_at": {
"format": "date-time",
"title": "Queued At",
"type": "string"
},
"started_at": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Started At"
},
"status": {
"$ref": "#/components/schemas/AgentJobStatus"
},
"stderr": {
"default": "",
"title": "Stderr",
"type": "string"
},
"stdout": {
"default": "",
"title": "Stdout",
"type": "string"
},
"workspace_path": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Workspace Path"
}
},
"required": [
"id",
"job_type",
"agent_profile",
"status",
"queued_at"
],
"title": "AgentJobSummary",
"type": "object"
},
"AgentJobTestCodexRequest": {
"additionalProperties": false,
"properties": {
"fake_result": {
"default": "valid",
"pattern": "^(valid|invalid_schema)$",
"title": "Fake Result",
"type": "string"
}
},
"title": "AgentJobTestCodexRequest",
"type": "object"
},
"AgentJobType": {
"enum": [
"BOUNDARY_QUESTIONS",
"PLAN_GENERATION",
"RESEARCH",
"EVIDENCE_MATRIX",
"SECTION_SCAFFOLD",
"DRAFT_ASSEMBLY",
"SEO_REVIEW",
"LANGUAGE_REVIEW",
"PUBLISH_DRY_RUN",
"PUBLISH_COMMIT",
"TEST_CODEX"
],
"title": "AgentJobType",
"type": "string"
},
"ArticleCreateRequest": {
"additionalProperties": false,
"properties": {
"assigned_editor_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Assigned Editor Id"
},
"brief_description": {
"minLength": 1,
"title": "Brief Description",
"type": "string"
},
"content_type": {
"default": "longform_guide",
"minLength": 1,
"title": "Content Type",
"type": "string"
},
"language": {
"default": "en",
"minLength": 2,
"title": "Language",
"type": "string"
},
"primary_keyword": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Primary Keyword"
},
"target_site_id": {
"format": "uuid",
"title": "Target Site Id",
"type": "string"
},
"working_title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Working Title"
}
},
"required": [
"target_site_id",
"brief_description"
],
"title": "ArticleCreateRequest",
"type": "object"
},
"ArticleCreateResponse": {
"additionalProperties": false,
"properties": {
"article": {
"$ref": "#/components/schemas/ArticleSummary"
}
},
"required": [
"article"
],
"title": "ArticleCreateResponse",
"type": "object"
},
"ArticleDetailResponse": {
"additionalProperties": false,
"properties": {
"agent_jobs": {
"items": {
"$ref": "#/components/schemas/AgentJobSummary"
},
"title": "Agent Jobs",
"type": "array"
},
"article": {
"$ref": "#/components/schemas/ArticleSummary"
},
"assets": {
"items": {
"$ref": "#/components/schemas/AssetSummary"
},
"title": "Assets",
"type": "array"
},
"boundary_questions": {
"items": {
"$ref": "#/components/schemas/BoundaryQuestionSummary"
},
"title": "Boundary Questions",
"type": "array"
},
"claims": {
"items": {
"$ref": "#/components/schemas/ClaimSummary"
},
"title": "Claims",
"type": "array"
},
"draft": {
"anyOf": [
{
"$ref": "#/components/schemas/DraftSummary"
},
{
"type": "null"
}
],
"default": null
},
"evidence": {
"items": {
"$ref": "#/components/schemas/EvidenceSummary"
},
"title": "Evidence",
"type": "array"
},
"plan": {
"anyOf": [
{
"$ref": "#/components/schemas/PlanSummary"
},
{
"type": "null"
}
],
"default": null
},
"publish_commit": {
"anyOf": [
{
"$ref": "#/components/schemas/PublishCommitSummary"
},
{
"type": "null"
}
],
"default": null
},
"research_manifests": {
"items": {
"$ref": "#/components/schemas/ResearchArtifactManifestSummary"
},
"title": "Research Manifests",
"type": "array"
},
"reviews": {
"items": {
"$ref": "#/components/schemas/ReviewSummary"
},
"title": "Reviews",
"type": "array"
},
"target_site": {
"anyOf": [
{
"$ref": "#/components/schemas/TargetSiteConfig"
},
{
"type": "null"
}
],
"default": null
},
"workflow_events": {
"items": {
"$ref": "#/components/schemas/WorkflowEventSummary"
},
"title": "Workflow Events",
"type": "array"
}
},
"required": [
"article"
],
"title": "ArticleDetailResponse",
"type": "object"
},
"ArticleListResponse": {
"additionalProperties": false,
"properties": {
"articles": {
"items": {
"$ref": "#/components/schemas/ArticleSummary"
},
"title": "Articles",
"type": "array"
}
},
"required": [
"articles"
],
"title": "ArticleListResponse",
"type": "object"
},
"ArticleSummary": {
"additionalProperties": false,
"properties": {
"assigned_editor_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Assigned Editor Id"
},
"brief_description": {
"title": "Brief Description",
"type": "string"
},
"content_type": {
"title": "Content Type",
"type": "string"
},
"created_at": {
"format": "date-time",
"title": "Created At",
"type": "string"
},
"id": {
"format": "uuid",
"title": "Id",
"type": "string"
},
"language": {
"title": "Language",
"type": "string"
},
"primary_keyword": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Primary Keyword"
},
"publishing_status": {
"$ref": "#/components/schemas/PublishingStatus"
},
"status": {
"$ref": "#/components/schemas/ArticleWorkflowStatus"
},
"target_site_id": {
"format": "uuid",
"title": "Target Site Id",
"type": "string"
},
"updated_at": {
"format": "date-time",
"title": "Updated At",
"type": "string"
},
"working_title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Working Title"
}
},
"required": [
"id",
"target_site_id",
"status",
"publishing_status",
"brief_description",
"language",
"content_type",
"created_at",
"updated_at"
],
"title": "ArticleSummary",
"type": "object"
},
"ArticleWorkflowStatus": {
"enum": [
"ARTICLE_BRIEF_CREATED",
"BOUNDARY_QUESTIONS_GENERATED",
"BOUNDARY_ANSWERS_SUBMITTED",
"PLAN_GENERATED",
"PLAN_REVIEW_REQUIRED",
"PLAN_REVISION_REQUIRED",
"RESEARCH_RUNNING",
"EVIDENCE_MATRIX_READY",
"PARALLEL_PRODUCTION_RUNNING",
"DRAFT_ASSEMBLED",
"SEO_AND_LANGUAGE_REVIEW_READY",
"FINAL_REVIEW_REQUIRED",
"FINAL_REVISION_REQUIRED",
"PUBLISH_DRY_RUN_REQUIRED",
"PUBLISH_COMMIT_READY",
"PUBLISH_COMMIT_CREATED"
],
"title": "ArticleWorkflowStatus",
"type": "string"
},
"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"
},
"file_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "File Url"
},
"id": {
"format": "uuid",
"title": "Id",
"type": "string"
},
"prompt": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Prompt"
},
"status": {
"$ref": "#/components/schemas/AssetStatus"
},
"title": {
"minLength": 1,
"title": "Title",
"type": "string"
}
},
"required": [
"id",
"article_id",
"asset_type",
"title",
"status"
],
"title": "AssetSummary",
"type": "object"
},
"AssetType": {
"enum": [
"hero_image",
"diagram",
"table",
"inline_image"
],
"title": "AssetType",
"type": "string"
},
"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"
},
"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"
},
"DraftSummary": {
"additionalProperties": false,
"properties": {
"article_id": {
"format": "uuid",
"title": "Article Id",
"type": "string"
},
"body_object_key": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Body Object Key"
},
"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"
},
"updated_at": {
"format": "date-time",
"title": "Updated At",
"type": "string"
},
"version": {
"minimum": 1,
"title": "Version",
"type": "integer"
}
},
"required": [
"id",
"article_id",
"version",
"title",
"slug",
"status",
"updated_at"
],
"title": "DraftSummary",
"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"
},
"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"
},
"HTTPValidationError": {
"properties": {
"detail": {
"items": {
"$ref": "#/components/schemas/ValidationError"
},
"title": "Detail",
"type": "array"
}
},
"title": "HTTPValidationError",
"type": "object"
},
"PlanReviewStatus": {
"enum": [
"PENDING_REVIEW",
"APPROVED",
"REVISION_REQUESTED"
],
"title": "PlanReviewStatus",
"type": "string"
},
"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"
},
"heading": {
"minLength": 1,
"title": "Heading",
"type": "string"
},
"id": {
"format": "uuid",
"title": "Id",
"type": "string"
},
"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"
},
"claims_to_prove": {
"items": {
"type": "string"
},
"title": "Claims To Prove",
"type": "array"
},
"created_at": {
"format": "date-time",
"title": "Created At",
"type": "string"
},
"id": {
"format": "uuid",
"title": "Id",
"type": "string"
},
"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"
},
"status": {
"$ref": "#/components/schemas/PlanReviewStatus"
},
"thesis": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Thesis"
},
"version": {
"minimum": 1,
"title": "Version",
"type": "integer"
}
},
"required": [
"id",
"article_id",
"version",
"status",
"created_at"
],
"title": "PlanSummary",
"type": "object"
},
"PublishCommitSummary": {
"additionalProperties": false,
"properties": {
"article_id": {
"format": "uuid",
"title": "Article Id",
"type": "string"
},
"branch": {
"minLength": 1,
"title": "Branch",
"type": "string"
},
"commit_sha": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Commit Sha"
},
"content_bundle_manifest": {
"additionalProperties": true,
"title": "Content Bundle Manifest",
"type": "object"
},
"created_at": {
"format": "date-time",
"title": "Created At",
"type": "string"
},
"deployment_status": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Deployment Status"
},
"id": {
"format": "uuid",
"title": "Id",
"type": "string"
},
"repository_url": {
"minLength": 1,
"title": "Repository Url",
"type": "string"
},
"status": {
"$ref": "#/components/schemas/PublishingStatus"
},
"target_site_id": {
"format": "uuid",
"title": "Target Site Id",
"type": "string"
}
},
"required": [
"id",
"article_id",
"target_site_id",
"repository_url",
"branch",
"status",
"created_at"
],
"title": "PublishCommitSummary",
"type": "object"
},
"PublishingRules": {
"additionalProperties": false,
"properties": {
"asset_path_template": {
"minLength": 1,
"title": "Asset Path Template",
"type": "string"
},
"content_format": {
"default": "mdx",
"minLength": 1,
"title": "Content Format",
"type": "string"
},
"content_path_template": {
"minLength": 1,
"title": "Content Path Template",
"type": "string"
},
"dry_run_renderer": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Dry Run Renderer"
},
"frontmatter_mapping": {
"additionalProperties": true,
"title": "Frontmatter Mapping",
"type": "object"
},
"production_branch": {
"minLength": 1,
"title": "Production Branch",
"type": "string"
},
"repository_url": {
"minLength": 1,
"title": "Repository Url",
"type": "string"
},
"transform_script_version_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Transform Script Version Id"
}
},
"required": [
"repository_url",
"production_branch",
"content_path_template",
"asset_path_template"
],
"title": "PublishingRules",
"type": "object"
},
"PublishingStatus": {
"enum": [
"PUBLISH_NOT_STARTED",
"PUBLISH_DRY_RUN_REQUIRED",
"PUBLISH_DRY_RUN_RUNNING",
"PUBLISH_DRY_RUN_FAILED",
"PUBLISH_COMMIT_READY",
"PUBLISH_COMMIT_CREATED",
"PUBLISH_VERIFICATION_FAILED"
],
"title": "PublishingStatus",
"type": "string"
},
"ResearchArtifactManifestSummary": {
"additionalProperties": false,
"properties": {
"agent_job_id": {
"format": "uuid",
"title": "Agent Job Id",
"type": "string"
},
"article_id": {
"format": "uuid",
"title": "Article Id",
"type": "string"
},
"artifacts": {
"items": {
"$ref": "#/components/schemas/ResearchArtifactSummary"
},
"title": "Artifacts",
"type": "array"
},
"created_at": {
"format": "date-time",
"title": "Created At",
"type": "string"
},
"id": {
"format": "uuid",
"title": "Id",
"type": "string"
},
"s3_prefix": {
"minLength": 1,
"title": "S3 Prefix",
"type": "string"
}
},
"required": [
"id",
"article_id",
"agent_job_id",
"s3_prefix",
"created_at"
],
"title": "ResearchArtifactManifestSummary",
"type": "object"
},
"ResearchArtifactSummary": {
"additionalProperties": false,
"properties": {
"artifact_type": {
"minLength": 1,
"title": "Artifact Type",
"type": "string"
},
"content_hash": {
"minLength": 1,
"title": "Content Hash",
"type": "string"
},
"metadata": {
"additionalProperties": true,
"title": "Metadata",
"type": "object"
},
"object_key": {
"minLength": 1,
"title": "Object Key",
"type": "string"
},
"source_url": {
"minLength": 1,
"title": "Source Url",
"type": "string"
}
},
"required": [
"artifact_type",
"source_url",
"object_key",
"content_hash"
],
"title": "ResearchArtifactSummary",
"type": "object"
},
"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"
},
"ReviewSummary": {
"additionalProperties": false,
"properties": {
"article_id": {
"format": "uuid",
"title": "Article Id",
"type": "string"
},
"created_at": {
"format": "date-time",
"title": "Created At",
"type": "string"
},
"id": {
"format": "uuid",
"title": "Id",
"type": "string"
},
"notes": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Notes"
},
"review_type": {
"$ref": "#/components/schemas/ReviewType"
},
"reviewer_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Reviewer Id"
},
"status": {
"$ref": "#/components/schemas/ReviewStatus"
}
},
"required": [
"id",
"article_id",
"review_type",
"status",
"created_at"
],
"title": "ReviewSummary",
"type": "object"
},
"ReviewType": {
"enum": [
"PLAN",
"EVIDENCE",
"ASSET",
"SEO_LANGUAGE",
"FINAL"
],
"title": "ReviewType",
"type": "string"
},
"Role": {
"enum": [
"ADMIN",
"EDITOR"
],
"title": "Role",
"type": "string"
},
"RunnerFileRef": {
"additionalProperties": false,
"properties": {
"content_hash": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Content Hash"
},
"path": {
"minLength": 1,
"title": "Path",
"type": "string"
}
},
"required": [
"path"
],
"title": "RunnerFileRef",
"type": "object"
},
"ScriptConfigVersionCreateRequest": {
"additionalProperties": false,
"properties": {
"activate": {
"default": false,
"title": "Activate",
"type": "boolean"
},
"diff": {
"additionalProperties": true,
"title": "Diff",
"type": "object"
},
"publishing_yaml": {
"minLength": 1,
"title": "Publishing Yaml",
"type": "string"
},
"rollback_target_version_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Rollback Target Version Id"
},
"transform_script": {
"minLength": 1,
"title": "Transform Script",
"type": "string"
},
"version": {
"anyOf": [
{
"minimum": 1,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Version"
}
},
"required": [
"publishing_yaml",
"transform_script"
],
"title": "ScriptConfigVersionCreateRequest",
"type": "object"
},
"ScriptConfigVersionListResponse": {
"additionalProperties": false,
"properties": {
"versions": {
"items": {
"$ref": "#/components/schemas/ScriptConfigVersionSummary"
},
"title": "Versions",
"type": "array"
}
},
"required": [
"versions"
],
"title": "ScriptConfigVersionListResponse",
"type": "object"
},
"ScriptConfigVersionResponse": {
"additionalProperties": false,
"properties": {
"version": {
"$ref": "#/components/schemas/ScriptConfigVersionSummary"
}
},
"required": [
"version"
],
"title": "ScriptConfigVersionResponse",
"type": "object"
},
"ScriptConfigVersionStatus": {
"enum": [
"DRAFT",
"ACTIVE",
"DEPRECATED"
],
"title": "ScriptConfigVersionStatus",
"type": "string"
},
"ScriptConfigVersionSummary": {
"additionalProperties": false,
"properties": {
"activated_at": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Activated At"
},
"created_at": {
"format": "date-time",
"title": "Created At",
"type": "string"
},
"created_by": {
"format": "uuid",
"title": "Created By",
"type": "string"
},
"diff": {
"additionalProperties": true,
"title": "Diff",
"type": "object"
},
"id": {
"format": "uuid",
"title": "Id",
"type": "string"
},
"publishing_yaml_hash": {
"minLength": 1,
"title": "Publishing Yaml Hash",
"type": "string"
},
"rollback_target_version_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Rollback Target Version Id"
},
"status": {
"$ref": "#/components/schemas/ScriptConfigVersionStatus"
},
"target_site_id": {
"format": "uuid",
"title": "Target Site Id",
"type": "string"
},
"transform_script_hash": {
"minLength": 1,
"title": "Transform Script Hash",
"type": "string"
},
"version": {
"minimum": 1,
"title": "Version",
"type": "integer"
}
},
"required": [
"id",
"target_site_id",
"version",
"status",
"publishing_yaml_hash",
"transform_script_hash",
"created_by",
"created_at"
],
"title": "ScriptConfigVersionSummary",
"type": "object"
},
"TargetSiteConfig": {
"additionalProperties": false,
"properties": {
"active_script_config_version_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Active Script Config Version Id"
},
"audience": {
"minLength": 1,
"title": "Audience",
"type": "string"
},
"brand_voice": {
"minLength": 1,
"title": "Brand Voice",
"type": "string"
},
"created_at": {
"format": "date-time",
"title": "Created At",
"type": "string"
},
"default_language": {
"default": "en",
"minLength": 2,
"title": "Default Language",
"type": "string"
},
"id": {
"format": "uuid",
"title": "Id",
"type": "string"
},
"name": {
"minLength": 1,
"title": "Name",
"type": "string"
},
"publishing_rules": {
"$ref": "#/components/schemas/PublishingRules"
},
"publishing_type": {
"default": "git_next",
"minLength": 1,
"title": "Publishing Type",
"type": "string"
},
"seo_rules": {
"additionalProperties": true,
"title": "Seo Rules",
"type": "object"
},
"slug": {
"minLength": 1,
"title": "Slug",
"type": "string"
},
"source_rules": {
"additionalProperties": true,
"title": "Source Rules",
"type": "object"
},
"updated_at": {
"format": "date-time",
"title": "Updated At",
"type": "string"
},
"visual_rules": {
"additionalProperties": true,
"title": "Visual Rules",
"type": "object"
}
},
"required": [
"id",
"name",
"slug",
"brand_voice",
"audience",
"publishing_rules",
"created_at",
"updated_at"
],
"title": "TargetSiteConfig",
"type": "object"
},
"TargetSiteConfigCreateRequest": {
"additionalProperties": false,
"properties": {
"active_script_config_version_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Active Script Config Version Id"
},
"audience": {
"minLength": 1,
"title": "Audience",
"type": "string"
},
"brand_voice": {
"minLength": 1,
"title": "Brand Voice",
"type": "string"
},
"default_language": {
"default": "en",
"minLength": 2,
"title": "Default Language",
"type": "string"
},
"name": {
"minLength": 1,
"title": "Name",
"type": "string"
},
"publishing_rules": {
"$ref": "#/components/schemas/PublishingRules"
},
"publishing_type": {
"default": "git_next",
"minLength": 1,
"title": "Publishing Type",
"type": "string"
},
"seo_rules": {
"additionalProperties": true,
"title": "Seo Rules",
"type": "object"
},
"slug": {
"minLength": 1,
"title": "Slug",
"type": "string"
},
"source_rules": {
"additionalProperties": true,
"title": "Source Rules",
"type": "object"
},
"visual_rules": {
"additionalProperties": true,
"title": "Visual Rules",
"type": "object"
}
},
"required": [
"name",
"slug",
"brand_voice",
"audience",
"publishing_rules"
],
"title": "TargetSiteConfigCreateRequest",
"type": "object"
},
"TargetSiteConfigResponse": {
"additionalProperties": false,
"properties": {
"site": {
"$ref": "#/components/schemas/TargetSiteConfig"
}
},
"required": [
"site"
],
"title": "TargetSiteConfigResponse",
"type": "object"
},
"TargetSiteConfigUpdateRequest": {
"additionalProperties": false,
"properties": {
"active_script_config_version_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Active Script Config Version Id"
},
"audience": {
"anyOf": [
{
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Audience"
},
"brand_voice": {
"anyOf": [
{
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Brand Voice"
},
"default_language": {
"anyOf": [
{
"minLength": 2,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Default Language"
},
"name": {
"anyOf": [
{
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Name"
},
"publishing_rules": {
"anyOf": [
{
"$ref": "#/components/schemas/PublishingRules"
},
{
"type": "null"
}
],
"default": null
},
"publishing_type": {
"anyOf": [
{
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Publishing Type"
},
"seo_rules": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Seo Rules"
},
"slug": {
"anyOf": [
{
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Slug"
},
"source_rules": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Source Rules"
},
"visual_rules": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Visual Rules"
}
},
"title": "TargetSiteConfigUpdateRequest",
"type": "object"
},
"UserSummary": {
"additionalProperties": false,
"properties": {
"display_name": {
"minLength": 1,
"title": "Display Name",
"type": "string"
},
"id": {
"format": "uuid",
"title": "Id",
"type": "string"
},
"role": {
"$ref": "#/components/schemas/Role"
}
},
"required": [
"id",
"display_name",
"role"
],
"title": "UserSummary",
"type": "object"
},
"ValidationError": {
"properties": {
"loc": {
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "integer"
}
]
},
"title": "Location",
"type": "array"
},
"msg": {
"title": "Message",
"type": "string"
},
"type": {
"title": "Error Type",
"type": "string"
}
},
"required": [
"loc",
"msg",
"type"
],
"title": "ValidationError",
"type": "object"
},
"WorkflowEventSummary": {
"additionalProperties": false,
"properties": {
"actor_user_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Actor User Id"
},
"article_id": {
"format": "uuid",
"title": "Article Id",
"type": "string"
},
"created_at": {
"format": "date-time",
"title": "Created At",
"type": "string"
},
"event_type": {
"minLength": 1,
"title": "Event Type",
"type": "string"
},
"from_status": {
"anyOf": [
{
"$ref": "#/components/schemas/ArticleWorkflowStatus"
},
{
"type": "null"
}
],
"default": null
},
"id": {
"format": "uuid",
"title": "Id",
"type": "string"
},
"payload": {
"additionalProperties": true,
"title": "Payload",
"type": "object"
},
"to_status": {
"anyOf": [
{
"$ref": "#/components/schemas/ArticleWorkflowStatus"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"id",
"article_id",
"event_type",
"created_at"
],
"title": "WorkflowEventSummary",
"type": "object"
}
}
},
"info": {
"title": "AI Content Pipeline Backend",
"version": "0.1.0"
},
"openapi": "3.1.0",
"paths": {
"/api/agent-jobs": {
"get": {
"operationId": "get_agent_jobs_api_agent_jobs_get",
"parameters": [
{
"in": "header",
"name": "X-Demo-User-Email",
"required": false,
"schema": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "X-Demo-User-Email"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/AgentJobListResponse"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Get Agent Jobs",
"tags": [
"agent-jobs"
]
}
},
"/api/agent-jobs/test-codex": {
"post": {
"operationId": "post_test_codex_job_api_agent_jobs_test_codex_post",
"parameters": [
{
"in": "header",
"name": "X-Demo-User-Email",
"required": false,
"schema": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "X-Demo-User-Email"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/AgentJobTestCodexRequest"
}
}
}
},
"responses": {
"201": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/AgentJobResponse"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Post Test Codex Job",
"tags": [
"agent-jobs"
]
}
},
"/api/agent-jobs/{job_id}": {
"get": {
"operationId": "get_agent_job_route_api_agent_jobs__job_id__get",
"parameters": [
{
"in": "path",
"name": "job_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Job Id",
"type": "string"
}
},
{
"in": "header",
"name": "X-Demo-User-Email",
"required": false,
"schema": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "X-Demo-User-Email"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/AgentJobResponse"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Get Agent Job Route",
"tags": [
"agent-jobs"
]
}
},
"/api/agent-jobs/{job_id}/cancel": {
"post": {
"operationId": "post_cancel_agent_job_api_agent_jobs__job_id__cancel_post",
"parameters": [
{
"in": "path",
"name": "job_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Job Id",
"type": "string"
}
},
{
"in": "header",
"name": "X-Demo-User-Email",
"required": false,
"schema": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "X-Demo-User-Email"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/AgentJobResponse"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Post Cancel Agent Job",
"tags": [
"agent-jobs"
]
}
},
"/api/agent-jobs/{job_id}/retry": {
"post": {
"operationId": "post_retry_agent_job_api_agent_jobs__job_id__retry_post",
"parameters": [
{
"in": "path",
"name": "job_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Job Id",
"type": "string"
}
},
{
"in": "header",
"name": "X-Demo-User-Email",
"required": false,
"schema": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "X-Demo-User-Email"
}
}
],
"responses": {
"201": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/AgentJobResponse"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Post Retry Agent Job",
"tags": [
"agent-jobs"
]
}
},
"/api/articles": {
"get": {
"operationId": "list_articles_route_api_articles_get",
"parameters": [
{
"in": "header",
"name": "X-Demo-User-Email",
"required": false,
"schema": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "X-Demo-User-Email"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ArticleListResponse"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "List Articles Route",
"tags": [
"articles"
]
},
"post": {
"operationId": "post_article_api_articles_post",
"parameters": [
{
"in": "header",
"name": "X-Demo-User-Email",
"required": false,
"schema": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "X-Demo-User-Email"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ArticleCreateRequest"
}
}
},
"required": true
},
"responses": {
"201": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ArticleCreateResponse"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Post Article",
"tags": [
"articles"
]
}
},
"/api/articles/{article_id}": {
"get": {
"operationId": "get_article_api_articles__article_id__get",
"parameters": [
{
"in": "path",
"name": "article_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Article Id",
"type": "string"
}
},
{
"in": "header",
"name": "X-Demo-User-Email",
"required": false,
"schema": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "X-Demo-User-Email"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ArticleDetailResponse"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Get Article",
"tags": [
"articles"
]
}
},
"/api/articles/{article_id}/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}/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}/approve": {
"post": {
"operationId": "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": "Approve Plan",
"tags": [
"articles"
]
}
},
"/api/me": {
"get": {
"operationId": "get_me_api_me_get",
"parameters": [
{
"in": "header",
"name": "X-Demo-User-Email",
"required": false,
"schema": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "X-Demo-User-Email"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/CurrentUserResponse"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Get Me",
"tags": [
"auth"
]
}
},
"/api/sites": {
"get": {
"operationId": "list_sites_api_sites_get",
"parameters": [
{
"in": "header",
"name": "X-Demo-User-Email",
"required": false,
"schema": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "X-Demo-User-Email"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"items": {
"$ref": "#/components/schemas/TargetSiteConfigResponse"
},
"title": "Response List Sites Api Sites Get",
"type": "array"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "List Sites",
"tags": [
"sites"
]
},
"post": {
"operationId": "post_site_api_sites_post",
"parameters": [
{
"in": "header",
"name": "X-Demo-User-Email",
"required": false,
"schema": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "X-Demo-User-Email"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/TargetSiteConfigCreateRequest"
}
}
},
"required": true
},
"responses": {
"201": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/TargetSiteConfigResponse"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Post Site",
"tags": [
"sites"
]
}
},
"/api/sites/{site_id}": {
"get": {
"operationId": "get_site_api_sites__site_id__get",
"parameters": [
{
"in": "path",
"name": "site_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Site Id",
"type": "string"
}
},
{
"in": "header",
"name": "X-Demo-User-Email",
"required": false,
"schema": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "X-Demo-User-Email"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/TargetSiteConfigResponse"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Get Site",
"tags": [
"sites"
]
},
"patch": {
"operationId": "patch_site_api_sites__site_id__patch",
"parameters": [
{
"in": "path",
"name": "site_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Site Id",
"type": "string"
}
},
{
"in": "header",
"name": "X-Demo-User-Email",
"required": false,
"schema": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "X-Demo-User-Email"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/TargetSiteConfigUpdateRequest"
}
}
},
"required": true
},
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/TargetSiteConfigResponse"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Patch Site",
"tags": [
"sites"
]
}
},
"/api/sites/{site_id}/publishing-config/versions": {
"get": {
"operationId": "get_script_config_versions_api_sites__site_id__publishing_config_versions_get",
"parameters": [
{
"in": "path",
"name": "site_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Site Id",
"type": "string"
}
},
{
"in": "header",
"name": "X-Demo-User-Email",
"required": false,
"schema": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "X-Demo-User-Email"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ScriptConfigVersionListResponse"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Get Script Config Versions",
"tags": [
"sites"
]
},
"post": {
"operationId": "post_script_config_version_api_sites__site_id__publishing_config_versions_post",
"parameters": [
{
"in": "path",
"name": "site_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Site Id",
"type": "string"
}
},
{
"in": "header",
"name": "X-Demo-User-Email",
"required": false,
"schema": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "X-Demo-User-Email"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ScriptConfigVersionCreateRequest"
}
}
},
"required": true
},
"responses": {
"201": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ScriptConfigVersionResponse"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Post Script Config Version",
"tags": [
"sites"
]
}
},
"/api/sites/{site_id}/publishing-config/versions/{version_id}/activate": {
"post": {
"operationId": "post_activate_script_config_version_api_sites__site_id__publishing_config_versions__version_id__activate_post",
"parameters": [
{
"in": "path",
"name": "site_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Site Id",
"type": "string"
}
},
{
"in": "path",
"name": "version_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Version Id",
"type": "string"
}
},
{
"in": "header",
"name": "X-Demo-User-Email",
"required": false,
"schema": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "X-Demo-User-Email"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ScriptConfigVersionResponse"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Post Activate Script Config Version",
"tags": [
"sites"
]
}
},
"/api/sites/{site_id}/publishing-config/versions/{version_id}/rollback": {
"post": {
"operationId": "post_rollback_script_config_version_api_sites__site_id__publishing_config_versions__version_id__rollback_post",
"parameters": [
{
"in": "path",
"name": "site_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Site Id",
"type": "string"
}
},
{
"in": "path",
"name": "version_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Version Id",
"type": "string"
}
},
{
"in": "header",
"name": "X-Demo-User-Email",
"required": false,
"schema": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "X-Demo-User-Email"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ScriptConfigVersionResponse"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Post Rollback Script Config Version",
"tags": [
"sites"
]
}
},
"/health": {
"get": {
"operationId": "health_health_get",
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"additionalProperties": {
"type": "string"
},
"title": "Response Health Health Get",
"type": "object"
}
}
},
"description": "Successful Response"
}
},
"summary": "Health"
}
},
"/health/dependencies": {
"get": {
"operationId": "dependency_health_health_dependencies_get",
"responses": {
"200": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Successful Response"
}
},
"summary": "Dependency Health"
}
}
}
}