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

# preview Admin Canvas Dataset

> Requires a currently verified platform administrator, not an organization administrator or ordinary Pro subscriber. Personal API keys need the explicit sagemaker:publish scope. OAuth calls are checked against current account identity. No broker or training job is started.



## OpenAPI

````yaml /docs/api/openapi.json post /v1/admin/sagemaker/datasets/preview
openapi: 3.1.0
info:
  title: Quantura API
  version: 1.0.0
  description: >-
    Search markets and public datasets, download historical observations, create
    forecasts and inspect screener quantiles.
  contact:
    name: Quantura
    url: https://quantura.studio/contact
  license:
    name: Quantura API Terms
    url: https://quantura.studio/terms
servers:
  - url: https://quantura.studio/api
security:
  - bearerAuth: []
  - clerkOAuth:
      - openid
      - profile
      - email
tags:
  - name: Access
  - name: Forecast
  - name: Screener
  - name: Admin Canvas
  - name: Search
  - name: Download
  - name: Scout
paths:
  /v1/admin/sagemaker/datasets/preview:
    servers:
      - url: https://quantura.studio/api
    post:
      tags:
        - Admin Canvas
      summary: preview Admin Canvas Dataset
      description: >-
        Requires a currently verified platform administrator, not an
        organization administrator or ordinary Pro subscriber. Personal API keys
        need the explicit sagemaker:publish scope. OAuth calls are checked
        against current account identity. No broker or training job is started.
      operationId: previewAdminCanvasDataset
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - csv
              properties:
                csv:
                  type: string
                  minLength: 1
                  maxLength: 3000000
                  description: >-
                    Original CSV contents, at most 3,000,000 UTF-8 bytes.
                    Original quantile columns and source bytes are preserved.
            example:
              csv: |
                date,P01,P50,P99
                2026-10-29,80,100,120
      responses:
        '200':
          description: CSV validated without publishing
          content:
            application/json:
              schema:
                type: object
              example:
                ok: true
                headers:
                  - date
                  - P01
                  - P50
                  - P99
                quantiles:
                  - 0.01
                  - 0.5
                  - 0.99
                kind: forecast
                row_count: 1
        '401':
          description: Authentication required
          content:
            application/json:
              schema:
                type: object
              example:
                ok: false
                error: api_key_missing
        '403':
          description: Verified platform admin and publish scope required
          content:
            application/json:
              schema:
                type: object
              example:
                ok: false
                error: admin_required
        '422':
          description: Invalid CSV or metadata
          content:
            application/json:
              schema:
                type: object
              example:
                ok: false
                error: canvas_columns_invalid
        '503':
          description: Repository unavailable
          content:
            application/json:
              schema:
                type: object
              example:
                ok: false
                error: canvas_github_unavailable
      security:
        - bearerAuth: []
        - clerkOAuth:
            - openid
            - profile
            - email
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: Clerk personal API key or legacy Quantura key
    clerkOAuth:
      type: oauth2
      description: >-
        Clerk authorization code with PKCE S256. Pass
        resource=https://quantura.studio on authorization and token requests.
        Paid Pro, enterprise or verified administrator API access is required.
      flows:
        authorizationCode:
          authorizationUrl: https://clerk.quantura.studio/oauth/authorize
          tokenUrl: https://clerk.quantura.studio/oauth/token
          refreshUrl: https://clerk.quantura.studio/oauth/token
          scopes:
            openid: Identify the Quantura account
            profile: Resolve the account profile
            email: Verify account email
            offline_access: Refresh access after expiry

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.