> For the complete documentation index, see [llms.txt](/llms.txt).

# `dag_import`

## `/api/v0/dag/import`[​](#apiv0dagimport "Direct link to apiv0dagimport")

Imports all blocks present in supplied [Content Address aRchive (CAR) files](https://ipld.io/specs/transport/car/). The command recursively pins the root specified in the `.car` file headers, unless `pin-roots` is set to `false`.

warning

You can't pin multiple DAG roots using this endpoint. For example, if supplying multiple `.car` files in the same request. If you try, you'll receive the `only one dag root can be pinned per request` error.

### Request[​](#request "Direct link to Request")

- Syntax
- Example

```
curl "https://ipfs.infura.io:5001/api/v0/dag/import?pin-roots=false&allow-big-block=false" \
  -X POST \
  -u "<YOUR-API-KEY>:<YOUR-API-KEY-SECRET>" \
  -H "Content-Type: multipart/form-data" \
  -F file=@"<file>"

```

```
curl "https://ipfs.infura.io:5001/api/v0/dag/import?pin-roots=true&silent=<value>&stats=<value>&allow-big-block=false" \
  -X POST \
  -u "<YOUR-API-KEY>:<YOUR-API-KEY-SECRET>" \
  -H "Content-Type: multipart/form-data" \
  -F file=@"/sample.car"

```

#### Request parameters[​](#request-parameters "Direct link to Request parameters")

- `file` : _string_ - path to the `.car` file.
- `pin-roots` : _boolean_ - pin the root listed in the .car headers after importing. The default is `true`. Only one DAG root can be pinned per request.
- `silent` : _boolean_ - no output.
- `stats`: _boolean_ - output statistics.
- `allow-big-block`: _boolean_ - disable the block size check and allow the creation of blocks bigger than 1 MiB. The default is `false`. Bigger blocks won't be transferable over the standard bitswap.

### Response[​](#response "Direct link to Response")

On success, the call to this endpoint returns a `200` response with the following body:

#### Body[​](#body "Direct link to Body")

```
{
  "Root": {
    "Cid": {
      "/": "<cid-string>"
    },
    "PinErrorMsg": "<string>"
  },
  "Stats": {
    "BlockBytesCount": "<uint64>",
    "BlockCount": "<uint64>"
  }
}

```