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

# `pin_add`

## `/api/v0/pin/add`[​](#apiv0pinadd "Direct link to apiv0pinadd")

Pin objects to local storage.

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

- Syntax
- Example

```
curl "https://ipfs.infura.io:5001/api/v0/pin/add?arg=<ipfs-path>&recursive=true&progress=<value>" \
  -X POST \
  -u "<YOUR-API-KEY>:<YOUR-API-KEY-SECRET>"

```

```
curl "https://ipfs.infura.io:5001/api/v0/pin/add?arg=QmfQ5QAjvg4GtA3wg3adpnDJug8ktA1BxurVqBD8rtgVjM" \
  -X POST \
  -u "<YOUR-API-KEY>:<YOUR-API-KEY-SECRET>"

```

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

- `arg` _[Required]_ - Path to objects to be pinned.
- `recursive` _[Optional]_ - Recursively pin the object linked to by the specified objects. The default is `true`.
- `progress` _[Optional]_ - Show progress.

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

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

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

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

```

#### Result fields[​](#result-fields "Direct link to Result fields")

- `Pins` - An array of Pin hashes.