---
title: "Update alert"
method: PUT
path: "/v4/subscription/{id}"
tags: ["Subscriptions"]
---

# Update alert

`PUT /v4/subscription/{id}`

## Request

- Base URL: `https://api.tatum.io`
- URL: `https://api.tatum.io/v4/subscription/{id}`
- Auth: API key in header `x-api-key`

> This endpoint is compatible with our deprecated v3 Notifications product. To use it with v3, simply replace 'v4' with 'v3' in the request URL.

<p style="display: none">/v4/subscription/{id}</p>
<p>Update alert.</p>

## Path parameters

- `id` string, required

## Request body

- object
  - `url` string: URL of the endpoint, where HTTP POST request will be sent.
  - `mempool` boolean: Flag indicating whether the alert should include mempool transactions. Only available on BTC blockchain.
  - `paused` boolean: Flag indicating whether the alert should be paused or resumed.
  - `conditions` NotificationCondition[]: List of conditions that must be met for the notification to be sent. Supported only on the chains GET /v4/subscription/chains reports with finality true.
    - `field` 'value' | 'contractAddress' | 'from' | 'to' | 'tokenId' | 'tokenMetadata.type' | 'tokenMetadata.symbol', required: Field to evaluate.
    - `operator` '>' | '>=' | '<' | '<=' | '==' | '!=', required: Comparison operator.
    - `value` string, required: Value to compare against.
  - `finality` 'confirmed' | 'final': Choose between speed (confirmed) and block confirmations on chain (final). Supported only on the chains GET /v4/subscription/chains reports with finality true.
  - `templateId` 'enriched' | 'enriched_with_raw_data' | 'legacy' | '68b825be1aa0da023d4c9018 (custom template)': Configure the response format. Supported only on the chains GET /v4/subscription/chains reports with finality true.

## Response `204`

OK

## Other responses

- `400`: Bad Request
- `401`: Unauthorized. Not valid or inactive subscription key present in the HTTP Header.
- `500`: Internal server error. There was an error on the server during the processing of the request.

---

[API](https://skmtc.dev/tatum/apis/blockchain-notifications.md) - [All operations](https://skmtc.dev/tatum/apis/blockchain-notifications/llms.txt) - [OpenAPI document](https://skmtc.dev/tatum/apis/blockchain-notifications/revisions/925883906ce5?raw)