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

# `pin_update`

## `/api/v0/pin/update`[​](#apiv0pinupdate "Direct link to apiv0pinupdate")

Update a recursive pin.

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

- Syntax
- Example

```
curl "https://ipfs.infura.io:5001/api/v0/pin/update?arg=<from-path>&arg=<to-path>&unpin=true" \
  -X POST \
  -u "<YOUR-API-KEY>:<YOUR-API-KEY-SECRET>"

```

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

```

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

- `arg` _[Required]_ - Path to old object.
- `arg` _[Required]_ - Path to a new object to be pinned.
- `unpin` _[Optional]_ - Remove the old pin. The default is `true.`

### 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": [
    "string"
  ]
}

```