> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thepublive.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Form Schema

> Returns a reader-facing form schema definition. Unlike other endpoints, the response has no `status`/`data` envelope — the schema object is returned directly.



## OpenAPI

````yaml /openapi/content-delivery.json get /publisher/{publisher_id}/form_schema/reader/{schema_id}/
openapi: 3.1.0
info:
  title: Publive Content Delivery API
  version: 1.0.0
  description: >-
    Read-only API for delivering publisher content, configuration, and static
    assets. All endpoints require HTTP Basic Auth and are GET requests.
servers:
  - url: https://cds.thepublive.com
security:
  - basicAuth: []
tags:
  - name: Site Configuration
  - name: Content
  - name: Posts
  - name: Forms
  - name: Static Files
  - name: Sitemaps
paths:
  /publisher/{publisher_id}/form_schema/reader/{schema_id}/:
    get:
      tags:
        - Forms
      summary: Form Schema
      description: >-
        Returns a reader-facing form schema definition. Unlike other endpoints,
        the response has no `status`/`data` envelope — the schema object is
        returned directly.
      operationId: getFormSchemaCDS
      parameters:
        - $ref: '#/components/parameters/PublisherId'
        - name: schema_id
          in: path
          required: true
          schema:
            type: string
          description: 24-character hex Form Schema ID
        - name: page_source
          in: query
          required: false
          schema:
            type: string
          description: Used by the serializer if applicable
      responses:
        '200':
          description: Form schema object
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                  name:
                    type: string
                  description:
                    type: string
                  type:
                    type: string
                  settings:
                    type: object
                  state:
                    type: string
                  created_at:
                    type: string
                  updated_at:
                    type: string
                  deleted:
                    type: boolean
                  updated_by:
                    type: string
                  field_types:
                    type: array
                    items:
                      type: object
                  groups:
                    type: array
                    items:
                      type: object
                  form_page:
                    type: object
                  captcha_config:
                    type: object
                    properties:
                      site_key:
                        type: string
        '400':
          description: Invalid schema ID format
          content:
            application/json:
              example:
                detail: >-
                  Invalid Form Schema ID format - must be a 24-character hex
                  string
        '404':
          description: Form schema not found or not accepting submissions
          content:
            application/json:
              example:
                detail: Form Schema Doesn't exist or no longer taking submissions.
components:
  parameters:
    PublisherId:
      name: publisher_id
      in: path
      required: true
      schema:
        type: string
      description: Your Publisher ID
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic
      description: HTTP Basic Auth using your Publive API key pair, base64-encoded.

````