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

# Post Dataset

> Creates a dataset. New columns are added automatically on write.

Load rows with `POST /datasets/bulk?dataset_id=...`.

Full guide with examples: [Tables guide](/api-reference/connect/bulk/tables)



## OpenAPI

````yaml /api-reference/bulk-openapi.json post /bulk_ingest/datasets
openapi: 3.1.0
info:
  title: Rippit Bulk API
  version: 2.0.0
servers:
  - url: https://integrations.maestroqa.com/api/v2
security:
  - bearer: []
paths:
  /bulk_ingest/datasets:
    post:
      tags:
        - bulk_ingest
      summary: Post Dataset
      description: >-
        Creates a dataset. New columns are added automatically on write.


        Load rows with `POST /datasets/bulk?dataset_id=...`.


        Full guide with examples: [Tables
        guide](/api-reference/connect/bulk/tables)
      operationId: post_dataset_bulk_ingest_datasets_post
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DatasetInit'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DatasetInitResult'
        '400':
          description: Bad Request
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    DatasetInit:
      properties:
        name:
          type: string
          maxLength: 128
          minLength: 1
          title: Name
          description: Any label, e.g. `Accounts (billing)`.
        description:
          type: string
          maxLength: 2000
          title: Description
          description: What the table holds, shown in Rippit.
          default: ''
        columns:
          items:
            $ref: '#/components/schemas/DatasetColumn'
          type: array
          minItems: 1
          title: Columns
        pkey_cols:
          items:
            type: string
          type: array
          title: Pkey Cols
          description: Columns that identify a row; re-uploads replace matching rows.
        append_only_dataset:
          type: boolean
          title: Append Only Dataset
          description: 'Required when `pkey_cols` is empty: every uploaded row is kept.'
          default: false
        updated_at_col:
          anyOf:
            - type: string
            - type: 'null'
          title: Updated At Col
        mode:
          type: string
          enum:
            - adhoc
            - ongoing
          title: Mode
          description: adhoc = one-off dump, ongoing = cron upserts.
          default: ongoing
      type: object
      required:
        - name
        - columns
      title: DatasetInit
    DatasetInitResult:
      properties:
        dataset_id:
          type: integer
          title: Dataset Id
        status:
          type: string
          enum:
            - created
            - exists
          title: Status
      type: object
      required:
        - dataset_id
        - status
      title: DatasetInitResult
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    DatasetColumn:
      properties:
        column:
          type: string
          maxLength: 128
          pattern: ^[a-zA-Z_][a-zA-Z0-9_]*$
          title: Column
        type:
          type: string
          title: Type
          description: >-
            Column type: int / float / string / bool / datetime / list<element:
            …>.
      type: object
      required:
        - column
        - type
      title: DatasetColumn
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    bearer:
      type: http
      scheme: bearer

````

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