Refuel

Refuel Datasets API

The Datasets API from Refuel — 13 operation(s) for datasets.

GitHub OpenAPI

Operations 17

POST /datasets/url Get Presigned Url #
POST /datasets/infer_schema Infer Schema #
POST /datasets/ingest Ingest Dataset #
GET /datasets Get Datasets #
GET /datasets/{dataset_id} Get Items From Dataset #
DELETE /datasets/{dataset_id} Delete Dataset #
PATCH /datasets/{dataset_id} Update Dataset #
GET /datasets/{dataset_id}/projects Get Dataset Projects #
POST /datasets/{dataset_id}/projects/{project_id} Add Project To Dataset #
DELETE /datasets/{dataset_id}/projects/{project_id} Delete Project From Dataset #
GET /datasets/{dataset_id}/items/{item_id} Get Item From Dataset #
DELETE /datasets/{dataset_id}/items/{item_id} Delete Item From Dataset #
POST /datasets/{dataset_id}/items Add Items To Dataset #
POST /datasets/{dataset_id}/exports Export Dataset #
GET /datasets/{dataset_id}/exports/{export_id} Download Dataset #
POST /datasets/{dataset_id}/sample Sample Dataset #
POST /datasets/{dataset_id}/append Append Dataset #

Documentation

📖
APIReference
https://cloud-api.refuel.ai/docs
📖
Documentation
https://docs.refuel.ai
📖
GettingStarted
https://docs.refuel.ai/quickstart

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/refuel-ai/refs/heads/main/openapi/refuel-ai-datasets-api-openapi.yml

Other Resources

🔗
OpenAPIOriginal
https://raw.githubusercontent.com/api-evangelist/refuel-ai/refs/heads/main/openapi/_original/refuel-ai-cloud-api-openapi.json
🔗
DataModel
https://raw.githubusercontent.com/api-evangelist/refuel-ai/refs/heads/main/data-model/refuel-ai-data-model.yml
🔗
ErrorCatalog
https://raw.githubusercontent.com/api-evangelist/refuel-ai/refs/heads/main/errors/refuel-ai-problem-types.yml
🔗
Conventions
https://raw.githubusercontent.com/api-evangelist/refuel-ai/refs/heads/main/conventions/refuel-ai-conventions.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/refuel-ai-datasets-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

refuel-ai-datasets-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Fast Datasets API
  version: 0.1.0
