> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ariacompute.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PIN Upload Dataset

> POST /v1/datasets for the PIN API. Upload a dataset using multipart/form-data with name, format, and file fields. Accepts up to MAX_BYTES.

Use this endpoint to upload your own dataset file. Submit a multipart/form-data request with the dataset name, format, and the file. The server accepts files up to a configured MAX\_BYTES limit and returns a 202 response while the dataset is being processed.

## Endpoint

```http theme={null}
POST /v1/datasets
```

## Authentication

Requires a valid `Authorization: Bearer <jwt-or-api-key>` header.

## Request Body

<ParamField body="name" type="string" required>
  Name for the uploaded dataset.
</ParamField>

<ParamField body="format" type="string" required>
  File format of the dataset, such as `jsonl`, `csv`, or `parquet`.
</ParamField>

<ParamField body="file" type="file" required>
  The dataset file to upload. Must not exceed the MAX\_BYTES limit.
</ParamField>

## Response

<ResponseField name="id" type="string">
  Unique identifier of the created dataset.
</ResponseField>

<ResponseField name="name" type="string">
  The name provided in the request.
</ResponseField>

<ResponseField name="status" type="string">
  Processing status, typically `processing`.
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST https://ariapin.example.com:8001/v1/datasets \
    -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." \
    -F "name=my-dataset" \
    -F "format=jsonl" \
    -F "file=@data.jsonl"
  ```
</RequestExample>

<ResponseExample>
  ```json 202 theme={null}
  {
    "code": 0,
    "data": {
      "id": "ds_xyz",
      "name": "my-dataset",
      "status": "processing"
    },
    "message": ""
  }
  ```
</ResponseExample>


## Related topics

- [PIN Dataset Catalog](/api-reference/pin/datasets/catalog.md)
- [PIN List Datasets](/api-reference/pin/datasets/list.md)
- [PIN Create Dataset from Catalog](/api-reference/pin/datasets/from-catalog.md)
- [PIN Get Dataset by ID](/api-reference/pin/datasets/get.md)
- [Create Training Job with PIN API](/api-reference/pin/jobs/create.md)