---
title: "POST /api/dataset-transfers/"
method: POST
path: "/api/dataset-transfers/"
tags: ["dataset-transfers"]
---

# POST /api/dataset-transfers/

`POST /api/dataset-transfers/`

## Request

- Base URL: `https://api.overmindlab.ai`
- URL: `https://api.overmindlab.ai/api/dataset-transfers/`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-Api-Key`
  - API key in cookie `sessionid`
  - API key in header `X-Api-Key`
  - HTTP bearer

## Request body

- TransferInputRequest
  - `filename` string
  - `size` integer
  - `sha256` string
  - `json_rows_field` string
  - `project` string, uuid, required
  - `request_key` string, required
  - `files` TransferFileInputRequest[]
    - `filename` string, required
    - `size` integer, required
    - `sha256` string, required
    - `json_rows_field` string
  - `dataset` string, uuid
  - `capability` string, uuid
  - `intent` 'train' | 'eval' | 'explore': * `train` - train * `eval` - eval * `explore` - explore
  - `brief` string
  - `split` integer
  - `split_position` 'head' | 'tail' | 'random': * `head` - head * `tail` - tail * `random` - random

## Response `201`

- Transfer
  - `id` string, uuid, required
  - `project_id` string, uuid, required
  - `request_key` string, required
  - `upload_id` string, uuid, required
  - `filename` string, required
  - `sha256` string, nullable, required
  - `files` TransferFile[], required
    - `filename` string, required
    - `size` integer, required
    - `sha256` string, required
    - `json_rows_field` string
    - `index` integer, required
    - `upload_id` string, uuid, required
    - `received` integer, required
    - `staging_available` boolean, required
    - `max_bytes` integer, required
  - `size` integer, required
  - `received` integer, required
  - `state` string, required
  - `staging_available` boolean, required
  - `next_action` string, required
  - `result` unknown, required
  - `chunk_bytes` integer, required
  - `max_bytes` integer, required
  - `dispatch` string, required
  - `updated_at` string, date-time, required
  - `published_at` string, date-time, nullable, required
  - `resource_uri` string, required

---

[API](https://skmtc.dev/overmindlab/apis/overmind-api.md) - [All operations](https://skmtc.dev/overmindlab/apis/overmind-api/llms.txt) - [OpenAPI document](https://skmtc.dev/overmindlab/apis/overmind-api/revisions/0ecfd39e80c6?raw)