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

# DeployPageAPI mirrors the erdo_deploy_page MCP tool.




## OpenAPI

````yaml /api/openapi.json post /v1/pages
openapi: 3.0.0
info:
  title: Erdo API
  description: >-
    Erdo's REST API: query and write datasets, run agents, manage threads,
    integrations, pages, evals, workstreams, and experiments. Authenticate with
    a Bearer API key (erdo_api_...) or scoped token (erdo_token_...).
  version: '2026-07-25'
servers:
  - url: https://api.erdo.ai
    description: Production
security:
  - bearerAuth: []
paths:
  /v1/pages:
    post:
      summary: |
        DeployPageAPI mirrors the erdo_deploy_page MCP tool.
      operationId: POST:mcp.DeployPageAPI
      requestBody:
        content:
          application/json:
            schema:
              properties:
                css:
                  type: string
                dataset_slugs:
                  items:
                    type: string
                  type: array
                html:
                  type: string
                js:
                  type: string
                kv_slugs:
                  items:
                    type: string
                  type: array
                public:
                  type: boolean
                runtime:
                  type: string
                title:
                  type: string
                writable_dataset_slugs:
                  description: >
                    named-KV-store access that erdo.insertRows and erdo.kv.set
                    need. Without them those writes 403 ("this page has no write
                    access"). dataset\_slugs is read-only; these are the write
                    side.
                  items:
                    type: string
                  title: >
                    WritableDatasetSlugs / KVSlugs / WritableKVSlugs grant the
                    write and
                  type: array
                writable_kv_slugs:
                  items:
                    type: string
                  type: array
              type: object
      responses:
        '200':
          content:
            application/json:
              schema:
                properties:
                  id:
                    type: string
                  public:
                    type: boolean
                  public_url:
                    type: string
                  thread_id:
                    type: string
                  title:
                    type: string
                  url:
                    description: >
                      share link and is only present while the page is public.
                      Use these values verbatim — hosts differ across
                      prod/staging/local.
                    title: >
                      URL is the authenticated editor view; PublicURL is the
                      visitor-facing
                    type: string
                  validation:
                    $ref: '#/components/schemas/types.ArtifactValidationResult'
                  warning:
                    description: >
                      successful content deploy/update). The page exists and is
                      usable; the calling agent should surface this to the user
                      and retry the failing op.
                    title: >
                      Warning carries non-fatal issues (e.g. visibility update
                      failed after a
                    type: string
                type: object
          description: Success response
        default:
          $ref: '#/components/responses/APIError'
components:
  schemas:
    types.ArtifactValidationResult:
      description: >
        action callers can reference it without importing the validator
        implementation.
      properties:
        errors:
          items:
            $ref: '#/components/schemas/types.ArtifactValidationError'
          type: array
        valid:
          type: boolean
      title: >
        ArtifactValidationResult lives in this package so both the private API
        layer and
      type: object
    types.ArtifactValidationError:
      properties:
        column:
          format: int64
          type: integer
        context:
          description: |
            fix the error in place without reading the whole artifact back.
          title: >
            Context is a small numbered source snippet around Line so the agent
            can
          type: string
        field:
          title: |
            "html" | "js" | "css" | "content"
          type: string
        line:
          format: int64
          type: integer
        message:
          type: string
        severity:
          title: |
            "error" | "warning"
          type: string
      title: >
        ArtifactValidationError mirrors the internal validator's output for the
        external

        API.
      type: object
  responses:
    APIError:
      content:
        application/json:
          schema:
            externalDocs:
              url: https://pkg.go.dev/encore.dev/beta/errs#Error
            properties:
              code:
                description: Error code
                example: not_found
                externalDocs:
                  url: https://pkg.go.dev/encore.dev/beta/errs#ErrCode
                type: string
              details:
                description: Error details
                type: object
              message:
                description: Error message
                type: string
            title: APIError
            type: object
      description: Error response
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: An Erdo API key (erdo_api_...) or scoped token (erdo_token_...).

````