Organization changedapi/beta/organization
Nearest release: v2.1.306, published under an hour before this site recorded the change. Shown because the two are within 24 hours of each other. Nothing here says the release caused the edit.
Recorded here
Lines+1,709added
Lines−1removed
From line
1,732
where the diff opens
First seen
26 Aug 2026
this site's first read of the page
Recorded edits30to this page, all time
### Set Workspace Rate Limits ## Organization › Webhooks ### Create Organization Webhook Endpoint ### List Organization Webhook Endpoints ### Get Organization Webhook Endpoint ### Update Organization Webhook Endpoint ### Delete Organization Webhook Endpoint ### Regenerate Organization Webhook Endpoint Signing Secret
The whole hunk
from line 1732, old and new numbered
/
This page is larger than the 256 KiB this site keeps, so one side of the diff below stops where the stored text does.
The two sides of this change are more than 400 edits apart, too far apart to line up, so this is the differ's own diff of it and the words inside a line are not marked.
from line 1732
17321732
17331733 - `"telemetry-destinations-2026-08-11"`
17341734
1735 - `"webhooks-2026-10-07"`
1736
17351737#### Body parameters
17361738
17371739- `issuer_url: string`
from line 2134
21322134
21332135 - `"telemetry-destinations-2026-08-11"`
21342136
2137 - `"webhooks-2026-10-07"`
2138
21352139#### Returns
21362140
21372141- `data: array of BetaFederationIssuer`
from line 2447
24432447
24442448 - `"telemetry-destinations-2026-08-11"`
24452449
2450 - `"webhooks-2026-10-07"`
2451
24462452#### Returns
24472453
24482454- `BetaFederationIssuer object`
from line 2763
27572763
27582764 - `"telemetry-destinations-2026-08-11"`
27592765
2766 - `"webhooks-2026-10-07"`
2767
27602768#### Body parameters
27612769
27622770- `check_jti: optional boolean or null`
from line 3157
31493157
31503158 - `"telemetry-destinations-2026-08-11"`
31513159
3160 - `"webhooks-2026-10-07"`
3161
31523162#### Returns
31533163
31543164- `BetaFederationIssuer object`
from line 3477
34673477
34683478 - `"telemetry-destinations-2026-08-11"`
34693479
3480 - `"webhooks-2026-10-07"`
3481
34703482#### Body parameters
34713483
34723484- `issuer_id: string`
from line 3904
38923904
38933905 - `"telemetry-destinations-2026-08-11"`
38943906
3907 - `"webhooks-2026-10-07"`
3908
38953909#### Returns
38963910
38973911- `data: array of BetaFederationRule`
from line 4217
42034217
42044218 - `"telemetry-destinations-2026-08-11"`
42054219
4220 - `"webhooks-2026-10-07"`
4221
42064222#### Returns
42074223
42084224- `BetaFederationRule object`
from line 4548
45324548
45334549 - `"telemetry-destinations-2026-08-11"`
45344550
4551 - `"webhooks-2026-10-07"`
4552
45354553#### Body parameters
45364554
45374555- `applies_to_all_workspaces: optional boolean or null`
from line 4951
49334951
49344952 - `"telemetry-destinations-2026-08-11"`
49354953
4954 - `"webhooks-2026-10-07"`
4955
49364956#### Returns
49374957
49384958- `BetaFederationRule object`
from line 5278
52585278
52595279 - `"telemetry-destinations-2026-08-11"`
52605280
5281 - `"webhooks-2026-10-07"`
5282
52615283#### Body parameters
52625284
52635285- `workspace_id: string`
from line 5489
54675489
54685490 - `"telemetry-destinations-2026-08-11"`
54695491
5492 - `"webhooks-2026-10-07"`
5493
54705494#### Returns
54715495
54725496- `data: array of BetaFederationRuleWorkspace`
from line 5690
56665690
56675691 - `"telemetry-destinations-2026-08-11"`
56685692
5693 - `"webhooks-2026-10-07"`
5694
56695695#### Returns
56705696
56715697- `type: "federation_rule_workspace_deleted"`
from line 6363
63376363
63386364 - `"telemetry-destinations-2026-08-11"`
63396365
6366 - `"webhooks-2026-10-07"`
6367
63406368#### Body parameters
63416369
63426370- `name: string`
from line 6626
65986626
65996627 - `"telemetry-destinations-2026-08-11"`
66006628
6629 - `"webhooks-2026-10-07"`
6630
66016631#### Returns
66026632
66036633- `data: array of BetaServiceAccount`
from line 6851
68216851
68226852 - `"telemetry-destinations-2026-08-11"`
68236853
6854 - `"webhooks-2026-10-07"`
6855
68246856#### Returns
68256857
68266858- `BetaServiceAccount object`
from line 7077
70457077
70467078 - `"telemetry-destinations-2026-08-11"`
70477079
7080 - `"webhooks-2026-10-07"`
7081
70487082#### Body parameters
70497083
70507084- `description: optional string or null`
from line 7321
72877321
72887322 - `"telemetry-destinations-2026-08-11"`
72897323
7324 - `"webhooks-2026-10-07"`
7325
72907326#### Returns
72917327
72927328- `BetaServiceAccount object`
from line 7552
75167552
75177553 - `"telemetry-destinations-2026-08-11"`
75187554
7555 - `"webhooks-2026-10-07"`
7556
75197557#### Body parameters
75207558
75217559- `workspace_id: string`
from line 7792
77547792
77557793 - `"telemetry-destinations-2026-08-11"`
77567794
7795 - `"webhooks-2026-10-07"`
7796
77577797#### Returns
77587798
77597799- `data: array of BetaServiceAccountWorkspaceMember`
from line 8004
79648004
79658005 - `"telemetry-destinations-2026-08-11"`
79668006
8007 - `"webhooks-2026-10-07"`
8008
79678009#### Returns
79688010
79698011- `type: "service_account_workspace_member_deleted"`
from line 8752
87108752
87118753 - `"telemetry-destinations-2026-08-11"`
87128754
8755 - `"webhooks-2026-10-07"`
8756
87138757#### Body parameters
87148758
87158759- `name: string`
from line 9730
96869730}
96879731```
96889732
9733### Set Workspace Rate Limits
9734
9735**POST** `/v1/organizations/workspaces/{workspace_id}/rate_limits/{rate_limit_id}`
9736
9737Set or clear rate-limit overrides for one rate-limit group in a workspace.
9738
9739Only the limiter types named in `limits` change: an integer `value` sets
9740that type's override and `null` clears it. Types not named keep their
9741current value. A value above the organization's own limit is stored, but
9742the organization limit still applies, so the lower of the two is
9743enforced.
9744
9745Returns the targeted group's entry with this request applied, in the shape
9746`GET /v1/organizations/workspaces/{workspace_id}/rate_limits` returns.
9747Changes take effect within about an hour.
9748
9749#### Path parameters
9750
9751- `workspace_id: string`
9752
9753 The ID of the workspace.
9754
9755- `rate_limit_id: string`
9756
9757 The `id` of the organization's rate-limit entry to set overrides for.
9758
9759#### Headers
9760
9761- `"anthropic-version": optional string`
9762
9763 The version of the Claude API you want to use.
9764
9765 Read more about versioning and our version history [here](https://platform.claude.com/docs/en/api/versioning?sdk_languages=http).
9766
9767#### Body parameters
9768
9769- `limits: array of BetaWorkspaceRateLimitUpdateValue`
9770
9771 Limits to set or clear. Unspecified limit types are unchanged.
9772
9773 minItems: 1, maxItems: 16
9774
9775 - `type: BetaWorkspaceRateLimitType`
9776
9777 Rate limiter type.
9778
9779 - `"fast_itpmca"`
9780
9781 - `"fast_otpm"`
9782
9783 - `"input_tokens_per_minute"`
9784
9785 - `"input_tokens_per_minute_cache_aware"`
9786
9787 - `"output_tokens_per_minute"`
9788
9789 - `"requests_per_minute"`
9790
9791 - `"tokens_per_day"`
9792
9793 - `"tokens_per_minute"`
9794
9795 - `"tool_uses_per_second"`
9796
9797 - `value: number or null`
9798
9799 New limit value. Set to null to clear the workspace override and fall back to the organization limit.
9800
9801 minimum: 0, maximum: 9007199254740991
9802
9803#### Returns
9804
9805- `BetaWorkspaceRateLimit object`
9806
9807 - `type: "workspace_rate_limit"`
9808
9809 Object type. Always `workspace_rate_limit` for workspace rate-limit entries.
9810
9811 default: workspace_rate_limit
9812
9813 - `group: BetaOrganizationRateLimitModelGroup or BetaOrganizationRateLimitBatchGroup or BetaOrganizationRateLimitTokenCountGroup or 3 more`
9814
9815 The rate-limit group this entry's limits apply to. Its `type` equals `group_type`.
9816
9817 - `BetaOrganizationRateLimitModelGroup object`
9818
9819 - `type: "model_group"`
9820
9821 Always `model_group`: a family of models.
9822
9823 default: model_group
9824
9825 - `id: string`
9826
9827 Opaque identifier of the rate-limit group (for example, `rlg_01VPTCmyiu5ZLsWkcxYG2pY8`). It is the same in every organization and never changes, unlike the entry's own identifier, which differs per organization.
9828
9829 - `display_name: string`
9830
9831 Human-readable name of the model group (for example, `Claude Sonnet 4.x`). For display only; it may change.
9832
9833 - `BetaOrganizationRateLimitBatchGroup object`
9834
9835 - `type: "batch"`
9836
9837 Always `batch`: the Message Batches API.
9838
9839 default: batch
9840
9841 - `id: string`
9842
9843 Opaque identifier of the rate-limit group (for example, `rlg_01VPTCmyiu5ZLsWkcxYG2pY8`). It is the same in every organization and never changes, unlike the entry's own identifier, which differs per organization.
9844
9845 - `BetaOrganizationRateLimitTokenCountGroup object`
9846
9847 - `type: "token_count"`
9848
9849 Always `token_count`: the Token Count API.
9850
9851 default: token_count
9852
9853 - `id: string`
9854
9855 Opaque identifier of the rate-limit group (for example, `rlg_01VPTCmyiu5ZLsWkcxYG2pY8`). It is the same in every organization and never changes, unlike the entry's own identifier, which differs per organization.
9856
9857 - `BetaOrganizationRateLimitFilesGroup object`
9858
9859 - `type: "files"`
9860
9861 Always `files`: the Files API.
9862
9863 default: files
9864
9865 - `id: string`
9866
9867 Opaque identifier of the rate-limit group (for example, `rlg_01VPTCmyiu5ZLsWkcxYG2pY8`). It is the same in every organization and never changes, unlike the entry's own identifier, which differs per organization.
9868
9869 - `BetaOrganizationRateLimitSkillsGroup object`
9870
9871 - `type: "skills"`
9872
9873 Always `skills`: the Skills API.
9874
9875 default: skills
9876
9877 - `id: string`
9878
9879 Opaque identifier of the rate-limit group (for example, `rlg_01VPTCmyiu5ZLsWkcxYG2pY8`). It is the same in every organization and never changes, unlike the entry's own identifier, which differs per organization.
9880
9881 - `BetaOrganizationRateLimitWebSearchGroup object`
9882
9883 - `type: "web_search"`
9884
9885 Always `web_search`: the Messages API web search tool.
9886
9887 default: web_search
9888
9889 - `id: string`
9890
9891 Opaque identifier of the rate-limit group (for example, `rlg_01VPTCmyiu5ZLsWkcxYG2pY8`). It is the same in every organization and never changes, unlike the entry's own identifier, which differs per organization.
9892
9893 - `limits: array of BetaWorkspaceRateLimitValue`
9894
9895 The workspace's limiter values for this group. By default only the limiter types with a workspace-level override are listed. With `include_inherited` set to `true`, the limiter types the workspace inherits from the organization are listed too, each marked by `source`.
9896
9897 - `type: string`
9898
9899 The limiter type (for example, `requests_per_minute` or `input_tokens_per_minute`).
9900
9901 - `org_limit: number or null`
9902
9903 The organization-level value for the same limiter type, for reference. `null` when the organization has no limit configured for this limiter type.
9904
9905 - `source: BetaWorkspaceRateLimitWorkspaceSource or BetaWorkspaceRateLimitOrganizationSource`
9906
9907 Where `value` comes from. `organization` values are listed only when `include_inherited` is `true`, and then `value` equals `org_limit`.
9908
9909 - `BetaWorkspaceRateLimitWorkspaceSource object`
9910
9911 - `type: "workspace"`
9912
9913 Always `workspace`: a workspace-level override is stored.
9914
9915 default: workspace
9916
9917 - `BetaWorkspaceRateLimitOrganizationSource object`
9918
9919 - `type: "organization"`
9920
9921 Always `organization`: no workspace-level override is stored, so the organization's value applies.
9922
9923 default: organization
9924
9925 - `value: number`
9926
9927 The workspace's value for this limiter type: the workspace-level override when `source.type` is `workspace`, otherwise the organization's value.
9928
9929 - `models: array of string or null`
9930
9931 Model names this entry's limits apply to, including aliases. `null` when `group_type` is not `"model_group"`.
9932
9933 - `rate_limit_id: string`
9934
9935 The `id` of the organization's RateLimit entry this entry applies to.
9936
9937 - `workspace_id: string`
9938
9939 ID of the Workspace this entry applies to.
9940
9941 - `group_type: "batch" or "files" or "model_group" or 3 more`
9942
9943 **Deprecated**: Use `group.type` instead. `group_type` is still returned and always equals `group.type`.
9944
9945 Deprecated: use `group.type` instead. The kind of rate-limit group this entry represents. `model_group` entries apply to a family of models (listed in `models`); other values apply to an API-surface category and have `models` set to `null`. Always equal to `group.type`.
9946
9947 - `"batch"`
9948
9949 - `"files"`
9950
9951 - `"model_group"`
9952
9953 - `"skills"`
9954
9955 - `"token_count"`
9956
9957 - `"web_search"`
9958
9959#### Example
9960
9961```bash
9962curl https://api.anthropic.com/v1/organizations/workspaces/$WORKSPACE_ID/rate_limits/$RATE_LIMIT_ID \
9963 -H 'Content-Type: application/json' \
9964 -H 'anthropic-version: 2023-06-01' \
9965 -H "X-Api-Key: $ANTHROPIC_API_KEY" \
9966 -d '{
9967 "limits": [
9968 {
9969 "type": "fast_itpmca",
9970 "value": 0
9971 }
9972 ]
9973 }'
9974```
9975
9976##### Response (200)
9977
9978```json
9979{
9980 "group": {
9981 "id": "id",
9982 "display_name": "display_name",
9983 "type": "model_group"
9984 },
9985 "group_type": "batch",
9986 "limits": [
9987 {
9988 "org_limit": 0,
9989 "source": {
9990 "type": "workspace"
9991 },
9992 "type": "type",
9993 "value": 0
9994 }
9995 ],
9996 "models": [
9997 "string"
9998 ],
9999 "rate_limit_id": "rate_limit_id",
10000 "type": "workspace_rate_limit",
10001 "workspace_id": "workspace_id"
10002}
10003```
10004
968910005## Organization › Workspaces › Members
969010006
969110007### List Workspace Members
from line 10596
1028010596
1028110597 - `"telemetry-destinations-2026-08-11"`
1028210598
10599 - `"webhooks-2026-10-07"`
10600
1028310601#### Returns
1028410602
1028510603- `data: array of BetaServiceAccountWorkspaceMember`
from line 10805
1048710805
1048810806 - `"telemetry-destinations-2026-08-11"`
1048910807
10808 - `"webhooks-2026-10-07"`
10809
1049010810#### Body parameters
1049110811
1049210812- `service_account_id: string`
from line 11030
1071011030
1071111031 - `"telemetry-destinations-2026-08-11"`
1071211032
11033 - `"webhooks-2026-10-07"`
11034
1071311035#### Returns
1071411036
1071511037- `BetaServiceAccountWorkspaceMember object`
from line 11232
1091011232
1091111233 - `"telemetry-destinations-2026-08-11"`
1091211234
11235 - `"webhooks-2026-10-07"`
11236
1091311237#### Body parameters
1091411238
1091511239- `workspace_role: BetaNoBillingWorkspaceRole`
from line 11451
1112711451
1112811452 - `"telemetry-destinations-2026-08-11"`
1112911453
11454 - `"webhooks-2026-10-07"`
11455
1113011456#### Returns
1113111457
1113211458- `type: "service_account_workspace_member_deleted"`
from line 11558
1123211558
1123311559 - `id: string`
1123411560
11235 Identifier of this rate-limit entry. It is stable within the organization and differs between organizations; the group's own identifier is `group.id`.
11561 Identifier of this rate-limit entry. It is stable within the organization and differs between organizations; the group's own identifier is `group.id`. Pass it as `rate_limit_id` to set a workspace's overrides for this group.
1123611562
1123711563 - `group: BetaOrganizationRateLimitModelGroup or BetaOrganizationRateLimitBatchGroup or BetaOrganizationRateLimitTokenCountGroup or 3 more`
1123811564
from line 12117
1179112117
1179212118 - `"telemetry-destinations-2026-08-11"`
1179312119
12120 - `"webhooks-2026-10-07"`
12121
1179412122#### Returns
1179512123
1179612124- `BetaMessagesUsageReport object`
from line 12734
1240612734
1240712735 - `"telemetry-destinations-2026-08-11"`
1240812736
12737 - `"webhooks-2026-10-07"`
12738
1240912739#### Returns
1241012740
1241112741- `BetaCostReport object`
from line 13044
1271413044
1271513045 - `"telemetry-destinations-2026-08-11"`
1271613046
13047 - `"webhooks-2026-10-07"`
13048
1271713049#### Returns
1271813050
1271913051- `data: array of BetaOrganizationTunnel`
from line 13252
1292013252
1292113253 - `"telemetry-destinations-2026-08-11"`
1292213254
13255 - `"webhooks-2026-10-07"`
13256
1292313257#### Returns
1292413258
1292513259- `BetaOrganizationTunnel object`
from line 13456
1312213456
1312313457 - `"telemetry-destinations-2026-08-11"`
1312413458
13459 - `"webhooks-2026-10-07"`
13460
1312513461#### Returns
1312613462
1312713463- `BetaOrganizationTunnel object`
from line 13661
1332513661
1332613662 - `"telemetry-destinations-2026-08-11"`
1332713663
13664 - `"webhooks-2026-10-07"`
13665
1332813666#### Returns
1332913667
1333013668- `BetaOrganizationTunnelToken object`
from line 13838
1350013838
1350113839 - `"telemetry-destinations-2026-08-11"`
1350213840
13841 - `"webhooks-2026-10-07"`
13842
1350313843#### Body parameters
1350413844
1350513845- `reason: optional string or null`
from line 14026
1368614026
1368714027 - `"telemetry-destinations-2026-08-11"`
1368814028
14029 - `"webhooks-2026-10-07"`
14030
1368914031#### Body parameters
1369014032
1369114033- `ca_certificate_pem: string`
from line 14260
1391814260
1391914261 - `"telemetry-destinations-2026-08-11"`
1392014262
14263 - `"webhooks-2026-10-07"`
14264
1392114265#### Returns
1392214266
1392314267- `data: array of BetaOrganizationTunnelCertificate`
from line 14472
1412814472
1412914473 - `"telemetry-destinations-2026-08-11"`
1413014474
14475 - `"webhooks-2026-10-07"`
14476
1413114477#### Returns
1413214478
1413314479- `BetaOrganizationTunnelCertificate object`
from line 14679
1433314679
1433414680 - `"telemetry-destinations-2026-08-11"`
1433514681
14682 - `"webhooks-2026-10-07"`
14683
1433614684#### Returns
1433714685
1433814686- `BetaOrganizationTunnelCertificate object`
from line 18671
1832318671
1832418672 - `"telemetry-destinations-2026-08-11"`
1832518673
18674 - `"webhooks-2026-10-07"`
18675
1832618676#### Body parameters
1832718677
1832818678- `amount: string or null`
from line 19270
1892019270
1892119271 - `"telemetry-destinations-2026-08-11"`
1892219272
19273 - `"webhooks-2026-10-07"`
19274
1892319275#### Returns
1892419276
1892519277- `data: array of BetaSpendLimit`
from line 22321
2196922321
2197022322 - `"telemetry-destinations-2026-08-11"`
2197122323
22324 - `"webhooks-2026-10-07"`
22325
2197222326#### Body parameters (form-data)
2197322327
2197422328- `files: array of string`
from line 22726
2237222726
2237322727 - `"telemetry-destinations-2026-08-11"`
2237422728
22729 - `"webhooks-2026-10-07"`
22730
2237522731#### Returns
2237622732
2237722733- `BetaPlugin object`
from line 23127
2277123127
2277223128 - `"telemetry-destinations-2026-08-11"`
2277323129
23130 - `"webhooks-2026-10-07"`
23131
2277423132#### Body parameters
2277523133
2277623134- `served_version_id: string`
from line 23578
2322023578
2322123579 - `"telemetry-destinations-2026-08-11"`
2322223580
23581 - `"webhooks-2026-10-07"`
23582
2322323583#### Returns
2322423584
2322523585- `data: array of BetaPlugin`
from line 23979
2361923979
2362023980 - `"telemetry-destinations-2026-08-11"`
2362123981
23982 - `"webhooks-2026-10-07"`
23983
2362223984#### Returns
2362323985
2362423986- `BetaDeletedPlugin object`
from line 24161
2379924161
2380024162 - `"telemetry-destinations-2026-08-11"`
2380124163
24164 - `"webhooks-2026-10-07"`
24165
2380224166#### Body parameters (form-data)
2380324167
2380424168- `files: array of string`
from line 24508
2414424508
2414524509 - `"telemetry-destinations-2026-08-11"`
2414624510
24511 - `"webhooks-2026-10-07"`
24512
2414724513#### Returns
2414824514
2414924515- `data: array of BetaPluginVersion`
from line 24837
2447124837
2447224838 - `"telemetry-destinations-2026-08-11"`
2447324839
24840 - `"webhooks-2026-10-07"`
24841
2447424842#### Returns
2447524843
2447624844- `BetaPluginVersion object`
from line 25173
2480525173
2480625174 - `"telemetry-destinations-2026-08-11"`
2480725175
25176 - `"webhooks-2026-10-07"`
25177
2480825178#### Example
2480925179
2481025180```bash
from line 25345
2497525345
2497625346 - `"telemetry-destinations-2026-08-11"`
2497725347
25348 - `"webhooks-2026-10-07"`
25349
2497825350#### Returns
2497925351
2498025352- `data: array of BetaPluginInstallationSetting`
from line 25596
2522425596
2522525597 - `"telemetry-destinations-2026-08-11"`
2522625598
25599 - `"webhooks-2026-10-07"`
25600
2522725601#### Body parameters
2522825602
2522925603- `installation_preference: "auto_install" or "available" or "not_available" or "required"`
from line 25864
2549025864
2549125865 - `"telemetry-destinations-2026-08-11"`
2549225866
25867 - `"webhooks-2026-10-07"`
25868
2549325869#### Returns
2549425870
2549525871- `BetaDeletedPluginInstallationSetting object`
from line 26106
2573026106
2573126107 - `"telemetry-destinations-2026-08-11"`
2573226108
26109 - `"webhooks-2026-10-07"`
26110
2573326111#### Returns
2573426112
2573526113- `data: array of BetaPluginShare`
from line 26365
2598726365
2598826366 - `"telemetry-destinations-2026-08-11"`
2598926367
26368 - `"webhooks-2026-10-07"`
26369
2599026370#### Returns
2599126371
2599226372- `data: array of BetaPluginMarketplace`
from line 26636
2625626636
2625726637 - `"telemetry-destinations-2026-08-11"`
2625826638
26639 - `"webhooks-2026-10-07"`
26640
2625926641#### Returns
2626026642
2626126643- `BetaPluginMarketplace object`
from line 26897
2651526897
2651626898 - `"telemetry-destinations-2026-08-11"`
2651726899
26900 - `"webhooks-2026-10-07"`
26901
2651826902#### Body parameters
2651926903
2652026904- `default_installation_preference: "auto_install" or "available" or "not_available" or "required"`
from line 27180
2679627180
2679727181 - `"telemetry-destinations-2026-08-11"`
2679827182
27183 - `"webhooks-2026-10-07"`
27184
2679927185#### Body parameters
2680027186
2680127187- `repository_url: string`
from line 27450
2706427450
2706527451 - `"telemetry-destinations-2026-08-11"`
2706627452
27453 - `"webhooks-2026-10-07"`
27454
2706727455#### Body parameters (form-data)
2706827456
2706927457- `archive: string`
from line 27704
2731627704
2731727705 - `"telemetry-destinations-2026-08-11"`
2731827706
27707 - `"webhooks-2026-10-07"`
27708
2731927709#### Body parameters
2732027710
2732127711- `endpoint_url: string`
from line 28179
2778928179
2779028180 - `"telemetry-destinations-2026-08-11"`
2779128181
28182 - `"webhooks-2026-10-07"`
28183
2779228184#### Returns
2779328185
2779428186- `data: array of BetaTelemetryDestination`
from line 28532
2814028532
2814128533 - `"telemetry-destinations-2026-08-11"`
2814228534
28535 - `"webhooks-2026-10-07"`
28536
2814328537#### Returns
2814428538
2814528539- `BetaTelemetryDestination object`
from line 28880
2848628880
2848728881 - `"telemetry-destinations-2026-08-11"`
2848828882
28883 - `"webhooks-2026-10-07"`
28884
2848928885#### Body parameters
2849028886
2849128887- `display_name: optional string or null`
from line 29362
2896629362
2896729363 - `"telemetry-destinations-2026-08-11"`
2896829364
29365 - `"webhooks-2026-10-07"`
29366
2896929367#### Returns
2897029368
2897129369- `BetaDeletedTelemetryDestination object`
from line 29523
2912529523
2912629524 - `"telemetry-destinations-2026-08-11"`
2912729525
29526 - `"webhooks-2026-10-07"`
29527
2912829528#### Returns
2912929529
2913029530- `BetaTelemetryDestinationTestResponse object`
from line 29720
2932029720
2932129721 - `"telemetry-destinations-2026-08-11"`
2932229722
29723 - `"webhooks-2026-10-07"`
29724
2932329725#### Returns
2932429726
2932529727- `data: array of BetaTelemetryDestinationWorkspace`
from line 29911
2950929911
2951029912 - `"telemetry-destinations-2026-08-11"`
2951129913
29914 - `"webhooks-2026-10-07"`
29915
2951229916#### Returns
2951329917
2951429918- `BetaTelemetryDestinationWorkspace object`
from line 30096
2969230096
2969330097 - `"telemetry-destinations-2026-08-11"`
2969430098
30099 - `"webhooks-2026-10-07"`
30100
2969530101#### Returns
2969630102
2969730103- `BetaDeletedTelemetryDestinationWorkspace object`
from line 30133
2972730133 "workspace_id": "workspace_id"
2972830134}
2972930135```
30136
30137## Organization › Webhooks
30138
30139### Create Organization Webhook Endpoint
30140
30141**POST** `/v1/organizations/webhooks`
30142
30143Create an organization webhook endpoint.
30144
30145An organization webhook endpoint belongs to the organization rather than to one of its workspaces. An organization can have at most 32 organization
30146webhook endpoints, enabled or disabled.
30147
30148The response includes the endpoint's signing secret. No read returns it, so store
30149it when you receive it.
30150
30151Every request must include the beta header `anthropic-beta: webhooks-2026-10-07`. A request without it returns `404`, exactly as if this API did not exist. Anthropic turns organization webhook endpoints on for each organization; until yours is on, requests also return `404`. Organization webhook endpoints are in beta and are not available to organizations with HIPAA readiness enabled.
30152
30153#### Headers
30154
30155- `"anthropic-version": optional string`
30156
30157 The version of the Claude API you want to use.
30158
30159 Read more about versioning and our version history [here](https://platform.claude.com/docs/en/api/versioning?sdk_languages=http).
30160
30161- `"anthropic-beta": optional array of AnthropicBeta`
30162
30163 This endpoint is in beta: requests must send `webhooks-2026-10-07` in this header.
30164
30165 - `string`
30166
30167 - `"message-batches-2024-09-24"`
30168
30169 - `"prompt-caching-2024-07-31"`
30170
30171 - `"computer-use-2024-10-22"`
30172
30173 - `"computer-use-2025-01-24"`
30174
30175 - `"pdfs-2024-09-25"`
30176
30177 - `"token-counting-2024-11-01"`
30178
30179 - `"token-efficient-tools-2025-02-19"`
30180
30181 - `"output-128k-2025-02-19"`
30182
30183 - `"files-api-2025-04-14"`
30184
30185 - `"mcp-client-2025-04-04"`
30186
30187 - `"mcp-client-2025-11-20"`
30188
30189 - `"dev-full-thinking-2025-05-14"`
30190
30191 - `"interleaved-thinking-2025-05-14"`
30192
30193 - `"code-execution-2025-05-22"`
30194
30195 - `"extended-cache-ttl-2025-04-11"`
30196
30197 - `"context-1m-2025-08-07"`
30198
30199 - `"context-management-2025-06-27"`
30200
30201 - `"model-context-window-exceeded-2025-08-26"`
30202
30203 - `"skills-2025-10-02"`
30204
30205 - `"fast-mode-2026-02-01"`
30206
30207 - `"output-300k-2026-03-24"`
30208
30209 - `"user-profiles-2026-03-24"`
30210
30211 - `"user-profiles-2026-08-18"`
30212
30213 - `"user-profiles-2026-09-04"`
30214
30215 - `"advisor-tool-2026-03-01"`
30216
30217 - `"managed-agents-2026-04-01"`
30218
30219 - `"cache-diagnosis-2026-04-07"`
30220
30221 - `"dreaming-2026-04-21"`
30222
30223 - `"thinking-token-count-2026-05-13"`
30224
30225 - `"server-side-fallback-2026-06-01"`
30226
30227 - `"server-side-fallback-2026-07-01"`
30228
30229 - `"fallback-credit-2026-06-01"`
30230
30231 - `"fallback-credit-2026-07-01"`
30232
30233 - `"agent-memory-2026-07-22"`
30234
30235 - `"mid-conversation-tool-changes-2026-07-01"`
30236
30237 - `"compact-2026-01-12"`
30238
30239 - `"computer-use-2025-11-24"`
30240
30241 - `"mcp-tunnels-2026-06-22"`
30242
30243 - `"structured-outputs-2025-11-13"`
30244
30245 - `"task-budgets-2026-03-13"`
30246
30247 - `"thinking-display-updates-2026-08-18"`
30248
30249 - `"ce-user-management-2026-07-13"`
30250
30251 - `"mid-conversation-output-config-2026-07-01"`
30252
30253 - `"thinking-binding-controls-2026-08-01"`
30254
30255 - `"mid-conversation-system-clear-at-2026-08-21"`
30256
30257 - `"compact-2026-09-04"`
30258
30259 - `"inline-tools-2026-09-15"`
30260
30261 - `"mcp-client-2026-09-15"`
30262
30263 - `"ce-plugins-2026-09-01"`
30264
30265 - `"spend-limit-reads-2026-09-26"`
30266
30267 - `"telemetry-destinations-2026-08-11"`
30268
30269 - `"webhooks-2026-10-07"`
30270
30271#### Body parameters
30272
30273- `enabled_events: array of "user_profile.enforcement_action_opened" or "user_profile.enforcement_action_resolved"`
30274
30275 The event types to deliver to the endpoint. Must list at least one.
30276
30277 - `"user_profile.enforcement_action_opened"`
30278
30279 - `"user_profile.enforcement_action_resolved"`
30280
30281- `url: string`
30282
30283 The HTTPS URL that deliveries are sent to.
30284
30285 minLength: 1
30286
30287- `description: optional string`
30288
30289 Notes about the endpoint.
30290
30291- `name: optional string`
30292
30293 A short label for the endpoint.
30294
30295#### Returns
30296
30297- `BetaNewOrganizationWebhookEndpoint object`
30298
30299 A new organization webhook endpoint, with its signing secret.
30300
30301 - `id: string`
30302
30303 ID of the webhook endpoint.
30304
30305 - `created_at: string`
30306
30307 When the endpoint was created, in RFC 3339 format.
30308
30309 format: date-time
30310
30311 - `description: string`
30312
30313 Notes about the endpoint. An empty string when none were given.
30314
30315 - `disabled_reason: string`
30316
30317 Why Anthropic disabled the endpoint automatically. An empty string when the endpoint is enabled, or when you disabled it.
30318
30319 - `enabled_events: array of "user_profile.enforcement_action_opened" or "user_profile.enforcement_action_resolved"`
30320
30321 The event types delivered to the endpoint.
30322
30323 - `"user_profile.enforcement_action_opened"`
30324
30325 - `"user_profile.enforcement_action_resolved"`
30326
30327 - `name: string`
30328
30329 A short label for the endpoint. An empty string when none was given.
30330
30331 - `signing_secret: string`
30332
30333 The secret Anthropic signs deliveries to the endpoint with (prefix `whsec_`). No other response returns it, so store it now. To replace it, regenerate the signing secret.
30334
30335 - `state: BetaOrganizationWebhookEndpointState`
30336
30337 Whether deliveries are sent to the endpoint.
30338
30339 - `"disabled"`
30340
30341 - `"enabled"`
30342
30343 - `updated_at: string`
30344
30345 When the endpoint was last changed, in RFC 3339 format.
30346
30347 format: date-time
30348
30349 - `url: string`
30350
30351 The HTTPS URL that deliveries are sent to.
30352
30353#### Example
30354
30355```bash
30356curl https://api.anthropic.com/v1/organizations/webhooks \
30357 -H 'Content-Type: application/json' \
30358 -H 'anthropic-version: 2023-06-01' \
30359 -H 'anthropic-beta: webhooks-2026-10-07' \
30360 -H "X-Api-Key: $ANTHROPIC_API_KEY" \
30361 -d '{
30362 "enabled_events": [
30363 "user_profile.enforcement_action_opened"
30364 ],
30365 "url": "x"
30366 }'
30367```
30368
30369##### Response (200)
30370
30371```json
30372{
30373 "id": "id",
30374 "created_at": "2019-12-27T18:11:19.117Z",
30375 "description": "description",
30376 "disabled_reason": "disabled_reason",
30377 "enabled_events": [
30378 "user_profile.enforcement_action_opened"
30379 ],
30380 "name": "name",
30381 "signing_secret": "signing_secret",
30382 "state": "disabled",
30383 "updated_at": "2019-12-27T18:11:19.117Z",
30384 "url": "url"
30385}
30386```
30387
30388### List Organization Webhook Endpoints
30389
30390**GET** `/v1/organizations/webhooks`
30391
30392List the organization's webhook endpoints.
30393
30394An organization webhook endpoint belongs to the organization rather than to one of its workspaces. The list does not include webhook endpoints that
30395belong to a workspace.
30396
30397Every request must include the beta header `anthropic-beta: webhooks-2026-10-07`. A request without it returns `404`, exactly as if this API did not exist. Anthropic turns organization webhook endpoints on for each organization; until yours is on, requests also return `404`. Organization webhook endpoints are in beta and are not available to organizations with HIPAA readiness enabled.
30398
30399#### Query parameters
30400
30401- `after_id: optional string`
30402
30403 ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately after this object.
30404
30405- `before_id: optional string`
30406
30407 ID of a webhook endpoint to use as a cursor. Returns the first `limit` endpoints that come before it in list order, not the `limit` endpoints just before it.
30408
30409- `limit: optional number`
30410
30411 Number of items to return per page, up to `100`. The default, `0`, means `20`.
30412
30413 default: 0, minimum: 0, maximum: 100
30414
30415- `order: optional "asc" or "desc"`
30416
30417 Sort order by `created_at`. Defaults to `desc`, newest first.
30418
30419 - `"asc"`
30420
30421 - `"desc"`
30422
30423#### Headers
30424
30425- `"anthropic-version": optional string`
30426
30427 The version of the Claude API you want to use.
30428
30429 Read more about versioning and our version history [here](https://platform.claude.com/docs/en/api/versioning?sdk_languages=http).
30430
30431- `"anthropic-beta": optional array of AnthropicBeta`
30432
30433 This endpoint is in beta: requests must send `webhooks-2026-10-07` in this header.
30434
30435 - `string`
30436
30437 - `"message-batches-2024-09-24"`
30438
30439 - `"prompt-caching-2024-07-31"`
30440
30441 - `"computer-use-2024-10-22"`
30442
30443 - `"computer-use-2025-01-24"`
30444
30445 - `"pdfs-2024-09-25"`
30446
30447 - `"token-counting-2024-11-01"`
30448
30449 - `"token-efficient-tools-2025-02-19"`
30450
30451 - `"output-128k-2025-02-19"`
30452
30453 - `"files-api-2025-04-14"`
30454
30455 - `"mcp-client-2025-04-04"`
30456
30457 - `"mcp-client-2025-11-20"`
30458
30459 - `"dev-full-thinking-2025-05-14"`
30460
30461 - `"interleaved-thinking-2025-05-14"`
30462
30463 - `"code-execution-2025-05-22"`
30464
30465 - `"extended-cache-ttl-2025-04-11"`
30466
30467 - `"context-1m-2025-08-07"`
30468
30469 - `"context-management-2025-06-27"`
30470
30471 - `"model-context-window-exceeded-2025-08-26"`
30472
30473 - `"skills-2025-10-02"`
30474
30475 - `"fast-mode-2026-02-01"`
30476
30477 - `"output-300k-2026-03-24"`
30478
30479 - `"user-profiles-2026-03-24"`
30480
30481 - `"user-profiles-2026-08-18"`
30482
30483 - `"user-profiles-2026-09-04"`
30484
30485 - `"advisor-tool-2026-03-01"`
30486
30487 - `"managed-agents-2026-04-01"`
30488
30489 - `"cache-diagnosis-2026-04-07"`
30490
30491 - `"dreaming-2026-04-21"`
30492
30493 - `"thinking-token-count-2026-05-13"`
30494
30495 - `"server-side-fallback-2026-06-01"`
30496
30497 - `"server-side-fallback-2026-07-01"`
30498
30499 - `"fallback-credit-2026-06-01"`
30500
30501 - `"fallback-credit-2026-07-01"`
30502
30503 - `"agent-memory-2026-07-22"`
30504
30505 - `"mid-conversation-tool-changes-2026-07-01"`
30506
30507 - `"compact-2026-01-12"`
30508
30509 - `"computer-use-2025-11-24"`
30510
30511 - `"mcp-tunnels-2026-06-22"`
30512
30513 - `"structured-outputs-2025-11-13"`
30514
30515 - `"task-budgets-2026-03-13"`
30516
30517 - `"thinking-display-updates-2026-08-18"`
30518
30519 - `"ce-user-management-2026-07-13"`
30520
30521 - `"mid-conversation-output-config-2026-07-01"`
30522
30523 - `"thinking-binding-controls-2026-08-01"`
30524
30525 - `"mid-conversation-system-clear-at-2026-08-21"`
30526
30527 - `"compact-2026-09-04"`
30528
30529 - `"inline-tools-2026-09-15"`
30530
30531 - `"mcp-client-2026-09-15"`
30532
30533 - `"ce-plugins-2026-09-01"`
30534
30535 - `"spend-limit-reads-2026-09-26"`
30536
30537 - `"telemetry-destinations-2026-08-11"`
30538
30539 - `"webhooks-2026-10-07"`
30540
30541#### Returns
30542
30543- `data: array of BetaOrganizationWebhookEndpoint`
30544
30545 The organization webhook endpoints on this page.
30546
30547 - `id: string`
30548
30549 ID of the webhook endpoint.
30550
30551 - `created_at: string`
30552
30553 When the endpoint was created, in RFC 3339 format.
30554
30555 format: date-time
30556
30557 - `description: string`
30558
30559 Notes about the endpoint. An empty string when none were given.
30560
30561 - `disabled_reason: string`
30562
30563 Why Anthropic disabled the endpoint automatically. An empty string when the endpoint is enabled, or when you disabled it.
30564
30565 - `enabled_events: array of "user_profile.enforcement_action_opened" or "user_profile.enforcement_action_resolved"`
30566
30567 The event types delivered to the endpoint.
30568
30569 - `"user_profile.enforcement_action_opened"`
30570
30571 - `"user_profile.enforcement_action_resolved"`
30572
30573 - `name: string`
30574
30575 A short label for the endpoint. An empty string when none was given.
30576
30577 - `state: BetaOrganizationWebhookEndpointState`
30578
30579 Whether deliveries are sent to the endpoint.
30580
30581 - `"disabled"`
30582
30583 - `"enabled"`
30584
30585 - `updated_at: string`
30586
30587 When the endpoint was last changed, in RFC 3339 format.
30588
30589 format: date-time
30590
30591 - `url: string`
30592
30593 The HTTPS URL that deliveries are sent to.
30594
30595- `has_more: boolean`
30596
30597 Whether more endpoints follow this page in list order. With `before_id`, only endpoints before the cursor count.
30598
30599- `first_id: optional string or null`
30600
30601 First ID in the `data` list.
30602
30603- `last_id: optional string or null`
30604
30605 Last ID in the `data` list. Can be used as the `after_id` for the next page.
30606
30607#### Example
30608
30609```bash
30610curl https://api.anthropic.com/v1/organizations/webhooks \
30611 -H 'anthropic-version: 2023-06-01' \
30612 -H 'anthropic-beta: webhooks-2026-10-07' \
30613 -H "X-Api-Key: $ANTHROPIC_API_KEY"
30614```
30615
30616##### Response (200)
30617
30618```json
30619{
30620 "data": [
30621 {
30622 "id": "id",
30623 "created_at": "2019-12-27T18:11:19.117Z",
30624 "description": "description",
30625 "disabled_reason": "disabled_reason",
30626 "enabled_events": [
30627 "user_profile.enforcement_action_opened"
30628 ],
30629 "name": "name",
30630 "state": "disabled",
30631 "updated_at": "2019-12-27T18:11:19.117Z",
30632 "url": "url"
30633 }
30634 ],
30635 "has_more": true,
30636 "first_id": "first_id",
30637 "last_id": "last_id"
30638}
30639```
30640
30641### Get Organization Webhook Endpoint
30642
30643**GET** `/v1/organizations/webhooks/{webhook_endpoint_id}`
30644
30645Retrieve an organization webhook endpoint by ID.
30646
30647Every request must include the beta header `anthropic-beta: webhooks-2026-10-07`. A request without it returns `404`, exactly as if this API did not exist. Anthropic turns organization webhook endpoints on for each organization; until yours is on, requests also return `404`. Organization webhook endpoints are in beta and are not available to organizations with HIPAA readiness enabled.
30648
30649#### Path parameters
30650
30651- `webhook_endpoint_id: string`
30652
30653 ID of the webhook endpoint.
30654
30655 maxLength: 2048
30656
30657#### Headers
30658
30659- `"anthropic-version": optional string`
30660
30661 The version of the Claude API you want to use.
30662
30663 Read more about versioning and our version history [here](https://platform.claude.com/docs/en/api/versioning?sdk_languages=http).
30664
30665- `"anthropic-beta": optional array of AnthropicBeta`
30666
30667 This endpoint is in beta: requests must send `webhooks-2026-10-07` in this header.
30668
30669 - `string`
30670
30671 - `"message-batches-2024-09-24"`
30672
30673 - `"prompt-caching-2024-07-31"`
30674
30675 - `"computer-use-2024-10-22"`
30676
30677 - `"computer-use-2025-01-24"`
30678
30679 - `"pdfs-2024-09-25"`
30680
30681 - `"token-counting-2024-11-01"`
30682
30683 - `"token-efficient-tools-2025-02-19"`
30684
30685 - `"output-128k-2025-02-19"`
30686
30687 - `"files-api-2025-04-14"`
30688
30689 - `"mcp-client-2025-04-04"`
30690
30691 - `"mcp-client-2025-11-20"`
30692
30693 - `"dev-full-thinking-2025-05-14"`
30694
30695 - `"interleaved-thinking-2025-05-14"`
30696
30697 - `"code-execution-2025-05-22"`
30698
30699 - `"extended-cache-ttl-2025-04-11"`
30700
30701 - `"context-1m-2025-08-07"`
30702
30703 - `"context-management-2025-06-27"`
30704
30705 - `"model-context-window-exceeded-2025-08-26"`
30706
30707 - `"skills-2025-10-02"`
30708
30709 - `"fast-mode-2026-02-01"`
30710
30711 - `"output-300k-2026-03-24"`
30712
30713 - `"user-profiles-2026-03-24"`
30714
30715 - `"user-profiles-2026-08-18"`
30716
30717 - `"user-profiles-2026-09-04"`
30718
30719 - `"advisor-tool-2026-03-01"`
30720
30721 - `"managed-agents-2026-04-01"`
30722
30723 - `"cache-diagnosis-2026-04-07"`
30724
30725 - `"dreaming-2026-04-21"`
30726
30727 - `"thinking-token-count-2026-05-13"`
30728
30729 - `"server-side-fallback-2026-06-01"`
30730
30731 - `"server-side-fallback-2026-07-01"`
30732
30733 - `"fallback-credit-2026-06-01"`
30734
30735 - `"fallback-credit-2026-07-01"`
30736
30737 - `"agent-memory-2026-07-22"`
30738
30739 - `"mid-conversation-tool-changes-2026-07-01"`
30740
30741 - `"compact-2026-01-12"`
30742
30743 - `"computer-use-2025-11-24"`
30744
30745 - `"mcp-tunnels-2026-06-22"`
30746
30747 - `"structured-outputs-2025-11-13"`
30748
30749 - `"task-budgets-2026-03-13"`
30750
30751 - `"thinking-display-updates-2026-08-18"`
30752
30753 - `"ce-user-management-2026-07-13"`
30754
30755 - `"mid-conversation-output-config-2026-07-01"`
30756
30757 - `"thinking-binding-controls-2026-08-01"`
30758
30759 - `"mid-conversation-system-clear-at-2026-08-21"`
30760
30761 - `"compact-2026-09-04"`
30762
30763 - `"inline-tools-2026-09-15"`
30764
30765 - `"mcp-client-2026-09-15"`
30766
30767 - `"ce-plugins-2026-09-01"`
30768
30769 - `"spend-limit-reads-2026-09-26"`
30770
30771 - `"telemetry-destinations-2026-08-11"`
30772
30773 - `"webhooks-2026-10-07"`
30774
30775#### Returns
30776
30777- `BetaOrganizationWebhookEndpoint object`
30778
30779 A webhook endpoint that belongs to the organization rather than to one of
30780 its workspaces.
30781
30782 - `id: string`
30783
30784 ID of the webhook endpoint.
30785
30786 - `created_at: string`
30787
30788 When the endpoint was created, in RFC 3339 format.
30789
30790 format: date-time
30791
30792 - `description: string`
30793
30794 Notes about the endpoint. An empty string when none were given.
30795
30796 - `disabled_reason: string`
30797
30798 Why Anthropic disabled the endpoint automatically. An empty string when the endpoint is enabled, or when you disabled it.
30799
30800 - `enabled_events: array of "user_profile.enforcement_action_opened" or "user_profile.enforcement_action_resolved"`
30801
30802 The event types delivered to the endpoint.
30803
30804 - `"user_profile.enforcement_action_opened"`
30805
30806 - `"user_profile.enforcement_action_resolved"`
30807
30808 - `name: string`
30809
30810 A short label for the endpoint. An empty string when none was given.
30811
30812 - `state: BetaOrganizationWebhookEndpointState`
30813
30814 Whether deliveries are sent to the endpoint.
30815
30816 - `"disabled"`
30817
30818 - `"enabled"`
30819
30820 - `updated_at: string`
30821
30822 When the endpoint was last changed, in RFC 3339 format.
30823
30824 format: date-time
30825
30826 - `url: string`
30827
30828 The HTTPS URL that deliveries are sent to.
30829
30830#### Example
30831
30832```bash
30833curl https://api.anthropic.com/v1/organizations/webhooks/$WEBHOOK_ENDPOINT_ID \
30834 -H 'anthropic-version: 2023-06-01' \
30835 -H 'anthropic-beta: webhooks-2026-10-07' \
30836 -H "X-Api-Key: $ANTHROPIC_API_KEY"
30837```
30838
30839##### Response (200)
30840
30841```json
30842{
30843 "id": "id",
30844 "created_at": "2019-12-27T18:11:19.117Z",
30845 "description": "description",
30846 "disabled_reason": "disabled_reason",
30847 "enabled_events": [
30848 "user_profile.enforcement_action_opened"
30849 ],
30850 "name": "name",
30851 "state": "disabled",
30852 "updated_at": "2019-12-27T18:11:19.117Z",
30853 "url": "url"
30854}
30855```
30856
30857### Update Organization Webhook Endpoint
30858
30859**POST** `/v1/organizations/webhooks/{webhook_endpoint_id}`
30860
30861Update an organization webhook endpoint. Only the fields you send are changed.
30862
30863Every request must include the beta header `anthropic-beta: webhooks-2026-10-07`. A request without it returns `404`, exactly as if this API did not exist. Anthropic turns organization webhook endpoints on for each organization; until yours is on, requests also return `404`. Organization webhook endpoints are in beta and are not available to organizations with HIPAA readiness enabled.
30864
30865#### Path parameters
30866
30867- `webhook_endpoint_id: string`
30868
30869 ID of the webhook endpoint.
30870
30871 maxLength: 2048
30872
30873#### Headers
30874
30875- `"anthropic-version": optional string`
30876
30877 The version of the Claude API you want to use.
30878
30879 Read more about versioning and our version history [here](https://platform.claude.com/docs/en/api/versioning?sdk_languages=http).
30880
30881- `"anthropic-beta": optional array of AnthropicBeta`
30882
30883 This endpoint is in beta: requests must send `webhooks-2026-10-07` in this header.
30884
30885 - `string`
30886
30887 - `"message-batches-2024-09-24"`
30888
30889 - `"prompt-caching-2024-07-31"`
30890
30891 - `"computer-use-2024-10-22"`
30892
30893 - `"computer-use-2025-01-24"`
30894
30895 - `"pdfs-2024-09-25"`
30896
30897 - `"token-counting-2024-11-01"`
30898
30899 - `"token-efficient-tools-2025-02-19"`
30900
30901 - `"output-128k-2025-02-19"`
30902
30903 - `"files-api-2025-04-14"`
30904
30905 - `"mcp-client-2025-04-04"`
30906
30907 - `"mcp-client-2025-11-20"`
30908
30909 - `"dev-full-thinking-2025-05-14"`
30910
30911 - `"interleaved-thinking-2025-05-14"`
30912
30913 - `"code-execution-2025-05-22"`
30914
30915 - `"extended-cache-ttl-2025-04-11"`
30916
30917 - `"context-1m-2025-08-07"`
30918
30919 - `"context-management-2025-06-27"`
30920
30921 - `"model-context-window-exceeded-2025-08-26"`
30922
30923 - `"skills-2025-10-02"`
30924
30925 - `"fast-mode-2026-02-01"`
30926
30927 - `"output-300k-2026-03-24"`
30928
30929 - `"user-profiles-2026-03-24"`
30930
30931 - `"user-profiles-2026-08-18"`
30932
30933 - `"user-profiles-2026-09-04"`
30934
30935 - `"advisor-tool-2026-03-01"`
30936
30937 - `"managed-agents-2026-04-01"`
30938
30939 - `"cache-diagnosis-2026-04-07"`
30940
30941 - `"dreaming-2026-04-21"`
30942
30943 - `"thinking-token-count-2026-05-13"`
30944
30945 - `"server-side-fallback-2026-06-01"`
30946
30947 - `"server-side-fallback-2026-07-01"`
30948
30949 - `"fallback-credit-2026-06-01"`
30950
30951 - `"fallback-credit-2026-07-01"`
30952
30953 - `"agent-memory-2026-07-22"`
30954
30955 - `"mid-conversation-tool-changes-2026-07-01"`
30956
30957 - `"compact-2026-01-12"`
30958
30959 - `"computer-use-2025-11-24"`
30960
30961 - `"mcp-tunnels-2026-06-22"`
30962
30963 - `"structured-outputs-2025-11-13"`
30964
30965 - `"task-budgets-2026-03-13"`
30966
30967 - `"thinking-display-updates-2026-08-18"`
30968
30969 - `"ce-user-management-2026-07-13"`
30970
30971 - `"mid-conversation-output-config-2026-07-01"`
30972
30973 - `"thinking-binding-controls-2026-08-01"`
30974
30975 - `"mid-conversation-system-clear-at-2026-08-21"`
30976
30977 - `"compact-2026-09-04"`
30978
30979 - `"inline-tools-2026-09-15"`
30980
30981 - `"mcp-client-2026-09-15"`
30982
30983 - `"ce-plugins-2026-09-01"`
30984
30985 - `"spend-limit-reads-2026-09-26"`
30986
30987 - `"telemetry-destinations-2026-08-11"`
30988
30989 - `"webhooks-2026-10-07"`
30990
30991#### Body parameters
30992
30993- `description: optional string`
30994
30995 Notes about the endpoint.
30996
30997- `enabled_events: optional array of "user_profile.enforcement_action_opened" or "user_profile.enforcement_action_resolved"`
30998
30999 The event types to deliver to the endpoint. Replaces the whole set; an empty list leaves it unchanged.
31000
31001 - `"user_profile.enforcement_action_opened"`
31002
31003 - `"user_profile.enforcement_action_resolved"`
31004
31005- `name: optional string`
31006
31007 A short label for the endpoint.
31008
31009- `state: optional "disabled" or "enabled"`
31010
31011 `disabled` stops deliveries. `enabled` resumes them and clears `disabled_reason`. Events that happen while the endpoint is disabled are never delivered.
31012
31013 - `"disabled"`
31014
31015 - `"enabled"`
31016
31017- `url: optional string`
31018
31019 The HTTPS URL that deliveries are sent to.
31020
31021 minLength: 1
31022
31023#### Returns
31024
31025- `BetaOrganizationWebhookEndpoint object`
31026
31027 A webhook endpoint that belongs to the organization rather than to one of
31028 its workspaces.
31029
31030 - `id: string`
31031
31032 ID of the webhook endpoint.
31033
31034 - `created_at: string`
31035
31036 When the endpoint was created, in RFC 3339 format.
31037
31038 format: date-time
31039
31040 - `description: string`
31041
31042 Notes about the endpoint. An empty string when none were given.
31043
31044 - `disabled_reason: string`
31045
31046 Why Anthropic disabled the endpoint automatically. An empty string when the endpoint is enabled, or when you disabled it.
31047
31048 - `enabled_events: array of "user_profile.enforcement_action_opened" or "user_profile.enforcement_action_resolved"`
31049
31050 The event types delivered to the endpoint.
31051
31052 - `"user_profile.enforcement_action_opened"`
31053
31054 - `"user_profile.enforcement_action_resolved"`
31055
31056 - `name: string`
31057
31058 A short label for the endpoint. An empty string when none was given.
31059
31060 - `state: BetaOrganizationWebhookEndpointState`
31061
31062 Whether deliveries are sent to the endpoint.
31063
31064 - `"disabled"`
31065
31066 - `"enabled"`
31067
31068 - `updated_at: string`
31069
31070 When the endpoint was last changed, in RFC 3339 format.
31071
31072 format: date-time
31073
31074 - `url: string`
31075
31076 The HTTPS URL that deliveries are sent to.
31077
31078#### Example
31079
31080```bash
31081curl https://api.anthropic.com/v1/organizations/webhooks/$WEBHOOK_ENDPOINT_ID \
31082 -H 'Content-Type: application/json' \
31083 -H 'anthropic-version: 2023-06-01' \
31084 -H 'anthropic-beta: webhooks-2026-10-07' \
31085 -H "X-Api-Key: $ANTHROPIC_API_KEY" \
31086 -d '{}'
31087```
31088
31089##### Response (200)
31090
31091```json
31092{
31093 "id": "id",
31094 "created_at": "2019-12-27T18:11:19.117Z",
31095 "description": "description",
31096 "disabled_reason": "disabled_reason",
31097 "enabled_events": [
31098 "user_profile.enforcement_action_opened"
31099 ],
31100 "name": "name",
31101 "state": "disabled",
31102 "updated_at": "2019-12-27T18:11:19.117Z",
31103 "url": "url"
31104}
31105```
31106
31107### Delete Organization Webhook Endpoint
31108
31109**DELETE** `/v1/organizations/webhooks/{webhook_endpoint_id}`
31110
31111Delete an organization webhook endpoint.
31112
31113Every request must include the beta header `anthropic-beta: webhooks-2026-10-07`. A request without it returns `404`, exactly as if this API did not exist. Anthropic turns organization webhook endpoints on for each organization; until yours is on, requests also return `404`. Organization webhook endpoints are in beta and are not available to organizations with HIPAA readiness enabled.
31114
31115#### Path parameters
31116
31117- `webhook_endpoint_id: string`
31118
31119 ID of the webhook endpoint.
31120
31121 maxLength: 2048
31122
31123#### Headers
31124
31125- `"anthropic-version": optional string`
31126
31127 The version of the Claude API you want to use.
31128
31129 Read more about versioning and our version history [here](https://platform.claude.com/docs/en/api/versioning?sdk_languages=http).
31130
31131- `"anthropic-beta": optional array of AnthropicBeta`
31132
31133 This endpoint is in beta: requests must send `webhooks-2026-10-07` in this header.
31134
31135 - `string`
31136
31137 - `"message-batches-2024-09-24"`
31138
31139 - `"prompt-caching-2024-07-31"`
31140
31141 - `"computer-use-2024-10-22"`
31142
31143 - `"computer-use-2025-01-24"`
31144
31145 - `"pdfs-2024-09-25"`
31146
31147 - `"token-counting-2024-11-01"`
31148
31149 - `"token-efficient-tools-2025-02-19"`
31150
31151 - `"output-128k-2025-02-19"`
31152
31153 - `"files-api-2025-04-14"`
31154
31155 - `"mcp-client-2025-04-04"`
31156
31157 - `"mcp-client-2025-11-20"`
31158
31159 - `"dev-full-thinking-2025-05-14"`
31160
31161 - `"interleaved-thinking-2025-05-14"`
31162
31163 - `"code-execution-2025-05-22"`
31164
31165 - `"extended-cache-ttl-2025-04-11"`
31166
31167 - `"context-1m-2025-08-07"`
31168
31169 - `"context-management-2025-06-27"`
31170
31171 - `"model-context-window-exceeded-2025-08-26"`
31172
31173 - `"skills-2025-10-02"`
31174
31175 - `"fast-mode-2026-02-01"`
31176
31177 - `"output-300k-2026-03-24"`
31178
31179 - `"user-profiles-2026-03-24"`
31180
31181 - `"user-profiles-2026-08-18"`
31182
31183 - `"user-profiles-2026-09-04"`
31184
31185 - `"advisor-tool-2026-03-01"`
31186
31187 - `"managed-agents-2026-04-01"`
31188
31189 - `"cache-diagnosis-2026-04-07"`
31190
31191 - `"dreaming-2026-04-21"`
31192
31193 - `"thinking-token-count-2026-05-13"`
31194
31195 - `"server-side-fallback-2026-06-01"`
31196
31197 - `"server-side-fallback-2026-07-01"`
31198
31199 - `"fallback-credit-2026-06-01"`
31200
31201 - `"fallback-credit-2026-07-01"`
31202
31203 - `"agent-memory-2026-07-22"`
31204
31205 - `"mid-conversation-tool-changes-2026-07-01"`
31206
31207 - `"compact-2026-01-12"`
31208
31209 - `"computer-use-2025-11-24"`
31210
31211 - `"mcp-tunnels-2026-06-22"`
31212
31213 - `"structured-outputs-2025-11-13"`
31214
31215 - `"task-budgets-2026-03-13"`
31216
31217 - `"thinking-display-updates-2026-08-18"`
31218
31219 - `"ce-user-management-2026-07-13"`
31220
31221 - `"mid-conversation-output-config-2026-07-01"`
31222
31223 - `"thinking-binding-controls-2026-08-01"`
31224
31225 - `"mid-conversation-system-clear-at-2026-08-21"`
31226
31227 - `"compact-2026-09-04"`
31228
31229 - `"inline-tools-2026-09-15"`
31230
31231 - `"mcp-client-2026-09-15"`
31232
31233 - `"ce-plugins-2026-09-01"`
31234
31235 - `"spend-limit-reads-2026-09-26"`
31236
31237 - `"telemetry-destinations-2026-08-11"`
31238
31239 - `"webhooks-2026-10-07"`
31240
31241#### Returns
31242
31243- `BetaDeletedOrganizationWebhookEndpoint object`
31244
31245 A deleted organization webhook endpoint.
31246
31247 - `type: "webhook_endpoint_deleted"`
31248
31249 Always `webhook_endpoint_deleted`.
31250
31251 default: webhook_endpoint_deleted
31252
31253 - `id: string`
31254
31255 ID of the deleted webhook endpoint.
31256
31257#### Example
31258
31259```bash
31260curl https://api.anthropic.com/v1/organizations/webhooks/$WEBHOOK_ENDPOINT_ID \
31261 -X DELETE \
31262 -H 'anthropic-version: 2023-06-01' \
31263 -H 'anthropic-beta: webhooks-2026-10-07' \
31264 -H "X-Api-Key: $ANTHROPIC_API_KEY"
31265```
31266
31267##### Response (200)
31268
31269```json
31270{
31271 "id": "id",
31272 "type": "webhook_endpoint_deleted"
31273}
31274```
31275
31276### Regenerate Organization Webhook Endpoint Signing Secret
31277
31278**POST** `/v1/organizations/webhooks/{webhook_endpoint_id}/regenerate_signing_secret`
31279
31280Replace an organization webhook endpoint's signing secret. The old secret stops
31281working immediately. The new secret is returned only in this response.
31282
31283Every request must include the beta header `anthropic-beta: webhooks-2026-10-07`. A request without it returns `404`, exactly as if this API did not exist. Anthropic turns organization webhook endpoints on for each organization; until yours is on, requests also return `404`. Organization webhook endpoints are in beta and are not available to organizations with HIPAA readiness enabled.
31284
31285#### Path parameters
31286
31287- `webhook_endpoint_id: string`
31288
31289 ID of the webhook endpoint.
31290
31291 maxLength: 2048
31292
31293#### Headers
31294
31295- `"anthropic-version": optional string`
31296
31297 The version of the Claude API you want to use.
31298
31299 Read more about versioning and our version history [here](https://platform.claude.com/docs/en/api/versioning?sdk_languages=http).
31300
31301- `"anthropic-beta": optional array of AnthropicBeta`
31302
31303 This endpoint is in beta: requests must send `webhooks-2026-10-07` in this header.
31304
31305 - `string`
31306
31307 - `"message-batches-2024-09-24"`
31308
31309 - `"prompt-caching-2024-07-31"`
31310
31311 - `"computer-use-2024-10-22"`
31312
31313 - `"computer-use-2025-01-24"`
31314
31315 - `"pdfs-2024-09-25"`
31316
31317 - `"token-counting-2024-11-01"`
31318
31319 - `"token-efficient-tools-2025-02-19"`
31320
31321 - `"output-128k-2025-02-19"`
31322
31323 - `"files-api-2025-04-14"`
31324
31325 - `"mcp-client-2025-04-04"`
31326
31327 - `"mcp-client-2025-11-20"`
31328
31329 - `"dev-full-thinking-2025-05-14"`
31330
31331 - `"interleaved-thinking-2025-05-14"`
31332
31333 - `"code-execution-2025-05-22"`
31334
31335 - `"extended-cache-ttl-2025-04-11"`
31336
31337 - `"context-1m-2025-08-07"`
31338
31339 - `"context-management-2025-06-27"`
31340
31341 - `"model-context-window-exceeded-2025-08-26"`
31342
31343 - `"skills-2025-10-02"`
31344
31345 - `"fast-mode-2026-02-01"`
31346
31347 - `"output-300k-2026-03-24"`
31348
31349 - `"user-profiles-2026-03-24"`
31350
31351 - `"user-profiles-2026-08-18"`
31352
31353 - `"user-profiles-2026-09-04"`
31354
31355 - `"advisor-tool-2026-03-01"`
31356
31357 - `"managed-agents-2026-04-01"`
31358
31359 - `"cache-diagnosis-2026-04-07"`
31360
31361 - `"dreaming-2026-04-21"`
31362
31363 - `"thinking-token-count-2026-05-13"`
31364
31365 - `"server-side-fallback-2026-06-01"`
31366
31367 - `"server-side-fallback-2026-07-01"`
31368
31369 - `"fallback-credit-2026-06-01"`
31370
31371 - `"fallback-credit-2026-07-01"`
31372
31373 - `"agent-memory-2026-07-22"`
31374
31375 - `"mid-conversation-tool-changes-2026-07-01"`
31376
31377 - `"compact-2026-01-12"`
31378
31379 - `"computer-use-2025-11-24"`
31380
31381 - `"mcp-tunnels-2026-06-22"`
31382
31383 - `"structured-outputs-2025-11-13"`
31384
31385 - `"task-budgets-2026-03-13"`
31386
31387 - `"thinking-display-updates-2026-08-18"`
31388
31389 - `"ce-user-management-2026-07-13"`
31390
31391 - `"mid-conversation-output-config-2026-07-01"`
31392
31393 - `"thinking-binding-controls-2026-08-01"`
31394
31395 - `"mid-conversation-system-clear-at-2026-08-21"`
31396
31397 - `"compact-2026-09-04"`
31398
31399 - `"inline-tools-2026-09-15"`
31400
31401 - `"mcp-client-2026-09-15"`
31402
31403 - `"ce-plugins-2026-09-01"`
31404
31405 - `"spend-limit-reads-2026-09-26"`
31406
31407 - `"telemetry-destinations-2026-08-11"`
31408
31409 - `"webhooks-2026-10-07"`
31410
31411#### Returns
31412
31413- `BetaOrganizationWebhookEndpointSigningSecret object`
31414
31415 An organization webhook endpoint's new signing secret.
31416
31417 - `signing_secret: string`
31418
31419 The new signing secret. Deliveries are signed with it from now on, and no other response returns it.
31420
31421#### Example
31422
31423```bash
31424curl https://api.anthropic.com/v1/organizations/webhooks/$WEBHOOK_ENDPOINT_ID/regenerate_signing_secret \
31425 -X POST \
31426 -H 'anthropic-version: 2023-06-01' \
31427 -H 'anthropic-beta: webhooks-2026-10-07' \
31428 -H "X-Api-Key: $ANTHROPIC_API_KEY"
31429```
31430
31431##### Response (200)
31432
31433```json
31434{
31435 "signing_secret": "signing_secret"
31436}
31437```
2973031438
No line in this hunk matches that.