Skip to main content
PUT atomically replaces the entire address list for a subscription. All existing addresses are removed and the new list is applied in their place. Use this when you want to set the canonical list of addresses from an authoritative source. For incremental changes — adding a few addresses or removing specific ones — use PATCH instead.

​
Request

PUT /v1/subscriptions/:id/filters/addresses

​
Path parameters

​
id
string
required
The subscription ID (e.g. sub_2QkP9aB7xN...).

​
Body

A JSON array of address objects to set as the new filter list. Send an empty array [] to clear all addresses.
​
[].chainId
string
required
CAIP-2 chain identifier. Supported values: tron:mainnet, tron:nile, tron:shasta.
​
[].address
string
required
Base58check-encoded TRON address (starts with T).
curl -X PUT https://api.offthehook.dev/v1/subscriptions/sub_2QkP9aB7xN.../filters/addresses \
  -H "Authorization: Bearer oth_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[
    { "chainId": "tron:mainnet", "address": "TLsV52sRDL79HXGGm9yzwKibb6BeruhUzy" },
    { "chainId": "tron:mainnet", "address": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t" }
  ]'

​
Response

200 OK — the updated subscription resource with the new address list reflected in filters.addresses.
PUT removes all existing addresses before inserting the new list. If you send an empty array [], every address is cleared and no further webhooks will fire for that subscription until you add addresses again.

​
Errors

CodeHTTPDescription
not_found404The subscription ID does not exist or belongs to a different API key.
invalid_address400One or more addresses failed base58check validation.
invalid_chain400One or more chainId values are not recognized.
chain_not_enabled400The chainId is valid but not currently enabled on this account.
addresses_limit_exceeded400The provided array exceeds the per-request size limit.
unauthorized401The Authorization header is missing or the key is invalid.