{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/frase-io/json-schema/frase-io-cms-delivery-post-schema.json",
  "title": "CmsDeliveryPost",
  "description": "A published CMS post served by the public headless-delivery single-post API. snake_case (consistent with the API-key v1 CmsPost). Includes taxonomy (primary_author/authors/category/tags) and all SEO scalars.",
  "x-generated": "2026-11-09",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/frase-io-openapi.json#/components/schemas/CmsDeliveryPost",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "format": "uuid"
    },
    "slug": {
      "type": "string"
    },
    "type": {
      "type": "string",
      "enum": [
        "blog_post",
        "page"
      ]
    },
    "title": {
      "type": "string"
    },
    "excerpt": {
      "type": [
        "string",
        "null"
      ]
    },
    "featured_image": {
      "type": [
        "string",
        "null"
      ],
      "format": "uri"
    },
    "featured_image_alt": {
      "type": [
        "string",
        "null"
      ]
    },
    "seo_title": {
      "type": [
        "string",
        "null"
      ]
    },
    "seo_description": {
      "type": [
        "string",
        "null"
      ]
    },
    "focus_keyword": {
      "type": [
        "string",
        "null"
      ]
    },
    "canonical_url": {
      "type": [
        "string",
        "null"
      ],
      "format": "uri"
    },
    "schema_markup": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": true,
      "description": "Editor-authored JSON-LD structured data, if set."
    },
    "og_image": {
      "type": [
        "string",
        "null"
      ],
      "format": "uri"
    },
    "og_title": {
      "type": [
        "string",
        "null"
      ]
    },
    "og_description": {
      "type": [
        "string",
        "null"
      ]
    },
    "published_at": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time"
    },
    "created_at": {
      "type": "string",
      "format": "date-time"
    },
    "updated_at": {
      "type": "string",
      "format": "date-time"
    },
    "primary_author": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "id": {
          "type": "string",
          "format": "uuid"
        },
        "name": {
          "type": "string"
        },
        "slug": {
          "type": "string"
        },
        "avatar_url": {
          "type": [
            "string",
            "null"
          ],
          "format": "uri"
        },
        "bio": {
          "type": [
            "string",
            "null"
          ]
        },
        "role": {
          "type": [
            "string",
            "null"
          ],
          "description": "e.g. \"Head of Content\". Set on author creation only; a re-import never overwrites an existing author's role."
        }
      },
      "required": [
        "id",
        "name",
        "slug"
      ],
      "description": "Primary/canonical author, or null."
    },
    "authors": {
      "type": "array",
      "description": "Byline authors (incl. the primary), ordered by position.",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "name": {
            "type": "string"
          },
          "slug": {
            "type": "string"
          },
          "position": {
            "type": "integer"
          },
          "avatar_url": {
            "type": [
              "string",
              "null"
            ],
            "format": "uri"
          },
          "role": {
            "type": [
              "string",
              "null"
            ],
            "description": "e.g. \"Head of Content\". Set on author creation only; a re-import never overwrites an existing author's role."
          }
        },
        "required": [
          "id",
          "name",
          "slug",
          "position"
        ]
      }
    },
    "category": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "id": {
          "type": "string",
          "format": "uuid"
        },
        "name": {
          "type": "string"
        },
        "slug": {
          "type": "string"
        },
        "parent_id": {
          "type": [
            "string",
            "null"
          ],
          "format": "uuid"
        }
      },
      "required": [
        "id",
        "name",
        "slug"
      ],
      "description": "Single category, or null."
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "name": {
            "type": "string"
          },
          "slug": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "name",
          "slug"
        ]
      }
    },
    "content": {
      "type": "string",
      "description": "Rendered HTML body."
    },
    "meta": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": true
    },
    "json_ld": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": true,
      "description": "Auto-generated schema.org JSON-LD for this post (per content type: BlogPosting/Article/FAQPage/HowTo/Review/etc.), or null when no markup applies. Ready to embed in a <script type=\"application/ld+json\"> tag. Editor-authored schema_markup overrides the generated value."
    }
  },
  "required": [
    "id",
    "slug",
    "type",
    "title",
    "content"
  ]
}