> ## 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.

# Create Export Job

> Exports the query's rows to files. Same body as /tables/{table_id}/query, without the row cap.

Poll GET /bulk/jobs/{job_id}. Returns 429 over the hourly/daily export or egress limits.



## OpenAPI

````yaml /api-reference/bulk-openapi.json post /bulk_export/tables
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_export/tables:
    post:
      tags:
        - bulk_export
      summary: Create Export Job
      description: >-
        Exports the query's rows to files. Same body as
        /tables/{table_id}/query, without the row cap.


        Poll GET /bulk/jobs/{job_id}. Returns 429 over the hourly/daily export
        or egress limits.
      operationId: create_export_job_bulk_export_tables_post
      parameters:
        - name: dataset_id
          in: query
          required: false
          schema:
            anyOf:
              - type: integer
              - type: 'null'
            description: From `POST /datasets`. Pass this or `table_id`.
            title: Dataset Id
          description: From `POST /datasets`. Pass this or `table_id`.
        - name: table_id
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: The Rippit table id, e.g. from MCP. Pass this or `dataset_id`.
            title: Table Id
          description: The Rippit table id, e.g. from MCP. Pass this or `dataset_id`.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ExportQuery'
      responses:
        '202':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BulkJob'
        '400':
          description: Bad Request
        '404':
          description: Not Found
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
        '429':
          description: Too Many Requests
components:
  schemas:
    ExportQuery:
      properties:
        select:
          anyOf:
            - items:
                $ref: '#/components/schemas/WorkspaceField'
              type: array
            - type: 'null'
          title: Select
          description: >-
            Columns, each optionally with `agg` (count, count_distinct, sum,
            avg, min, max) and `alias`. Leave out for every column.
        where:
          anyOf:
            - type: string
            - type: 'null'
          title: Where
          description: >-
            RipQL subset: `col op literal` with AND / OR, e.g. `n > 1 AND tier
            IN ('a', 'b')`.
        group_by:
          items:
            type: string
          type: array
          title: Group By
          default: []
        order_by:
          items:
            prefixItems:
              - type: string
              - type: boolean
            type: array
            maxItems: 2
            minItems: 2
          type: array
          title: Order By
          description: '`[column or alias, ascending]` pairs.'
          default: []
        limit:
          anyOf:
            - type: integer
              minimum: 1
            - type: 'null'
          title: Limit
          description: Leave out for every row.
        format:
          type: string
          enum:
            - parquet
            - csv
          title: Format
          description: csv is gzipped.
          default: parquet
      type: object
      title: ExportQuery
    BulkJob:
      properties:
        job_id:
          type: string
          title: Job Id
        kind:
          type: string
          enum:
            - conversation_blocks
            - dataset_rows
            - export
          title: Kind
        status:
          type: string
          enum:
            - awaiting_upload
            - queued
            - running
            - done
            - failed
          title: Status
        created_at:
          type: string
          format: date-time
          title: Created At
        result:
          anyOf:
            - $ref: '#/components/schemas/DatasetResult'
            - $ref: '#/components/schemas/ConversationResult'
            - type: 'null'
          title: Result
          description: 'Uploads: set once `done`.'
        files:
          items:
            $ref: '#/components/schemas/ExportFile'
          type: array
          title: Files
          description: 'Exports: set once `done`.'
        expires_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Expires At
          description: 'Exports: when `files` urls stop working.'
        error:
          anyOf:
            - type: string
            - type: 'null'
          title: Error
          description: Set once `failed`.
      type: object
      required:
        - job_id
        - kind
        - status
        - created_at
      title: BulkJob
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    WorkspaceField:
      properties:
        field:
          type: string
          title: Field
        agg:
          anyOf:
            - type: string
              enum:
                - sum
                - avg
                - max
                - min
                - count
                - count_distinct
                - stddev_pop
                - stddev_samp
            - type: 'null'
          title: Agg
        date_trunc:
          anyOf:
            - type: string
              enum:
                - minute
                - hour
                - day
                - week
                - month
                - year
            - type: 'null'
          title: Date Trunc
        alias:
          anyOf:
            - type: string
            - type: 'null'
          title: Alias
      additionalProperties: false
      type: object
      required:
        - field
      title: WorkspaceField
    DatasetResult:
      properties:
        rows_received:
          type: integer
          title: Rows Received
        rows_written:
          type: integer
          title: Rows Written
        rejected:
          items:
            $ref: '#/components/schemas/RejectedRow'
          type: array
          title: Rejected
          description: The first 100 rejected rows.
        table_url:
          anyOf:
            - type: string
            - type: 'null'
          title: Table Url
          description: Opens the table in Rippit.
        dataset_id:
          type: integer
          title: Dataset Id
          description: Dataset the rows landed in.
      type: object
      required:
        - rows_received
        - rows_written
        - dataset_id
      title: DatasetResult
    ConversationResult:
      properties:
        rows_received:
          type: integer
          title: Rows Received
        rows_written:
          type: integer
          title: Rows Written
        rejected:
          items:
            $ref: '#/components/schemas/RejectedRow'
          type: array
          title: Rejected
          description: The first 100 rejected rows.
        table_url:
          anyOf:
            - type: string
            - type: 'null'
          title: Table Url
          description: Opens the table in Rippit.
        source:
          type: string
          title: Source
          description: Conversation source the conversations landed in.
      type: object
      required:
        - rows_received
        - rows_written
        - source
      title: ConversationResult
    ExportFile:
      properties:
        url:
          type: string
          title: Url
          description: Presigned S3 GET.
        bytes:
          type: integer
          title: Bytes
      type: object
      required:
        - url
        - bytes
      title: ExportFile
    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
    RejectedRow:
      properties:
        row:
          type: integer
          title: Row
          description: 0-based line or row index in the upload.
        error:
          type: string
          title: Error
      type: object
      required:
        - row
        - error
      title: RejectedRow
  securitySchemes:
    bearer:
      type: http
      scheme: bearer

````

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