tags:
- name: Datasets
paths:
  /datasets/url:
    post:
      summary: Get Presigned Url
      operationId: get_presigned_url_datasets_url_post
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResponseModel'
      security:
      - HTTPBearer: []
      tags:
      - Datasets
  /datasets/infer_schema:
    post:
      summary: Infer Schema
      operationId: infer_schema_datasets_infer_schema_post
      parameters:
      - required: false
        schema:
          type: string
          title: Integration Id
        name: integration_id
        in: query
      - required: false
        schema:
          type: string
          title: Source Path
        name: source_path
        in: query
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResponseModel'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - HTTPBearer: []
      tags:
      - Datasets
  /datasets/ingest:
    post:
      summary: Ingest Dataset
      operationId: ingest_dataset_datasets_ingest_post
      parameters:
      - required: false
        schema:
          type: string
          title: S3 Path
        name: s3_path
        in: query
      - required: false
        schema:
          type: string
          title: Dataset Name
        name: dataset_name
        in: query
      - required: false
        schema:
          type: string
          title: Project Id
        name: project_id
        in: query
      - required: false
        schema:
          type: boolean
          title: Redact Pii
          default: false
        name: redact_pii
        in: query
      - required: false
        schema:
          type: string
          title: Ref Dataset Id
        name: ref_dataset_id
        in: query
      - required: false
        schema:
          type: string
          title: Append Dataset Id
        name: append_dataset_id
        in: query
      requestBody:
        content:
          application/json:
            schema:
              type: object
              title: Schema Dict
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResponseModel'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - HTTPBearer: []
      tags:
      - Datasets
  /datasets:
    get:
      summary: Get Datasets
      operationId: get_datasets_datasets_get
      parameters:
      - required: false
        schema:
          type: string
          title: Project Id
        name: project_id
        in: query
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResponseModel_List_'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - HTTPBearer: []
      tags:
      - Datasets
  /datasets/{dataset_id}:
    get:
      summary: Get Items From Dataset
      operationId: get_items_from_dataset_datasets__dataset_id__get
      parameters:
      - required: true
        schema:
          type: string
          title: Dataset Id
        name: dataset_id
        in: path
      - required: false
        schema:
          type: integer
          title: Offset
          default: 0
        name: offset
        in: query
      - required: false
        schema:
          type: integer
          title: Max Items
          default: 10
        name: max_items
        in: query
      - required: false
        schema:
          items:
            type: string
          type: array
          title: Filters
        name: filters
        in: query
      - required: false
        schema:
          items:
            type: string
          type: array
          title: Order Bys
        name: order_bys
        in: query
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResponseModel'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - HTTPBearer: []
      tags:
      - Datasets
    delete:
      summary: Delete Dataset
      operationId: delete_dataset_datasets__dataset_id__delete
      parameters:
      - required: true
        schema:
          type: string
          title: Dataset Id
        name: dataset_id
        in: path
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResponseModel_ChangeResourceResponse_'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - HTTPBearer: []
      tags:
      - Datasets
    patch:
      summary: Update Dataset
      operationId: update_dataset_datasets__dataset_id__patch
      parameters:
      - required: true
        schema:
          type: string
          title: Dataset Id
        name: dataset_id
        in: path
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateDatasetRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResponseModel'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - HTTPBearer: []
      tags:
      - Datasets
  /datasets/{dataset_id}/projects:
    get:
      summary: Get Dataset Projects
      operationId: get_dataset_projects_datasets__dataset_id__projects_get
      parameters:
      - required: true
        schema:
          type: string
          title: Dataset Id
        name: dataset_id
        in: path
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResponseModel'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - HTTPBearer: []
      tags:
      - Datasets
  /datasets/{dataset_id}/projects/{project_id}:
    post:
      summary: Add Project To Dataset
      operationId: add_project_to_dataset_datasets__dataset_id__projects__project_id__post
      parameters:
      - required: true
        schema:
          type: string
          title: Project Id
        name: project_id
        in: path
      - required: true
        schema:
          type: string
          title: Dataset Id
        name: dataset_id
        in: path
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResponseModel'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - HTTPBearer: []
      tags:
      - Datasets
    delete:
      summary: Delete Project From Dataset
      operationId: delete_project_from_dataset_datasets__dataset_id__projects__project_id__delete
      parameters:
      - required: true
        schema:
          type: string
          title: Project Id
        name: project_id
        in: path
      - required: true
        schema:
          type: string
          title: Dataset Id
        name: dataset_id
        in: path
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResponseModel_ChangeResourceResponse_'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - HTTPBearer: []
      tags:
      - Datasets
  /datasets/{dataset_id}/items/{item_id}:
    get:
      summary: Get Item From Dataset
      operationId: get_item_from_dataset_datasets__dataset_id__items__item_id__get
      parameters:
      - required: true
        schema:
          type: string
          title: Item Id
        name: item_id
        in: path
      - required: true
        schema:
          type: string
          title: Dataset Id
        name: dataset_id
        in: path
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResponseModel'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - HTTPBearer: []
      tags:
      - Datasets
    delete:
      summary: Delete Item From Dataset
      operationId: delete_item_from_dataset_datasets__dataset_id__items__item_id__delete
      parameters:
      - required: true
        schema:
          type: string
          title: Item Id
        name: item_id
        in: path
      - required: true
        schema:
          type: string
          title: Dataset Id
        name: dataset_id
        in: path
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResponseModel'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - HTTPBearer: []
      tags:
      - Datasets
  /datasets/{dataset_id}/items:
    post:
      summary: Add Items To Dataset
      operationId: add_items_to_dataset_datasets__dataset_id__items_post
      parameters:
      - required: true
        schema:
          type: string
          title: Dataset Id
        name: dataset_id
        in: path
      requestBody:
        content:
          application/json:
            schema:
              items:
                type: object
              type: array
              title: Items
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResponseModel'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - HTTPBearer: []
      tags:
      - Datasets
  /datasets/{dataset_id}/exports:
    post:
      summary: Export Dataset
      description: Exports dataset to S3 and emails the user a link to the S3 object
      operationId: export_dataset_datasets__dataset_id__exports_post
      parameters:
      - required: true
        schema:
          type: string
          title: Dataset Id
        name: dataset_id
        in: path
      - required: false
        schema:
          type: string
          title: Task Id
        name: task_id
        in: query
      - required: false
        schema:
          type: string
          title: Email Address
        name: email_address
        in: query
      - required: false
        schema:
          type: boolean
          title: Include Uuid
          default: false
        name: include_uuid
        in: query
      - required: false
        schema:
          type: boolean
          title: Include Labels
          default: false
        name: include_labels
        in: query
      - required: false
        schema:
          type: string
          title: Task Run Id
        name: task_run_id
        in: query
      - required: false
        schema:
          items:
            type: string
          type: array
          title: Filters
        name: filters
        in: query
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResponseModel'
        '202':
          description: Accepted. Dataset export in progress.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResponseModel'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - HTTPBearer: []
      tags:
      - Datasets
  /datasets/{dataset_id}/exports/{export_id}:
    get:
      summary: Download Dataset
      operationId: download_dataset_datasets__dataset_id__exports__export_id__get
      parameters:
      - required: true
        schema:
          type: string
          title: Export Id
        name: export_id
        in: path
      - required: true
        schema:
          type: string
          title: Dataset Id
        name: dataset_id
        in: path
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResponseModel'
        '202':
          description: Datset export is still in progress.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResponseModel'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - HTTPBearer: []
      tags:
      - Datasets
  /datasets/{dataset_id}/sample:
    post:
      summary: Sample Dataset
      operationId: sample_dataset_datasets__dataset_id__sample_post
      parameters:
      - required: true
        schema:
          type: string
          title: Dataset Id
        name: dataset_id
        in: path
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SamplingParams'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResponseModel'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - HTTPBearer: []
      tags:
      - Datasets
  /datasets/{dataset_id}/append:
    post:
      summary: Append Dataset
      operationId: append_dataset_datasets__dataset_id__append_post
      parameters:
      - required: true
        schema:
          type: string
          title: Dataset Id
        name: dataset_id
        in: path
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AppendDatasetRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResponseModel'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - HTTPBearer: []
      tags:
      - Datasets
