Resume a paused subscription

curl --request POST \
  --url https://api.0xarchive.io/v1/webhooks/subscriptions/{id}/resume \
  --header 'X-API-Key: <api-key>'

const options = {method: 'POST', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.0xarchive.io/v1/webhooks/subscriptions/{id}/resume', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.0xarchive.io/v1/webhooks/subscriptions/{id}/resume"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("X-API-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "success": true,
  "data": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "endpoint_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "event_type": "market.liquidation",
    "filters": {
      "venue": "hyperliquid",
      "symbols": [
        "BTC",
        "ETH"
      ],
      "addresses": [
        "0x6b9e773128f453f5c2c60935ee2de2cbc5390a24"
      ],
      "params": {
        "max_age_s": 3600
      },
      "conditions": [
        {
          "metric": "notional_usd",
          "op": "greater_than_or_equal",
          "value": 100000
        }
      ],
      "min_notional_usd": 100000
    },
    "enabled": true,
    "created_at": "2023-11-07T05:31:56Z",
    "status": "active",
    "suppressed_count": 0,
    "last_suppressed_count": 0,
    "pause_message": "This rule was paused because the account reached its Pro plan limit of 50000 webhook deliveries in a day. The daily allowance resets at 2026-09-21 00:00 UTC, and a paused rule does not restart with it. Resume it with POST /v1/webhooks/subscriptions/resume.",
    "paused_at": "2023-11-07T05:31:56Z",
    "pause_reason": "deliveries_per_day_cap",
    "suppressed_first_at": "2023-11-07T05:31:56Z",
    "suppressed_last_at": "2023-11-07T05:31:56Z",
    "last_paused_at": "2023-11-07T05:31:56Z",
    "last_resumed_at": "2023-11-07T05:31:56Z",
    "last_pause_reason": "<string>",
    "last_suppressed_first_at": "2023-11-07T05:31:56Z",
    "last_suppressed_last_at": "2023-11-07T05:31:56Z"
  },
  "gap": {
    "paused_at": "2023-11-07T05:31:56Z",
    "resumed_at": "2023-11-07T05:31:56Z",
    "replay_window": {
      "start": "2023-11-07T05:31:56Z",
      "end": "2023-11-07T05:31:56Z"
    },
    "counted": true,
    "note": "<string>",
    "reason": "deliveries_per_day_cap",
    "reasons": [
      "<string>"
    ],
    "pause_message": "<string>",
    "suppressed_count": 0,
    "suppressed_first_at": "2023-11-07T05:31:56Z",
    "suppressed_last_at": "2023-11-07T05:31:56Z",
    "uncounted_subscriptions": 0
  },
  "note": "This subscription was already active, so nothing changed."
}

{
  "code": 400,
  "error": "Failed to deserialize query string: limit: invalid digit found in string",
  "error_code": "invalid_query_params",
  "request_id": "3f2a9c71-5b0e-4d68-9a4c-7e1d2b6f8a05"
}

{
  "code": 401,
  "error": "Missing or invalid API key. Provide X-API-Key header."
}

{
  "code": 404,
  "error": "Resource not found"
}

{
  "code": 409,
  "error": "You are still at today's delivery limit. This rule would pause again immediately. Resume after 2026-09-21 00:00 UTC.",
  "request_id": "3f2a9c71-5b0e-4d68-9a4c-7e1d2b6f8a05"
}

{
  "code": 429,
  "error": "Rate limit exceeded"
}

POST

https://api.0xarchive.io

webhooks

subscriptions

{id}

resume

Resume a paused subscription

curl --request POST \
  --url https://api.0xarchive.io/v1/webhooks/subscriptions/{id}/resume \
  --header 'X-API-Key: <api-key>'

