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

---

[API](https://skmtc.net/pioneer/apis/brain-api.md) · [All operations](https://skmtc.net/pioneer/apis/brain-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pioneer/brain-api/revisions/31dfe831e079/schema)
