ZEzerion
subscriptions to transactions

Update chain IDs within subscription

Updates the chains a subscription covers. The chain IDs you send replace the existing list rather than adding to it.

See also: Resource IDs

patch/v1/tx-subscriptions/{subscription_id}/chain_ids

Request

  • Base URL
    https://api.zerion.io
  • URL
    https://api.zerion.io/v1/tx-subscriptions/{subscription_id}/chain_ids
  • Auth
    HTTP basic

Path parameters

subscription_idstring required
Example:77e77447-1586-40e8-a75b-467ef939a0b1

ID of the subscription.

Request body

chain_idsstring[]

Chain IDs to replace the subscription's current chain list with. Only chains reporting both supports_transactions and supports_positions in the flags of GET /v1/chains/ are accepted here. Naming a chain that fails that gate returns 400 rather than an empty result, with detail reading chain <id> does not support transactions. That detail names the endpoint's capability rather than the flag that failed, so bob is refused with chain bob does not support transactions even though it reports supports_transactions. What it lacks is supports_positions. Leave the list empty to cover every chain that passes the gate. Chains that fail it are left out silently, with no error and no meta signal.

Example request

{
  "chain_ids": [
    "ethereum"
  ]
}

Response

Chain IDs updated.

Changes

No recorded changes to this operation across all 3 revisions of this API.