const options = {method: 'POST', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.0xarchive.io/v1/webhooks/subscriptions/{id}/resume', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.0xarchive.io/v1/webhooks/subscriptions/{id}/resume"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("X-API-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "success": true,
  "data": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "endpoint_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "event_type": "market.liquidation",
    "filters": {
      "venue": "hyperliquid",
      "symbols": [
        "BTC",
        "ETH"
      ],
      "addresses": [
        "0x6b9e773128f453f5c2c60935ee2de2cbc5390a24"
      ],
      "params": {
        "max_age_s": 3600
      },
      "conditions": [
        {
          "metric": "notional_usd",
          "op": "greater_than_or_equal",
          "value": 100000
        }
      ],
      "min_notional_usd": 100000
    },
    "enabled": true,
    "created_at": "2023-11-07T05:31:56Z",
    "status": "active",
    "suppressed_count": 0,
    "last_suppressed_count": 0,
    "pause_message": "This rule was paused because the account reached its Pro plan limit of 50000 webhook deliveries in a day. The daily allowance resets at 2026-09-21 00:00 UTC, and a paused rule does not restart with it. Resume it with POST /v1/webhooks/subscriptions/resume.",
    "paused_at": "2023-11-07T05:31:56Z",
    "pause_reason": "deliveries_per_day_cap",
    "suppressed_first_at": "2023-11-07T05:31:56Z",
    "suppressed_last_at": "2023-11-07T05:31:56Z",
    "last_paused_at": "2023-11-07T05:31:56Z",
    "last_resumed_at": "2023-11-07T05:31:56Z",
    "last_pause_reason": "<string>",
    "last_suppressed_first_at": "2023-11-07T05:31:56Z",
    "last_suppressed_last_at": "2023-11-07T05:31:56Z"
  },
  "gap": {
    "paused_at": "2023-11-07T05:31:56Z",
    "resumed_at": "2023-11-07T05:31:56Z",
    "replay_window": {
      "start": "2023-11-07T05:31:56Z",
      "end": "2023-11-07T05:31:56Z"
    },
    "counted": true,
    "note": "<string>",
    "reason": "deliveries_per_day_cap",
    "reasons": [
      "<string>"
    ],
    "pause_message": "<string>",
    "suppressed_count": 0,
    "suppressed_first_at": "2023-11-07T05:31:56Z",
    "suppressed_last_at": "2023-11-07T05:31:56Z",
    "uncounted_subscriptions": 0
  },
  "note": "This subscription was already active, so nothing changed."
}

{
  "code": 400,
  "error": "Failed to deserialize query string: limit: invalid digit found in string",
  "error_code": "invalid_query_params",
  "request_id": "3f2a9c71-5b0e-4d68-9a4c-7e1d2b6f8a05"
}

{
  "code": 401,
  "error": "Missing or invalid API key. Provide X-API-Key header."
}

{
  "code": 404,
  "error": "Resource not found"
}

{
  "code": 409,
  "error": "You are still at today's delivery limit. This rule would pause again immediately. Resume after 2026-09-21 00:00 UTC.",
  "request_id": "3f2a9c71-5b0e-4d68-9a4c-7e1d2b6f8a05"
}

{
  "code": 429,
  "error": "Rate limit exceeded"
}

API key required. Send X-API-Key with this request. See REST authentication.

Shared request rules

Machine schema

Open the generated operation schema for machine-readable request and response details.

Authorizations

X-API-Key

string

header

required

API key for authentication. Get yours at https://0xarchive.io/dashboard

Path Parameters

string<uuid>

required

Subscription identifier.

Example:

"3c1f0a52-8d6b-4f0e-9b1a-6f2c4d8e9a10"

Response

The subscription, and the window it missed

API response for resuming one paused subscription.

success

boolean

Example:

true

data

object

A rule: one event type, one configuration, delivered to one endpoint.

Hide child attributes

data.id

string<uuid>

required

Subscription identifier.

data.endpoint_id

string<uuid>

required

Endpoint that receives this rule's deliveries.

data.event_type

string

required

Event type this rule subscribes to.

Example:

"market.liquidation"

data.filters

object

required

What a subscription matches on. Every key is checked against the event type's catalog declaration, so an unknown key, an undeclared parameter or a condition on an undeclared metric is refused rather than ignored. The stored config is the normalised form: venues and addresses lowercased, declared parameters filled in at their defaults, and operators written in their canonical spelling.

Hide child attributes

data.filters.venue

Venue or venues to match, from the event type's venues list. Accepts a single string, a pipe separated string or a list. Omit to match every covered venue.

Example:

"hyperliquid"

data.filters.symbols

string[]

Instrument symbols to match. Omit to match every symbol.

Example:

["BTC", "ETH"]

data.filters.addresses

string[]

Wallets to match, for an address scoped event type. Every address must already be on your watched list. Omit to match all of them.

Example:

[
  "0x6b9e773128f453f5c2c60935ee2de2cbc5390a24"
]

data.filters.params

object

Parameter values for the event type, keyed by the parameter names it declares. A declared parameter you leave out is stored at its default. A declared parameter may also be written at the top level of the config.

Example:

{ "max_age_s": 3600 }

data.filters.conditions

object[]

Conditions on the event's metrics, all of which must hold for a delivery. At most 16 per subscription.

Hide child attributes

data.filters.conditions.metric

string

required

A metric declared by the event type.

Example:

"notional_usd"

data.filters.conditions.op

enum<string>

required

