> For the complete documentation index, see [llms.txt](https://docs.wetez.io/wetez/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.wetez.io/wetez/developer/storage/pin_update.md).

# pin\_update

## /api/v0/pin/update

Update a recursive pin.

### REQUEST

{% tabs %}
{% tab title="Syntax" %}

```bash
curl "https://mainnet-rpc.wetez.io/ipfs/$AdminKey/api/v0/pin/update?arg=<from-path>&arg=<to-path>&unpin=true" \
    -X POST
```

{% endtab %}

{% tab title="Example" %}

```bash
curl "https://mainnet-rpc.wetez.io/ipfs/$AdminKey/api/v0/pin/update?arg=QmbLfeStdYuXk6AebVuADBTZ1fT77XtPspChaNi7NiQB4u&arg=QmbTMDxR4agFCsffLBTJsdjhqCk72NEWxR4bBtKrd55oEw" \
    -X POST
```

{% endtab %}
{% endtabs %}

#### REQUEST PARAMS

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

### RESPONSE

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

#### BODY

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