webhooks.update

Change a webhook's URL, type or filters.

Details

Endpoint: PUT /v0/webhooks/:webhookID
Credits: 10
Rate class: Light. Counts against your light requests per second.

Send only the fields you want to change; accountAddresses replaces the whole list. The new filter applies from the next checkpoint. Costs 10 credits.

Parameters

Name	Type	Description
webhookIDrequired	string	The webhook id.
webhookURL	string	Public https URL that receives POSTs. Private and loopback addresses are refused.
webhookType	string	enhanced = parsed transactions (default), raw = balance changes, events and object changes, discord = one sentence and a tide.ad link per transaction.One of "enhanced", "raw", "discord".
accountAddresses	array of string	Match transactions that touch any of these addresses. Up to your plan's limit.
transactionTypes	array of string	Only these transaction types (SWAP, TRANSFER, ...). Omit or use ANY for all.
txnStatus	string	Default all.One of "all", "success", "failed".
authHeader	string	Sent back to you as the Authorization header on every POST.
coinTypes	array of string	Coin types with a balance change.
eventTypes	array of string	Move event types: a full type with or without type parameters, a module prefix (0xpackage::module) or a package prefix (0xpackage). Up to 100 entries on Free, 1,000 on paid plans.
packages	array of string	Match transactions whose PTB called these packages: 0xpackage, 0xpackage::module or 0xpackage::module::function. Any version of the package matches, so pass the original id and upgrades are covered. Up to 100 entries on Free, 1,000 on paid plans.
objectIds	array of string	Match any change to these object ids: created, mutated, deleted, wrapped or unwrapped. Each delivered transaction carries matched.objects with the new version and kind. Up to 100 entries on Free, 1,000 on paid plans.
balanceAddresses	array of string	Match a balance change of these addresses, narrowed by coinTypes when given. Each delivered transaction carries matched.balances with the signed delta in the coin's smallest unit. Up to 100 entries on Free, 1,000 on paid plans.

Request

Send your key in the x-api-key header, or leave it out to use the keyless tier.

curl

curl -X PUT "https://api.tide.ad/v0/webhooks/00000000-0000-0000-0000-000000000000" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "content-type: application/json" \
  -d '{
  "txnStatus": "success"
}'

TypeScript

const res = await fetch("https://api.tide.ad/v0/webhooks/00000000-0000-0000-0000-000000000000", {
  method: "PUT",
  headers: {
    "x-api-key": process.env.TIDE_API_KEY!,
    "content-type": "application/json",
  },
  body: JSON.stringify({
    "txnStatus": "success"
  }),
});
const data = await res.json();

Response

No example response is available for this method yet.