Claude Platform Docs

조직 웹훅 엔드포인트 업데이트

$client->beta->organization->webhooks->update(string webhookEndpointID, ?string description, ?list<EnabledEvent> enabledEvents, ?string name, ?State state, ?string url, ?list<AnthropicBeta> betas): OrganizationWebhookEndpoint
POST/v1/organizations/webhooks/{webhook_endpoint_id}
Requires anthropic-beta: webhooks-2026-10-07. How to send beta headers

조직 웹훅 엔드포인트를 업데이트합니다. 보낸 필드만 변경됩니다.

모든 요청에는 베타 헤더 anthropic-beta: webhooks-2026-10-07이 포함되어야 합니다. 이 헤더가 없는 요청은 이 API가 존재하지 않는 것과 똑같이 404를 반환합니다. Anthropic은 조직별로 조직 웹훅 엔드포인트를 활성화하며, 귀하의 조직에서 활성화되기 전까지는 요청이 마찬가지로 404를 반환합니다. 조직 웹훅 엔드포인트는 베타 상태이며 HIPAA 준비가 활성화된 조직에서는 사용할 수 없습니다.

Parameters
webhookEndpointID: string⁠Path parameter

ID of the webhook endpoint.

description?: optional string

Notes about the endpoint.

enabledEvents?: optional list<EnabledEvent>

The event types to deliver to the endpoint. Replaces the whole set; an empty list leaves it unchanged.

name?: optional string

A short label for the endpoint.

state?: optional State

disabled stops deliveries. enabled resumes them and clears disabled_reason. Events that happen while the endpoint is disabled are never delivered.

url?: optional string

The HTTPS URL that deliveries are sent to.

betas?: optional list<AnthropicBeta>⁠Header parameter

This endpoint is in beta: requests must send webhooks-2026-10-07 in this header.

Returns
class OrganizationWebhookEndpoint { $id; $createdAt; $description; /* 6 more */ }
string id

ID of the webhook endpoint.

\Datetime createdAt

When the endpoint was created, in RFC 3339 format.

string description

Notes about the endpoint. An empty string when none were given.

string disabledReason

Why Anthropic disabled the endpoint automatically. An empty string when the endpoint is enabled, or when you disabled it.

list<EnabledEvent> enabledEvents

The event types delivered to the endpoint.

string name

A short label for the endpoint. An empty string when none was given.

OrganizationWebhookEndpointState state

Whether deliveries are sent to the endpoint.

\Datetime updatedAt

When the endpoint was last changed, in RFC 3339 format.

string url

The HTTPS URL that deliveries are sent to.

조직 웹훅 엔드포인트 업데이트
<?php

require_once dirname(__DIR__) . '/vendor/autoload.php';

use Anthropic\Client;
use Anthropic\Beta\AnthropicBeta;

$client = new Client(apiKey: 'my-anthropic-api-key');

$betaOrganizationWebhookEndpoint = $client
  ->beta
  ->organization
  ->webhooks
  ->update(
  'webhook_endpoint_id',
  description: 'description',
  enabledEvents: ['user_profile.enforcement_action_opened'],
  name: 'name',
  state: 'disabled',
  url: 'x',
  betas: [AnthropicBeta::MESSAGE_BATCHES_2024_09_24],
);

var_dump($betaOrganizationWebhookEndpoint);
Returns Examples
Response 200
{
  "id": "id",
  "created_at": "2019-12-27T18:11:19.117Z",
  "description": "description",
  "disabled_reason": "disabled_reason",
  "enabled_events": [
    "user_profile.enforcement_action_opened"
  ],
  "name": "name",
  "state": "disabled",
  "updated_at": "2019-12-27T18:11:19.117Z",
  "url": "url"
}