> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blockra.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Update a Payment Link — PATCH /payment-links/{id}

> Enable or disable a payment link. Requires payment_links:write.

Enables or disables a payment link. A disabled link stops accepting new payments. Requires the `payment_links:write` scope.

## Request

**`PATCH https://api.blockra.io/payment-links/{id}`**

### Path parameters

<ParamField path="id" type="string" required>
  The payment link ID (prefixed `plink_`).
</ParamField>

### Body parameters

<ParamField body="is_active" type="boolean" required>
  `true` to enable the link, `false` to disable it.
</ParamField>

## Response

Returns the updated payment link object.

<ResponseField name="id" type="string">
  The payment link ID.
</ResponseField>

<ResponseField name="is_active" type="boolean">
  The new active state.
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl https://api.blockra.io/payment-links/plink_7h8i9j0k1l2m3n4o \
    -X PATCH \
    -H "X-API-Key: bk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
    -H "Content-Type: application/json" \
    -d '{ "is_active": false }'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "data": {
      "id": "plink_7h8i9j0k1l2m3n4o",
      "label": "Pro plan",
      "amount": 49.00,
      "currency": "USD",
      "uses": 12,
      "is_active": false,
      "created_at": "2026-07-09T02:40:00.000Z"
    },
    "error": null
  }
  ```
</ResponseExample>