获取组织 Webhook 端点

$client->beta->organization->webhooks->retrieve(string webhookEndpointID, ?list<AnthropicBeta> betas): OrganizationWebhookEndpoint

GET/v1/organizations/webhooks/{webhook_endpoint_id}

Requires anthropic-beta: webhooks-2026-10-07. How to send beta headers

按 ID 检索组织 webhook 端点。

每个请求都必须包含 beta 标头 anthropic-beta: webhooks-2026-10-07。不带该标头的请求将返回 404，就如同此 API 不存在一样。Anthropic 会为每个组织单独开启组织 webhook 端点功能；在您的组织开启之前，请求同样会返回 404。组织 webhook 端点目前处于 beta 阶段，不适用于已启用 HIPAA 就绪的组织。

Parameters

webhookEndpointID: string⁠Path

ID of the webhook endpoint.

betas?: optional list<AnthropicBeta>⁠Header

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.

获取组织 Webhook 端点

<?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
  ->retrieve(
  'webhook_endpoint_id', betas: [AnthropicBeta::MESSAGE_BATCHES_2024_09_24]
);

var_dump($betaOrganizationWebhookEndpoint);

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

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