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

# Post apivizexecute

> POST /viz/execute — full viz pipeline.

validate → plan → execute; returns the execution plan plus a
Plotly figure envelope (``data``/``layout``/``config``). Executor
lookup follows the plan's ``mode``.

Error statuses: 400 (validation failure), 410 (cached result no
longer available), 413 (result exceeds the row/byte ceiling), 429
(async-job quota exceeded), 501 (mode / artifact / source format
not supported by this server), 504 (query exceeded the execution
budget).

Same authentication, visibility, and readiness rules as the other
viz endpoints (e.g. POST /viz/safe-viz-spec/validate/).



## OpenAPI

````yaml /api-reference/openapi.yaml post /api/viz/execute/
openapi: 3.0.3
info:
  title: Console API
  version: 1.0.0
  description: Central control plane API for the Dataerai platform.
servers:
  - url: https://{server}
    description: Your Dataerai deployment (the API is served under /api)
    variables:
      server:
        default: your-deployment.dataerai.com
        description: Host of your Dataerai deployment
security: []
paths:
  /api/viz/execute/:
    post:
      tags:
        - api
      description: |-
        POST /viz/execute — full viz pipeline.

        validate → plan → execute; returns the execution plan plus a
        Plotly figure envelope (``data``/``layout``/``config``). Executor
        lookup follows the plan's ``mode``.

        Error statuses: 400 (validation failure), 410 (cached result no
        longer available), 413 (result exceeds the row/byte ceiling), 429
        (async-job quota exceeded), 501 (mode / artifact / source format
        not supported by this server), 504 (query exceeded the execution
        budget).

        Same authentication, visibility, and readiness rules as the other
        viz endpoints (e.g. POST /viz/safe-viz-spec/validate/).
      operationId: api_viz_execute_create
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties: {}
          application/x-www-form-urlencoded:
            schema:
              type: object
              additionalProperties: {}
          multipart/form-data:
            schema:
              type: object
              additionalProperties: {}
      responses:
        '200':
          content:
            application/json:
              schema:
                type: object
                additionalProperties: {}
          description: ''
      security:
        - cookieAuthCsrfExempt: []
components: {}

````