---
title: "Push Dataset To Hub"
method: POST
path: "/felix/datasets/{name}/{version}/push-to-hub"
tags: ["felix", "datasets"]
---

# Push Dataset To Hub

`POST /felix/datasets/{name}/{version}/push-to-hub`

Push a specific dataset version to HuggingFace Hub.

Args:
    name: Dataset name.
    version: Version number to push (use "latest" for most recent).

Requires a HuggingFace API token with write access.
The dataset will be uploaded in Parquet format with metadata.

## Path parameters

- `name` string, required
- `version` string, required

## Request body

- HuggingFacePushRequest — Request to push dataset to HuggingFace Hub.
  - `repo_id` string, required — HuggingFace repo ID (e.g., 'user/dataset')
  - `private` boolean — Whether repo should be private
  - `commit_message` string, nullable — Commit message for the push
  - `hf_token` string, required — HuggingFace API token

## Response `200`

Successful Response

- PushDatasetToHubResponse — Response model for pushing dataset to HuggingFace Hub
  - `success` boolean, required
  - `url` string, required
  - `repo_id` string, required
  - `version` string, required
  - `message` string, required

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-24** `1cffaad2a921` — 1 warning, 1 info
  - removed the optional property `detail` from the response with the `422` status
  - added the required property `error` to the response with the `422` status

[Change history](https://skmtc.dev/pioneer/apis/brain-api/changes/felix/datasets/:name/:version/push-to-hub/post.md)

---

[API](https://skmtc.dev/pioneer/apis/brain-api.md) · [All operations](https://skmtc.dev/pioneer/apis/brain-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pioneer/apis/brain-api/revisions/1cffaad2a921?raw)