> ## 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 Create Dataset from Catalog

> POST /v1/datasets/from-catalog for the PIN API. Import a curated dataset by catalog ID with local or streaming access mode.

Use this endpoint to import a dataset from the curated catalog into your account. Specify the catalog entry and whether you want local storage or streaming access. The response is either an immediate 201 creation or a 202 acceptance if downloading is in progress.

## Endpoint

```http theme={null}
POST /v1/datasets/from-catalog
```

## Authentication

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

## Request Body

<ParamField body="catalog_id" type="string" required>
  Identifier of the dataset in the catalog.
</ParamField>

<ParamField body="access" type="string" required>
  Access mode: `local` or `stream`.
</ParamField>

## Response

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

<ResponseField name="name" type="string">
  Name of the dataset.
</ResponseField>

<ResponseField name="status" type="string">
  Current status, such as `ready` or `downloading`.
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST https://ariapin.example.com:8001/v1/datasets/from-catalog \
    -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." \
    -H "Content-Type: application/json" \
    -d '{"catalog_id":"ds_catalog_1","access":"local"}'
  ```
</RequestExample>

<ResponseExample>
  ```json 201 theme={null}
  {
    "code": 0,
    "data": {
      "id": "ds_abc",
      "name": "General Instruction Tuning",
      "status": "ready"
    },
    "message": ""
  }
  ```
</ResponseExample>


## Related topics

- [PIN Dataset Catalog](/api-reference/pin/datasets/catalog.md)
- [Create Evaluation](/api-reference/pin/evaluations/create.md)
- [Create Training Job with PIN API](/api-reference/pin/jobs/create.md)
- [PIN List Datasets](/api-reference/pin/datasets/list.md)
- [PIN Upload Dataset](/api-reference/pin/datasets/create.md)