Console

PATCHUpdate Address Set

Webhook APIhttps://web3.nodit.io/v1/webhook/address-sets/1788439512345678901

API for updating the name and description of an Address Set. The address format (addressFormat) cannot be changed. Name and description can be updated even while an import is in progress (IMPORTING).

At least one of name and description must be provided. If both are missing, 400 MISSING_REQUIRED_PARAMETER is returned.

Path Parameters
addressSetIdstringrequired

Parameter that specifies the addressSetId assigned to the Address Set. Use the addressSetId returned when the Address Set was created. It is a 19-digit number but is returned as a string in JSON. Parsing it as a number in JavaScript or similar environments loses precision, so always handle it as a string.

Request Body
namestring

New name of the Address Set. Up to 128 characters; duplicate names are allowed.

descriptionstring

New description of the Address Set. Up to 512 characters; pass an empty string ("") to clear the description.

Responses
addressSetIdstringrequired

Field indicating the addressSetId assigned to the Address Set. The addressSetId is a unique value that identifies the Address Set and is used to retrieve, update, or delete it. It is a 19-digit number but is returned as a string in JSON. Parsing it as a number in JavaScript or similar environments loses precision, so always handle it as a string.

예: 1788439512345678901

namestringrequired

Field indicating the name of the Address Set. Up to 128 characters.

예: exchange-hot-wallets

descriptionstringrequired

Field indicating the description of the Address Set. Up to 512 characters; an empty string ("") for a set without a description.

예: Hot wallets monitored for deposits

addressFormatstring (enum)required

Field indicating the format of addresses stored in the Address Set. Either EVM or TRON; it cannot be changed after creation.

예: EVM

statusstring (enum)required

Field indicating the status of the Address Set. READY means addresses can be changed and the set can be attached to Webhooks; IMPORTING means a CSV import is in progress. While the status is IMPORTING, addresses cannot be changed and the set cannot be attached to a Webhook (name and description can still be updated). A deleted set stops being retrievable immediately after deletion (404), so no separate deletion status appears in responses.

예: READY

addressCountintegerrequired

Field indicating the total number of addresses stored in the Address Set.

예: 100000

webhookCountintegerrequired

Field indicating the number of Webhooks currently using this Address Set. The set cannot be deleted when this value is 1 or more.

예: 0

createdAtstring (date-time)required

Indicates when the Address Set was created. This field is returned in ISO 8601 format.

예: 2026-07-01T00:00:00.000Z

updatedAtstring (date-time)required

Indicates when the Address Set was last modified. This field is returned in ISO 8601 format.

예: 2026-07-01T00:00:00.000Z

X-API-KEY
Request
cURL
curl -X PATCH "https://web3.nodit.io/v1/webhook/address-sets/1788439512345678901" \
  -H "X-API-KEY: {YOUR_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "exchange-hot-wallets-v2",
  "description": "Hot wallets monitored for deposits (updated)"
}'
Response
Example · 200
{
  "addressSetId": "1788439512345678901",
  "name": "exchange-hot-wallets-v2",
  "description": "Hot wallets monitored for deposits (updated)",
  "addressFormat": "EVM",
  "status": "READY",
  "addressCount": 100000,
  "webhookCount": 0,
  "createdAt": "2026-07-01T00:00:00.000Z",
  "updatedAt": "2026-07-02T00:00:00.000Z"
}

Last updated