components:
  schemas:
    SamplingType:
      type: string
      enum:
      - random
      - stratified
      - sorted
      title: SamplingType
      description: An enumeration.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    AppendDatasetRequest:
      properties:
        source_path:
          type: string
          title: Source Path
        redact_pii:
          type: boolean
          title: Redact Pii
      type: object
      required:
      - source_path
      - redact_pii
      title: AppendDatasetRequest
    SamplingParams:
      properties:
        sample_name:
          type: string
          title: Sample Name
        sample_type:
          $ref: '#/components/schemas/SamplingType'
        sample_size:
          type: integer
          title: Sample Size
        column:
          type: string
          title: Column
        filters:
          items:
            type: string
          type: array
          title: Filters
          default: []
        sort_direction:
          type: string
          title: Sort Direction
          default: DESC
        dataset_id:
          type: string
          title: Dataset Id
      type: object
      required:
      - sample_type
      - sample_size
      title: SamplingParams
    UpdateDatasetRequest:
      properties:
        name:
          type: string
          title: Name
        scheduled_ids:
          items:
            type: string
          type: array
          title: Scheduled Ids
      type: object
      title: UpdateDatasetRequest
    ResponseModel_ChangeResourceResponse_:
      properties:
        success:
          type: boolean
          title: Success
          default: true
        error_msg:
          type: string
          title: Error Msg
        data:
          $ref: '#/components/schemas/ChangeResourceResponse'
        count:
          type: integer
          title: Count
      type: object
      title: ResponseModel[ChangeResourceResponse]
    ChangeResourceResponse:
      properties:
        success:
          type: boolean
          title: Success
        error:
          type: string
          title: Error
          default: ''
      type: object
      required:
      - success
      title: ChangeResourceResponse
    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
    ResponseModel:
      properties:
        success:
          type: boolean
          title: Success
          default: true
        error_msg:
          type: string
          title: Error Msg
        data:
          title: Data
        count:
          type: integer
          title: Count
      type: object
      title: ResponseModel
    ResponseModel_List_:
      properties:
        success:
          type: boolean
          title: Success
          default: true
        error_msg:
          type: string
          title: Error Msg
        data:
          items: {}
          type: array
          title: Data
        count:
          type: integer
          title: Count
      type: object
      title: ResponseModel[List]
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer