# pin\_add

Pin objects to local storage.

#### REQUEST <a href="#request" id="request"></a>

```bash
curl "https://ipfs.krypc.io:5001/api/v0/pin/add?arg=<ipfs-path>&recursive=true&progress=<value>" \
    -X POST \
    -u "<API_KEY>:<API_KEY_SECRET>"
```

**REQUEST PARAMS**[**​**](https://docs.infura.io/networks/ipfs/http-api-methods/pin_add#request-params)

* `arg` *\[Required]* - Path to object(s) to be pinned.
* `recursive` *\[Optional]* - Recursively pin the object linked to by the specified object(s). The default is `true`.
* `progress` *\[Optional]* - Show progress.

#### RESPONSE[​](https://docs.infura.io/networks/ipfs/http-api-methods/pin_add#response) <a href="#response" id="response"></a>

On success, the call to this endpoint returns with 200 and the following body:

**BODY**[**​**](https://docs.infura.io/networks/ipfs/http-api-methods/pin_add#body)

```
{
  "Pins": ["QmSTkR1kkqMuGEeBS49dxVJjgHRMH6cUYa7D3tcHDQ3ea3"]
}
```

**RESULT FIELDS**[**​**](https://docs.infura.io/networks/ipfs/http-api-methods/pin_add#result-fields)

* `Pins` - An array of Pin hashes.