Comparison to apply. Symbol spellings such as >= are accepted on the way in and stored in the canonical spelling shown here.

Available options:

greater_than,

greater_than_or_equal,

less_than,

less_than_or_equal,

equal,

not_equal,

between,

not_between,

in,

not_in,

contains,

not_contains,

starts_with,

ends_with,

before,

after,

is_empty,

is_not_empty

Example:

"greater_than_or_equal"

data.filters.conditions.value

any

What to compare against. A number, string, boolean or RFC 3339 timestamp for a single value comparison; a two entry [low, high] list for between and not_between; a non-empty list for in and not_in. Omitted for is_empty and is_not_empty.

Example:

100000

data.filters.min_notional_usd

number

Shorthand for a notional_usd at-or-above condition, kept for compatibility. It is stored as a condition, and it is mirrored back here as the loosest notional lower bound the config carries.

Example:

100000

data.enabled

boolean

required

Your own on and off switch. Resuming a paused rule never changes it.

Example:

true

data.created_at

string<date-time>

required

When the rule was created.

data.status

enum<string>

required

active is serving. auto_paused means delivery was paused for you and nothing is being sent; it stays paused until you resume it.

Available options:

active,

auto_paused

Example:

"active"

data.suppressed_count

integer<int64>

required

Matches observed but not delivered since the current pause began. A lower bound, not a total: occurrences no active rule asked for are never looked at.

Example:

0

data.last_suppressed_count

integer<int64>

required

Matches suppressed during the last pause that has already ended.

Example:

0

data.pause_message

string

Why this rule is paused and what clears it, in plain words. Present only while the rule is paused.

Example:

"This rule was paused because the account reached its Pro plan limit of 50000 webhook deliveries in a day. The daily allowance resets at 2026-09-21 00:00 UTC, and a paused rule does not restart with it. Resume it with POST /v1/webhooks/subscriptions/resume."

data.paused_at

string<date-time> | null

Start of the current gap. Null while the rule is serving.

data.pause_reason

string | null

Machine readable cause of the current pause, either deliveries_per_day_cap (the account reached its daily delivery limit) or plan_no_webhooks (the plan does not include webhook delivery). Null while the rule is serving. Render pause_message for people.

Example:

"deliveries_per_day_cap"

data.suppressed_first_at

string<date-time> | null

First suppressed match of the current pause.

data.suppressed_last_at

string<date-time> | null

Most recent suppressed match of the current pause.

data.last_paused_at

string<date-time> | null

Start of the last pause that has already ended.

data.last_resumed_at

string<date-time> | null

When that pause ended.

data.last_pause_reason

string | null

Cause of the last pause that has already ended, in the same vocabulary as pause_reason.

data.last_suppressed_first_at

string<date-time> | null

First suppressed match of that pause.

data.last_suppressed_last_at

string<date-time> | null

Most recent suppressed match of that pause.

gap

object | null

The window the resume closed. Null when the rule was already serving, in which case nothing was changed.

Hide child attributes

gap.paused_at

string<date-time> | null

required

Start of the gap.

gap.resumed_at

string<date-time> | null

required

End of the gap.

gap.replay_window

object

required

The gap as a window to re-read for yourself.

Hide child attributes

gap.replay_window.start

string<date-time> | null

Window start.

gap.replay_window.end

string<date-time> | null

Window end.

gap.counted

boolean

required

Whether anything inside the window was counted. False means the count is null because nothing was looked at, not because nothing happened.

Example:

true

gap.note

string

required

What can and cannot be recovered for the window, and how.

gap.reason

string | null

Cause of the pause that was cleared. Null on a bulk resume whose rules were paused for more than one reason; each rule then carries its own.

Example:

"deliveries_per_day_cap"

gap.reasons

string[]

Distinct causes across the resumed rules. Present on a bulk resume only.

gap.pause_message

string | null

The cause in plain words.

gap.suppressed_count

integer<int64> | null

Matches suppressed inside the window. Null when the rules were address scoped, because a paused address scoped rule is left out of the scan entirely and its occurrences were never looked at.

Example:

0

gap.suppressed_first_at

string<date-time> | null

First suppressed match inside the window.

gap.suppressed_last_at

string<date-time> | null

Most recent suppressed match inside the window.

gap.uncounted_subscriptions

integer

How many of the resumed rules were address scoped, and therefore not counted. Present on a bulk resume only.

Example:

0

note

string

Present only when nothing changed, to say why.

Example:

"This subscription was already active, so nothing changed."

Last modified on September 20, 2026

API reference

SDKs & tooling

AI & agents

Resume a paused subscription

Authorizations

Path Parameters

Response