Update Webhook

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}'

import requests

url = "https://api.0xinsider.com/api/v1/webhooks/{id}"

payload = {
    "name": "Updated webhook",
    "enabled": True
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({name: 'Updated webhook', enabled: true})
};

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

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.0xinsider.com/api/v1/webhooks/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => 'Updated webhook',
    'enabled' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://api.0xinsider.com/api/v1/webhooks/{id}"

	payload := strings.NewReader("{\n  \"name\": \"Updated webhook\",\n  \"enabled\": true\n}")

	req, _ := http.NewRequest("PATCH", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.patch("https://api.0xinsider.com/api/v1/webhooks/{id}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"Updated webhook\",\n  \"enabled\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.0xinsider.com/api/v1/webhooks/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"Updated webhook\",\n  \"enabled\": true\n}"

response = http.request(request)
puts response.read_body

{
  "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,
    "cost": 123,
    "cache_age_s": 123,
    "category_skill_model_version": "<string>",
    "category_skill_taxonomy_version": "<string>",
    "category_skill_platform": "<string>",
    "category_skill_scope": "<string>",
    "category_skill_source_coverage": "<string>",
    "category_skill_observation_started_at": "2023-11-07T05:31:56Z",
    "category_skill_model_operationally_degraded": true,
    "category_skill_status_counts": {
      "live": 1,
      "insufficient": 1,
      "stale": 1,
      "unknown": 1,
      "degraded": 1
    },
    "category_skill_base_payload_hash": "<string>",
    "category_skill_enriched_base_payload_hash": "<string>"
  }
}

PATCH

api

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}'

import requests

url = "https://api.0xinsider.com/api/v1/webhooks/{id}"

payload = {
    "name": "Updated webhook",
    "enabled": True
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({name: 'Updated webhook', enabled: true})
};

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

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.0xinsider.com/api/v1/webhooks/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => 'Updated webhook',
    'enabled' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://api.0xinsider.com/api/v1/webhooks/{id}"

	payload := strings.NewReader("{\n  \"name\": \"Updated webhook\",\n  \"enabled\": true\n}")

	req, _ := http.NewRequest("PATCH", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.patch("https://api.0xinsider.com/api/v1/webhooks/{id}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"Updated webhook\",\n  \"enabled\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.0xinsider.com/api/v1/webhooks/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"Updated webhook\",\n  \"enabled\": true\n}"

response = http.request(request)
puts response.read_body

{
  "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,
    "cost": 123,
    "cache_age_s": 123,
    "category_skill_model_version": "<string>",
    "category_skill_taxonomy_version": "<string>",
    "category_skill_platform": "<string>",
    "category_skill_scope": "<string>",
    "category_skill_source_coverage": "<string>",
    "category_skill_observation_started_at": "2023-11-07T05:31:56Z",
    "category_skill_model_operationally_degraded": true,
    "category_skill_status_counts": {
      "live": 1,
      "insufficient": 1,
      "stale": 1,
      "unknown": 1,
      "degraded": 1
    },
    "category_skill_base_payload_hash": "<string>",
    "category_skill_enriched_base_payload_hash": "<string>"
  }
}

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 authentication. Send your key in the Authorization header as Bearer oxi_sk_live_.... Live keys require an active Pro subscription and return live data.

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

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,

wallet_grade_changed,

insider_radar_flag_raised,

smart_money_flow_detected

enabled

boolean

Response

Webhook destination

object

string

required

Allowed value: "webhook"

data

object

required

Show child attributes

Overview

Objects

Discovery

Traders

Positions

Markets

Pick of the Day

Whale Trades

Insider Radar

Events

Streaming

Usage

Webhooks

Reports

System

Authorizations

Headers

Path Parameters

Body

Response