Skip to main content
PATCH
/
api
/
v1
/
webhooks
/
{id}
cURL
curl -sS \
  -X PATCH \
  -H 'Authorization: Bearer $OXI_SK' \
  -H 'Content-Type: application/json' \
  -d '{"name":"Updated webhook","enabled":true}' \
  'https://api.0xinsider.com/api/v1/webhooks/{id}'
{
  "object": "<string>",
  "data": {
    "id": 123,
    "object": "<string>",
    "name": "<string>",
    "url": "<string>",
    "event_types": [],
    "verification_token_expires_at": "2023-11-07T05:31:56Z",
    "failure_count": 123,
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "retry_policy": {
      "max_attempts": 123,
      "terminal_status": "<string>"
    },
    "verified_at": "2023-11-07T05:31:56Z",
    "signing_secret": "<string>",
    "verification": {
      "token": "<string>",
      "expires_at": "2023-11-07T05:31:56Z"
    }
  },
  "meta": {
    "request_id": "<string>",
    "cached": true,
    "cache_age_s": 123
  }
}
Change a webhook’s destination URL, subscribed events, or active flag without recreating it. Promote a staging URL to production, or pause delivery during maintenance without losing the registration. 
curl -X PATCH \
  -H "Authorization: Bearer $OXINSIDER_API_KEY" \
  -H "Idempotency-Key: webhook-update-2026-06-01" \
  -H "Content-Type: application/json" \
  -d '{"enabled": false}' \
  "https://api.0xinsider.com/api/v1/webhooks/42"
The signing secret is not affected by PATCH. To change it, use Rotate Webhook Secret. Use Idempotency-Key when retrying the same update body. A matching retry replays the original response; a different body with the same key returns 422.

Authorizations

​
Authorization
string
header
required

API key: Authorization: Bearer oxi_sk_live_... for live data (requires an active Insider subscription), or oxi_sk_test_... for sandbox/test mode (free account, deterministic fixture data, no live rows). Both key classes use the same paths; the prefix selects live vs sandbox.

Headers

​
Idempotency-Key
string

Optional safe-retry key. Reuse the same value only when retrying the exact same mutation request body; a different body returns 422 and an in-flight matching request returns 409.

Required string length: 1 - 255

Path Parameters

​
id
integer<int64>
required

Webhook endpoint id owned by the authenticated API key user.

Body

application/json
​
name
string
Maximum string length: 100
​
url
string<uri>
​
event_types
enum<string>[]
Minimum array length: 1
Available options:
whale_trades_inserted,
live_sports_updated,
whale_trader_synced,
large_positions_updated
​
enabled
boolean

Response

Webhook destination

​
object
string
required
Allowed value: "webhook"
​
data
object
required
​
meta
object
required