Cube Dev Overview API

openapi: 3.1.0
info:
  title: Cube Dev Overview API
  version: '2026-10-11'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-10-11: 3 operation(s) read from 2 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; Cube Dev has published no machine-readable contract that the
    pipeline could find. Engine: local.'
  x-evidence-tiers:
    code-example: 15
    documentation: 8
    pages-with-code: 8
    pages-read: 8
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-10-11'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://docs.cube.dev/reference/core-data-apis/rest-api
  - https://docs.cube.dev/reference/core-data-apis/sql-api
  x-docs-section: core-data-apis
servers:
- url: https://YOUR_CUBE_CLOUD_HOST
paths:
  /cubejs-api/v1/cubesql:
    post:
      operationId: post_cubejs_api_v1_cubesql
      tags:
      - Cubejs Api
      summary: POST /cubejs-api/v1/cubesql
      x-source: https://docs.cube.dev/reference/core-data-apis/sql-api
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostCubejsApiV1CubesqlRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl  -X POST  -H \"Authorization: TOKEN\"  -H \"Content-Type: application/json\"  -d '{\"query\": \"SELECT 123 AS value UNION\
          \ ALL SELECT 456 AS value UNION ALL SELECT 789 AS value\"}'  http://localhost:4000/cubejs-api/v1/cubesql \n See the /v1/cubesql endpoint\
          \ reference for more details. \n ​ Fundamentals \n In the SQL API, each cube or view from the data model \nis represented as a table.\
          \ Measures, dimensio"
  /cubejs-api/v1/{v1id}:
    get:
      operationId: get_cubejs_api_v1_v1id
      tags:
      - Cubejs Api
      summary: GET /cubejs-api/v1/load
      x-source: https://docs.cube.dev/reference/core-data-apis/rest-api
      parameters:
      - name: v1id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl  -H \"Authorization: TOKEN\"  -G  --data-urlencode 'query={ \n \"dimensions\": [ \n \"users.state\", \n \"users.city\"\
          , \n \"orders.status\" \n ], \n \"measures\": [ \n \"orders.count\" \n ], \n \"filters\": [ \n { \n \"member\": \"users.state\", \n\
          \ \"operator\": \"notEquals\", \n \"values\": [\"us-wa\"] \n } \n ], \n \"timeDimensions\": [ \n { \n \"dimension\": \"orders.created_at\"\
          , \n \"dateRange\": [\"2020-01-01\", \"2021-01-01\"] \n } \n ], \n \"lim"
        collapsed_from: 2 example path(s) differing only at v1Id
  /v1/{v1id}:
    get:
      operationId: get_v1_v1id
      tags:
      - Api
      summary: Load data via the REST (JSON) API
      x-source: https://docs.cube.dev/reference/core-data-apis/rest-api
      parameters:
      - name: v1id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
        collapsed_from: 2 example path(s) differing only at v1Id
security:
- bearer: []
components:
  schemas:
    PostCubejsApiV1CubesqlRequest:
      type: object
      properties:
        query:
          type: string
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
tags:
- name: Api
- name: Cubejs Api