anthropic 2.8.0 → 2.9.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (170) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +36 -0
  3. data/README.md +1 -1
  4. data/lib/anthropic/error_classes.rb +4 -0
  5. data/lib/anthropic/helpers/threads/beta_message_thread.rb +30 -6
  6. data/lib/anthropic/helpers/tools/runner.rb +21 -4
  7. data/lib/anthropic/helpers/tracing/streamed_message.rb +8 -1
  8. data/lib/anthropic/internal/tracing.rb +1 -0
  9. data/lib/anthropic/internal/type/file_input.rb +11 -0
  10. data/lib/anthropic/internal/util.rb +43 -11
  11. data/lib/anthropic/models/anthropic_beta.rb +44 -30
  12. data/lib/anthropic/models/beta/beta_managed_agents_agent_toolset_default_config.rb +1 -1
  13. data/lib/anthropic/models/beta/beta_managed_agents_agent_toolset_default_config_params.rb +1 -1
  14. data/lib/anthropic/models/beta/beta_managed_agents_auto_policy.rb +3 -1
  15. data/lib/anthropic/models/beta/beta_managed_agents_bash_tool_config.rb +1 -1
  16. data/lib/anthropic/models/beta/beta_managed_agents_bash_tool_config_params.rb +1 -1
  17. data/lib/anthropic/models/beta/beta_managed_agents_edit_tool_config.rb +1 -1
  18. data/lib/anthropic/models/beta/beta_managed_agents_edit_tool_config_params.rb +1 -1
  19. data/lib/anthropic/models/beta/beta_managed_agents_glob_tool_config.rb +1 -1
  20. data/lib/anthropic/models/beta/beta_managed_agents_glob_tool_config_params.rb +1 -1
  21. data/lib/anthropic/models/beta/beta_managed_agents_grep_tool_config.rb +1 -1
  22. data/lib/anthropic/models/beta/beta_managed_agents_grep_tool_config_params.rb +1 -1
  23. data/lib/anthropic/models/beta/beta_managed_agents_mcp_tool_config.rb +1 -1
  24. data/lib/anthropic/models/beta/beta_managed_agents_mcp_tool_config_params.rb +1 -1
  25. data/lib/anthropic/models/beta/beta_managed_agents_mcp_toolset_default_config.rb +1 -1
  26. data/lib/anthropic/models/beta/beta_managed_agents_mcp_toolset_default_config_params.rb +1 -1
  27. data/lib/anthropic/models/beta/beta_managed_agents_multiagent_coordinator_params.rb +3 -2
  28. data/lib/anthropic/models/beta/beta_managed_agents_multiagent_params.rb +1 -1
  29. data/lib/anthropic/models/beta/beta_managed_agents_read_tool_config.rb +1 -1
  30. data/lib/anthropic/models/beta/beta_managed_agents_read_tool_config_params.rb +1 -1
  31. data/lib/anthropic/models/beta/beta_managed_agents_web_fetch_tool_config.rb +1 -1
  32. data/lib/anthropic/models/beta/beta_managed_agents_web_fetch_tool_config_params.rb +1 -1
  33. data/lib/anthropic/models/beta/beta_managed_agents_web_search_tool_config.rb +1 -1
  34. data/lib/anthropic/models/beta/beta_managed_agents_web_search_tool_config_params.rb +1 -1
  35. data/lib/anthropic/models/beta/beta_managed_agents_write_tool_config.rb +1 -1
  36. data/lib/anthropic/models/beta/beta_managed_agents_write_tool_config_params.rb +1 -1
  37. data/lib/anthropic/models/beta/organization/beta_bundle_attachment_not_supported_error.rb +24 -0
  38. data/lib/anthropic/models/beta/organization/beta_bundle_attachment_not_supported_error_details.rb +22 -0
  39. data/lib/anthropic/models/beta/organization/beta_bundle_on_call_error.rb +24 -0
  40. data/lib/anthropic/models/beta/organization/beta_bundle_on_call_error_details.rb +22 -0
  41. data/lib/anthropic/models/beta/organization/beta_external_key.rb +2 -2
  42. data/lib/anthropic/models/beta/organization/beta_rbac_role.rb +14 -5
  43. data/lib/anthropic/models/beta/organization/beta_rbac_role_source.rb +52 -0
  44. data/lib/anthropic/models/beta/organization/beta_rbac_role_source_built_in.rb +25 -0
  45. data/lib/anthropic/models/beta/organization/beta_rbac_role_source_custom.rb +20 -0
  46. data/lib/anthropic/models/beta/organization/claude_tag/beta_claude_tag_bundle.rb +15 -2
  47. data/lib/anthropic/models/beta/organization/claude_tag/bundle_update_params.rb +50 -0
  48. data/lib/anthropic/models/beta/organization/external_key_create_params.rb +3 -2
  49. data/lib/anthropic/models/beta/organization/plugin_list_params.rb +2 -1
  50. data/lib/anthropic/models/beta/organization/plugin_marketplace_list_params.rb +2 -1
  51. data/lib/anthropic/models/beta/organization/plugin_marketplace_retrieve_params.rb +2 -1
  52. data/lib/anthropic/models/beta/organization/plugin_retrieve_params.rb +2 -1
  53. data/lib/anthropic/models/beta/organization/plugins/installation_setting_list_params.rb +2 -1
  54. data/lib/anthropic/models/beta/organization/plugins/share_list_params.rb +2 -1
  55. data/lib/anthropic/models/beta/organization/plugins/version_download_params.rb +2 -1
  56. data/lib/anthropic/models/beta/organization/plugins/version_list_params.rb +2 -1
  57. data/lib/anthropic/models/beta/organization/plugins/version_retrieve_params.rb +2 -1
  58. data/lib/anthropic/models/beta/organization/workspace_update_params.rb +2 -1
  59. data/lib/anthropic/models/beta/sessions/beta_managed_agents_agent_auto_evaluated_permission.rb +1 -1
  60. data/lib/anthropic/models/beta/sessions/beta_managed_agents_agent_auto_evaluated_permission_deny.rb +7 -4
  61. data/lib/anthropic/models/error_details.rb +28 -3
  62. data/lib/anthropic/models/organization/external_key.rb +2 -2
  63. data/lib/anthropic/models/organization/external_key_create_params.rb +3 -2
  64. data/lib/anthropic/models/organization/key_profile_mismatch_error.rb +3 -3
  65. data/lib/anthropic/models/organization/key_profile_mismatch_error_details.rb +3 -3
  66. data/lib/anthropic/models/organization/rbac_role.rb +14 -5
  67. data/lib/anthropic/models/organization/rbac_role_source.rb +50 -0
  68. data/lib/anthropic/models/organization/rbac_role_source_built_in.rb +22 -0
  69. data/lib/anthropic/models/organization/rbac_role_source_custom.rb +18 -0
  70. data/lib/anthropic/models/organization/workspace_update_params.rb +2 -1
  71. data/lib/anthropic/models/parent_organization_required_error.rb +20 -0
  72. data/lib/anthropic/models/parent_organization_required_error_details.rb +18 -0
  73. data/lib/anthropic/models/rbac_role_not_found_error.rb +19 -0
  74. data/lib/anthropic/models/rbac_role_not_found_error_details.rb +17 -0
  75. data/lib/anthropic/models.rb +8 -0
  76. data/lib/anthropic/resources/beta/messages/batches.rb +6 -6
  77. data/lib/anthropic/resources/beta/messages.rb +5 -1
  78. data/lib/anthropic/resources/beta/organization/claude_tag/bundles.rb +51 -0
  79. data/lib/anthropic/resources/beta/organization/rbac_roles/permissions.rb +4 -0
  80. data/lib/anthropic/resources/beta/organization/rbac_roles.rb +7 -0
  81. data/lib/anthropic/resources/organization/rbac_roles/permissions.rb +4 -0
  82. data/lib/anthropic/resources/organization/rbac_roles.rb +7 -0
  83. data/lib/anthropic/version.rb +1 -1
  84. data/lib/anthropic.rb +15 -0
  85. data/rbi/anthropic/helpers/bedrock/client.rbi +6 -2
  86. data/rbi/anthropic/helpers/bedrock/event_stream.rbi +12 -3
  87. data/rbi/anthropic/helpers/bedrock/mantle_client.rbi +3 -1
  88. data/rbi/anthropic/helpers/google_cloud/client.rbi +3 -1
  89. data/rbi/anthropic/helpers/refusal_fallback.rbi +12 -4
  90. data/rbi/anthropic/helpers/vertex/client.rbi +6 -2
  91. data/rbi/anthropic/internal/tracing.rbi +2 -0
  92. data/rbi/anthropic/internal/util.rbi +2 -2
  93. data/rbi/anthropic/models/anthropic_beta.rbi +41 -41
  94. data/rbi/anthropic/models/beta/beta_managed_agents_auto_policy.rbi +3 -1
  95. data/rbi/anthropic/models/beta/beta_managed_agents_multiagent_coordinator_params.rbi +3 -2
  96. data/rbi/anthropic/models/beta/organization/beta_bundle_attachment_not_supported_error.rbi +25 -0
  97. data/rbi/anthropic/models/beta/organization/beta_bundle_attachment_not_supported_error_details.rbi +32 -0
  98. data/rbi/anthropic/models/beta/organization/beta_bundle_on_call_error.rbi +23 -0
  99. data/rbi/anthropic/models/beta/organization/beta_bundle_on_call_error_details.rbi +32 -0
  100. data/rbi/anthropic/models/beta/organization/beta_external_key.rbi +4 -4
  101. data/rbi/anthropic/models/beta/organization/beta_rbac_role.rbi +23 -6
  102. data/rbi/anthropic/models/beta/organization/beta_rbac_role_source.rbi +78 -0
  103. data/rbi/anthropic/models/beta/organization/beta_rbac_role_source_built_in.rbi +36 -0
  104. data/rbi/anthropic/models/beta/organization/beta_rbac_role_source_custom.rbi +34 -0
  105. data/rbi/anthropic/models/beta/organization/claude_tag/beta_claude_tag_bundle.rbi +11 -1
  106. data/rbi/anthropic/models/beta/organization/claude_tag/bundle_update_params.rbi +88 -0
  107. data/rbi/anthropic/models/beta/organization/external_key_create_params.rbi +6 -4
  108. data/rbi/anthropic/models/beta/organization/plugin_list_params.rbi +4 -2
  109. data/rbi/anthropic/models/beta/organization/plugin_marketplace_list_params.rbi +4 -2
  110. data/rbi/anthropic/models/beta/organization/plugin_marketplace_retrieve_params.rbi +4 -2
  111. data/rbi/anthropic/models/beta/organization/plugin_retrieve_params.rbi +4 -2
  112. data/rbi/anthropic/models/beta/organization/plugins/installation_setting_list_params.rbi +4 -2
  113. data/rbi/anthropic/models/beta/organization/plugins/share_list_params.rbi +4 -2
  114. data/rbi/anthropic/models/beta/organization/plugins/version_download_params.rbi +4 -2
  115. data/rbi/anthropic/models/beta/organization/plugins/version_list_params.rbi +4 -2
  116. data/rbi/anthropic/models/beta/organization/plugins/version_retrieve_params.rbi +4 -2
  117. data/rbi/anthropic/models/beta/organization/workspace_update_params.rbi +4 -2
  118. data/rbi/anthropic/models/beta/sessions/beta_managed_agents_agent_auto_evaluated_permission_deny.rbi +10 -6
  119. data/rbi/anthropic/models/error_details.rbi +25 -1
  120. data/rbi/anthropic/models/organization/external_key.rbi +4 -4
  121. data/rbi/anthropic/models/organization/external_key_create_params.rbi +6 -4
  122. data/rbi/anthropic/models/organization/key_profile_mismatch_error.rbi +3 -3
  123. data/rbi/anthropic/models/organization/key_profile_mismatch_error_details.rbi +3 -3
  124. data/rbi/anthropic/models/organization/rbac_role.rbi +20 -6
  125. data/rbi/anthropic/models/organization/rbac_role_source.rbi +68 -0
  126. data/rbi/anthropic/models/organization/rbac_role_source_built_in.rbi +34 -0
  127. data/rbi/anthropic/models/organization/rbac_role_source_custom.rbi +32 -0
  128. data/rbi/anthropic/models/organization/workspace_update_params.rbi +4 -2
  129. data/rbi/anthropic/models/parent_organization_required_error.rbi +17 -0
  130. data/rbi/anthropic/models/parent_organization_required_error_details.rbi +28 -0
  131. data/rbi/anthropic/models/rbac_role_not_found_error.rbi +16 -0
  132. data/rbi/anthropic/models/rbac_role_not_found_error_details.rbi +27 -0
  133. data/rbi/anthropic/models.rbi +10 -0
  134. data/rbi/anthropic/resources/beta/organization/claude_tag/bundles.rbi +30 -0
  135. data/rbi/anthropic/resources/beta/organization/external_keys.rbi +3 -2
  136. data/rbi/anthropic/resources/beta/organization/plugin_marketplaces.rbi +4 -2
  137. data/rbi/anthropic/resources/beta/organization/plugins/installation_settings.rbi +2 -1
  138. data/rbi/anthropic/resources/beta/organization/plugins/shares.rbi +2 -1
  139. data/rbi/anthropic/resources/beta/organization/plugins/versions.rbi +6 -3
  140. data/rbi/anthropic/resources/beta/organization/plugins.rbi +4 -2
  141. data/rbi/anthropic/resources/beta/organization/workspaces.rbi +2 -1
  142. data/rbi/anthropic/resources/organization/external_keys.rbi +3 -2
  143. data/rbi/anthropic/resources/organization/workspaces.rbi +2 -1
  144. data/rbi/lib/anthropic/helpers/stainless_helper_header.rbi +6 -1
  145. data/sig/anthropic/helpers/sessions/event_accumulator.rbs +6 -2
  146. data/sig/anthropic/internal/tracing.rbs +1 -0
  147. data/sig/anthropic/internal/util.rbs +1 -1
  148. data/sig/anthropic/models/anthropic_beta.rbs +21 -21
  149. data/sig/anthropic/models/beta/organization/beta_bundle_attachment_not_supported_error.rbs +13 -0
  150. data/sig/anthropic/models/beta/organization/beta_bundle_attachment_not_supported_error_details.rbs +20 -0
  151. data/sig/anthropic/models/beta/organization/beta_bundle_on_call_error.rbs +13 -0
  152. data/sig/anthropic/models/beta/organization/beta_bundle_on_call_error_details.rbs +17 -0
  153. data/sig/anthropic/models/beta/organization/beta_rbac_role.rbs +5 -0
  154. data/sig/anthropic/models/beta/organization/beta_rbac_role_source.rbs +40 -0
  155. data/sig/anthropic/models/beta/organization/beta_rbac_role_source_built_in.rbs +17 -0
  156. data/sig/anthropic/models/beta/organization/beta_rbac_role_source_custom.rbs +17 -0
  157. data/sig/anthropic/models/beta/organization/claude_tag/beta_claude_tag_bundle.rbs +5 -0
  158. data/sig/anthropic/models/beta/organization/claude_tag/bundle_update_params.rbs +46 -0
  159. data/sig/anthropic/models/error_details.rbs +26 -0
  160. data/sig/anthropic/models/organization/rbac_role.rbs +5 -0
  161. data/sig/anthropic/models/organization/rbac_role_source.rbs +38 -0
  162. data/sig/anthropic/models/organization/rbac_role_source_built_in.rbs +15 -0
  163. data/sig/anthropic/models/organization/rbac_role_source_custom.rbs +15 -0
  164. data/sig/anthropic/models/parent_organization_required_error.rbs +9 -0
  165. data/sig/anthropic/models/parent_organization_required_error_details.rbs +14 -0
  166. data/sig/anthropic/models/rbac_role_not_found_error.rbs +9 -0
  167. data/sig/anthropic/models/rbac_role_not_found_error_details.rbs +14 -0
  168. data/sig/anthropic/models.rbs +8 -0
  169. data/sig/anthropic/resources/beta/organization/claude_tag/bundles.rbs +7 -0
  170. metadata +47 -2
@@ -51,7 +51,7 @@ module Anthropic
51
51
  # Tool calls require user confirmation before execution.
52
52
  variant :always_ask, -> { Anthropic::Beta::BetaManagedAgentsAlwaysAskPolicy }
53
53
 
54
- # The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
54
+ # The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask, or for some causes to deny, for example when the organization is out of credits or has reached a spend limit.
55
55
  variant :auto, -> { Anthropic::Beta::BetaManagedAgentsAutoPolicy }
56
56
 
57
57
  module Type
@@ -61,7 +61,7 @@ module Anthropic
61
61
  # Tool calls require user confirmation before execution.
62
62
  variant :always_ask, -> { Anthropic::Beta::BetaManagedAgentsAlwaysAskPolicy }
63
63
 
64
- # The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
64
+ # The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask, or for some causes to deny, for example when the organization is out of credits or has reached a spend limit.
65
65
  variant :auto, -> { Anthropic::Beta::BetaManagedAgentsAutoPolicy }
66
66
 
67
67
  module Type
@@ -44,7 +44,7 @@ module Anthropic
44
44
  # Tool calls require user confirmation before execution.
45
45
  variant :always_ask, -> { Anthropic::Beta::BetaManagedAgentsAlwaysAskPolicy }
46
46
 
47
- # The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
47
+ # The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask, or for some causes to deny, for example when the organization is out of credits or has reached a spend limit.
48
48
  variant :auto, -> { Anthropic::Beta::BetaManagedAgentsAutoPolicy }
49
49
 
50
50
  module Type
@@ -47,7 +47,7 @@ module Anthropic
47
47
  # Tool calls require user confirmation before execution.
48
48
  variant :always_ask, -> { Anthropic::Beta::BetaManagedAgentsAlwaysAskPolicy }
49
49
 
50
- # The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
50
+ # The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask, or for some causes to deny, for example when the organization is out of credits or has reached a spend limit.
51
51
  variant :auto, -> { Anthropic::Beta::BetaManagedAgentsAutoPolicy }
52
52
 
53
53
  module Type
@@ -37,7 +37,7 @@ module Anthropic
37
37
  # Tool calls require user confirmation before execution.
38
38
  variant :always_ask, -> { Anthropic::Beta::BetaManagedAgentsAlwaysAskPolicy }
39
39
 
40
- # The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
40
+ # The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask, or for some causes to deny, for example when the organization is out of credits or has reached a spend limit.
41
41
  variant :auto, -> { Anthropic::Beta::BetaManagedAgentsAutoPolicy }
42
42
 
43
43
  module Type
@@ -41,7 +41,7 @@ module Anthropic
41
41
  # Tool calls require user confirmation before execution.
42
42
  variant :always_ask, -> { Anthropic::Beta::BetaManagedAgentsAlwaysAskPolicy }
43
43
 
44
- # The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
44
+ # The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask, or for some causes to deny, for example when the organization is out of credits or has reached a spend limit.
45
45
  variant :auto, -> { Anthropic::Beta::BetaManagedAgentsAutoPolicy }
46
46
 
47
47
  module Type
@@ -22,8 +22,9 @@ module Anthropic
22
22
  required :type, const: :coordinator
23
23
 
24
24
  # @!method initialize(agents:, type: :coordinator)
25
- # A coordinator topology: the session's primary thread orchestrates work by
26
- # spawning session threads, each running an agent drawn from the `agents` roster.
25
+ # Recommendation: use `multiagent_20261001` instead of `coordinator`. A
26
+ # coordinator topology: the session's primary thread orchestrates work by spawning
27
+ # session threads, each running an agent drawn from the `agents` roster.
27
28
  #
28
29
  # Some parameter documentations has been truncated, see
29
30
  # {Anthropic::Models::Beta::BetaManagedAgentsMultiagentCoordinatorParams} for more
@@ -9,7 +9,7 @@ module Anthropic
9
9
 
10
10
  discriminator :type
11
11
 
12
- # A coordinator topology: the session's primary thread orchestrates work by spawning session threads, each running an agent drawn from the `agents` roster.
12
+ # Recommendation: use `multiagent_20261001` instead of `coordinator`. A coordinator topology: the session's primary thread orchestrates work by spawning session threads, each running an agent drawn from the `agents` roster.
13
13
  variant :coordinator, -> { Anthropic::Beta::BetaManagedAgentsMultiagentCoordinatorParams }
14
14
 
15
15
  # Multiagent configuration with three members, each enabled or disabled on its own. On an update, if the agent's stored `multiagent` also has type `multiagent_20261001`, this configuration is merged into the stored one, level by level, instead of replacing it. A key that the update omits keeps its stored value. A key sent as null takes its default, on create as well, so `"workflows": null` enables workflows. An object sent with a `type` other than the stored one replaces the stored object, and the keys that it omits take their defaults. A `predefined_agents` list that is sent replaces the stored list. Every object that is sent needs its `type`, and an enabled `advisor` needs its `model`. Other validation applies to the merged result.
@@ -51,7 +51,7 @@ module Anthropic
51
51
  # Tool calls require user confirmation before execution.
52
52
  variant :always_ask, -> { Anthropic::Beta::BetaManagedAgentsAlwaysAskPolicy }
53
53
 
54
- # The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
54
+ # The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask, or for some causes to deny, for example when the organization is out of credits or has reached a spend limit.
55
55
  variant :auto, -> { Anthropic::Beta::BetaManagedAgentsAutoPolicy }
56
56
 
57
57
  module Type
@@ -61,7 +61,7 @@ module Anthropic
61
61
  # Tool calls require user confirmation before execution.
62
62
  variant :always_ask, -> { Anthropic::Beta::BetaManagedAgentsAlwaysAskPolicy }
63
63
 
64
- # The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
64
+ # The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask, or for some causes to deny, for example when the organization is out of credits or has reached a spend limit.
65
65
  variant :auto, -> { Anthropic::Beta::BetaManagedAgentsAutoPolicy }
66
66
 
67
67
  module Type
@@ -84,7 +84,7 @@ module Anthropic
84
84
  # Tool calls require user confirmation before execution.
85
85
  variant :always_ask, -> { Anthropic::Beta::BetaManagedAgentsAlwaysAskPolicy }
86
86
 
87
- # The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
87
+ # The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask, or for some causes to deny, for example when the organization is out of credits or has reached a spend limit.
88
88
  variant :auto, -> { Anthropic::Beta::BetaManagedAgentsAutoPolicy }
89
89
 
90
90
  module Type
@@ -100,7 +100,7 @@ module Anthropic
100
100
  # Tool calls require user confirmation before execution.
101
101
  variant :always_ask, -> { Anthropic::Beta::BetaManagedAgentsAlwaysAskPolicy }
102
102
 
103
- # The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
103
+ # The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask, or for some causes to deny, for example when the organization is out of credits or has reached a spend limit.
104
104
  variant :auto, -> { Anthropic::Beta::BetaManagedAgentsAutoPolicy }
105
105
 
106
106
  module Type
@@ -73,7 +73,7 @@ module Anthropic
73
73
  # Tool calls require user confirmation before execution.
74
74
  variant :always_ask, -> { Anthropic::Beta::BetaManagedAgentsAlwaysAskPolicy }
75
75
 
76
- # The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
76
+ # The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask, or for some causes to deny, for example when the organization is out of credits or has reached a spend limit.
77
77
  variant :auto, -> { Anthropic::Beta::BetaManagedAgentsAutoPolicy }
78
78
 
79
79
  module Type
@@ -91,7 +91,7 @@ module Anthropic
91
91
  # Tool calls require user confirmation before execution.
92
92
  variant :always_ask, -> { Anthropic::Beta::BetaManagedAgentsAlwaysAskPolicy }
93
93
 
94
- # The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
94
+ # The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask, or for some causes to deny, for example when the organization is out of credits or has reached a spend limit.
95
95
  variant :auto, -> { Anthropic::Beta::BetaManagedAgentsAutoPolicy }
96
96
 
97
97
  module Type
@@ -51,7 +51,7 @@ module Anthropic
51
51
  # Tool calls require user confirmation before execution.
52
52
  variant :always_ask, -> { Anthropic::Beta::BetaManagedAgentsAlwaysAskPolicy }
53
53
 
54
- # The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
54
+ # The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask, or for some causes to deny, for example when the organization is out of credits or has reached a spend limit.
55
55
  variant :auto, -> { Anthropic::Beta::BetaManagedAgentsAutoPolicy }
56
56
 
57
57
  module Type
@@ -61,7 +61,7 @@ module Anthropic
61
61
  # Tool calls require user confirmation before execution.
62
62
  variant :always_ask, -> { Anthropic::Beta::BetaManagedAgentsAlwaysAskPolicy }
63
63
 
64
- # The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
64
+ # The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask, or for some causes to deny, for example when the organization is out of credits or has reached a spend limit.
65
65
  variant :auto, -> { Anthropic::Beta::BetaManagedAgentsAutoPolicy }
66
66
 
67
67
  module Type
@@ -0,0 +1,24 @@
1
+ # frozen_string_literal: true
2
+
3
+ module Anthropic
4
+ module Models
5
+ module Beta
6
+ module Organization
7
+ # The Bundle has an attachment this API does not support editing, so its
8
+ # instructions can be changed only in claude.ai.
9
+ class BetaBundleAttachmentNotSupportedError < Anthropic::Errors::BadRequestError
10
+ # @!method error_code
11
+ # @return [Symbol, :bundle_attachment_not_supported]
12
+
13
+ # @return [Anthropic::Models::Beta::Organization::BetaBundleAttachmentNotSupportedErrorDetails]
14
+ def details
15
+ Anthropic::Internal::Type::Converter.coerce(
16
+ Anthropic::Beta::Organization::BetaBundleAttachmentNotSupportedErrorDetails,
17
+ Anthropic::Internal::Util.dig(body, [:error, :details])
18
+ )
19
+ end
20
+ end
21
+ end
22
+ end
23
+ end
24
+ end
@@ -0,0 +1,22 @@
1
+ # frozen_string_literal: true
2
+
3
+ module Anthropic
4
+ module Models
5
+ module Beta
6
+ module Organization
7
+ class BetaBundleAttachmentNotSupportedErrorDetails < Anthropic::Internal::Type::BaseModel
8
+ # @!attribute error_code
9
+ #
10
+ # @return [Symbol, :bundle_attachment_not_supported]
11
+ required :error_code, const: :bundle_attachment_not_supported
12
+
13
+ # @!method initialize(error_code: :bundle_attachment_not_supported)
14
+ # The Bundle has an attachment this API does not support editing, so its
15
+ # instructions can be changed only in claude.ai.
16
+ #
17
+ # @param error_code [Symbol, :bundle_attachment_not_supported]
18
+ end
19
+ end
20
+ end
21
+ end
22
+ end
@@ -0,0 +1,24 @@
1
+ # frozen_string_literal: true
2
+
3
+ module Anthropic
4
+ module Models
5
+ module Beta
6
+ module Organization
7
+ # This Bundle's instructions are managed in claude.ai and can't be changed through
8
+ # the API.
9
+ class BetaBundleOnCallError < Anthropic::Errors::BadRequestError
10
+ # @!method error_code
11
+ # @return [Symbol, :bundle_on_call]
12
+
13
+ # @return [Anthropic::Models::Beta::Organization::BetaBundleOnCallErrorDetails]
14
+ def details
15
+ Anthropic::Internal::Type::Converter.coerce(
16
+ Anthropic::Beta::Organization::BetaBundleOnCallErrorDetails,
17
+ Anthropic::Internal::Util.dig(body, [:error, :details])
18
+ )
19
+ end
20
+ end
21
+ end
22
+ end
23
+ end
24
+ end
@@ -0,0 +1,22 @@
1
+ # frozen_string_literal: true
2
+
3
+ module Anthropic
4
+ module Models
5
+ module Beta
6
+ module Organization
7
+ class BetaBundleOnCallErrorDetails < Anthropic::Internal::Type::BaseModel
8
+ # @!attribute error_code
9
+ #
10
+ # @return [Symbol, :bundle_on_call]
11
+ required :error_code, const: :bundle_on_call
12
+
13
+ # @!method initialize(error_code: :bundle_on_call)
14
+ # This Bundle's instructions are managed in claude.ai and can't be changed through
15
+ # the API.
16
+ #
17
+ # @param error_code [Symbol, :bundle_on_call]
18
+ end
19
+ end
20
+ end
21
+ end
22
+ end
@@ -58,8 +58,8 @@ module Anthropic
58
58
  # @!attribute user_profile_id
59
59
  # ID of the user profile the key is bound to, or null if the key is not bound to
60
60
  # one. A key bound to a user profile can only be attached to a Workspace that has
61
- # the same user profile. A key that isn't bound can be attached to a Workspace
62
- # whatever its user profile.
61
+ # the same user profile. A key that isn't bound can only be attached to a
62
+ # Workspace that has no user profile.
63
63
  #
64
64
  # @return [String, nil]
65
65
  required :user_profile_id, String, nil?: true
@@ -19,13 +19,20 @@ module Anthropic
19
19
  required :created_at, Time
20
20
 
21
21
  # @!attribute display_name
22
- # Name of the RBAC Role. For a role created by Anthropic, this is Anthropic's name
23
- # for the access that the role grants. Anthropic may change this name, so to keep
24
- # a lasting reference to a role, store its `id`.
22
+ # Name of the RBAC Role. For a built-in role, this is Anthropic's name for the
23
+ # access that the role grants. Anthropic may change this name, so to keep a
24
+ # lasting reference to a role, store its `id`.
25
25
  #
26
26
  # @return [String]
27
27
  required :display_name, String
28
28
 
29
+ # @!attribute source
30
+ # Whether the RBAC Role is built-in or custom. More values of `type` may be added,
31
+ # so do not treat every role that is not `built_in` as `custom`.
32
+ #
33
+ # @return [Anthropic::Models::Beta::Organization::BetaRBACRoleSourceBuiltIn, Anthropic::Models::Beta::Organization::BetaRBACRoleSourceCustom]
34
+ required :source, union: -> { Anthropic::Beta::Organization::BetaRBACRoleSource }
35
+
29
36
  # @!attribute type
30
37
  # Object type.
31
38
  #
@@ -40,7 +47,7 @@ module Anthropic
40
47
  # @return [Time]
41
48
  required :updated_at, Time
42
49
 
43
- # @!method initialize(id:, created_at:, display_name:, updated_at:, type: :rbac_role)
50
+ # @!method initialize(id:, created_at:, display_name:, source:, updated_at:, type: :rbac_role)
44
51
  # Some parameter documentations has been truncated, see
45
52
  # {Anthropic::Models::Beta::Organization::BetaRBACRole} for more details.
46
53
  #
@@ -48,7 +55,9 @@ module Anthropic
48
55
  #
49
56
  # @param created_at [Time] RFC 3339 datetime string indicating when the RBAC Role was created.
50
57
  #
51
- # @param display_name [String] Name of the RBAC Role. For a role created by Anthropic, this is Anthropic's name
58
+ # @param display_name [String] Name of the RBAC Role. For a built-in role, this is Anthropic's name for the acc
59
+ #
60
+ # @param source [Anthropic::Models::Beta::Organization::BetaRBACRoleSourceBuiltIn, Anthropic::Models::Beta::Organization::BetaRBACRoleSourceCustom] Whether the RBAC Role is built-in or custom. More values of `type` may be added,
52
61
  #
53
62
  # @param updated_at [Time] RFC 3339 datetime string indicating when the RBAC Role was last updated.
54
63
  #
@@ -0,0 +1,52 @@
1
+ # frozen_string_literal: true
2
+
3
+ module Anthropic
4
+ module Models
5
+ module Beta
6
+ module Organization
7
+ module BetaRBACRoleSource
8
+ extend Anthropic::Internal::Type::Union
9
+
10
+ discriminator :type
11
+
12
+ variant :built_in, -> { Anthropic::Beta::Organization::BetaRBACRoleSourceBuiltIn }
13
+
14
+ variant :custom, -> { Anthropic::Beta::Organization::BetaRBACRoleSourceCustom }
15
+
16
+ module Type
17
+ extend Anthropic::Internal::Type::Enum
18
+
19
+ BUILT_IN = :built_in
20
+ CUSTOM = :custom
21
+
22
+ # @!method self.values
23
+ # @return [Array<Symbol>]
24
+ end
25
+
26
+ # @!method self.variants
27
+ # @return [Array(Anthropic::Models::Beta::Organization::BetaRBACRoleSourceBuiltIn, Anthropic::Models::Beta::Organization::BetaRBACRoleSourceCustom)]
28
+
29
+ # Creates a new instance of the variant class whose `type` matches the given
30
+ # value, passing the remaining arguments to its constructor.
31
+ #
32
+ # @param type [Symbol, Anthropic::Models::Beta::Organization::BetaRBACRoleSource::Type, String]
33
+ #
34
+ # @param args [Hash{Symbol=>Object}] Attributes for the chosen variant.
35
+ #
36
+ # @raise [ArgumentError]
37
+ # @return [Anthropic::Models::Beta::Organization::BetaRBACRoleSourceBuiltIn, Anthropic::Models::Beta::Organization::BetaRBACRoleSourceCustom]
38
+ def self.new(type:, **args)
39
+ case type.to_sym
40
+ when :built_in
41
+ Anthropic::Beta::Organization::BetaRBACRoleSourceBuiltIn.new(**args)
42
+ when :custom
43
+ Anthropic::Beta::Organization::BetaRBACRoleSourceCustom.new(**args)
44
+ else
45
+ raise ArgumentError, "unknown type: #{type}"
46
+ end
47
+ end
48
+ end
49
+ end
50
+ end
51
+ end
52
+ end
@@ -0,0 +1,25 @@
1
+ # frozen_string_literal: true
2
+
3
+ module Anthropic
4
+ module Models
5
+ module Beta
6
+ module Organization
7
+ class BetaRBACRoleSourceBuiltIn < Anthropic::Internal::Type::BaseModel
8
+ # @!attribute type
9
+ # Anthropic provisions the RBAC Role, and the organization's administrators cannot
10
+ # change or delete it.
11
+ #
12
+ # @return [Symbol, :built_in]
13
+ required :type, const: :built_in
14
+
15
+ # @!method initialize(type: :built_in)
16
+ # Some parameter documentations has been truncated, see
17
+ # {Anthropic::Models::Beta::Organization::BetaRBACRoleSourceBuiltIn} for more
18
+ # details.
19
+ #
20
+ # @param type [Symbol, :built_in] Anthropic provisions the RBAC Role, and the organization's administrators cannot
21
+ end
22
+ end
23
+ end
24
+ end
25
+ end
@@ -0,0 +1,20 @@
1
+ # frozen_string_literal: true
2
+
3
+ module Anthropic
4
+ module Models
5
+ module Beta
6
+ module Organization
7
+ class BetaRBACRoleSourceCustom < Anthropic::Internal::Type::BaseModel
8
+ # @!attribute type
9
+ # The organization's administrators can change and delete the RBAC Role.
10
+ #
11
+ # @return [Symbol, :custom]
12
+ required :type, const: :custom
13
+
14
+ # @!method initialize(type: :custom)
15
+ # @param type [Symbol, :custom] The organization's administrators can change and delete the RBAC Role.
16
+ end
17
+ end
18
+ end
19
+ end
20
+ end
@@ -31,6 +31,13 @@ module Anthropic
31
31
  # @return [String]
32
32
  required :display_name, String
33
33
 
34
+ # @!attribute instructions
35
+ # Instructions for Claude, added to the instructions of every session that can use
36
+ # the Bundle. Null when it has none.
37
+ #
38
+ # @return [String, nil]
39
+ required :instructions, String, nil?: true
40
+
34
41
  # @!attribute type
35
42
  #
36
43
  # @return [Symbol, :bundle]
@@ -42,10 +49,14 @@ module Anthropic
42
49
  # @return [Time]
43
50
  required :updated_at, Time
44
51
 
45
- # @!method initialize(id:, created_at:, description:, display_name:, updated_at:, type: :bundle)
52
+ # @!method initialize(id:, created_at:, description:, display_name:, instructions:, updated_at:, type: :bundle)
46
53
  # A named set of access that Claude can use in a Slack channel or a Slack
47
54
  # workspace: connectors, repositories and credentials. Created and edited in
48
- # claude.ai.
55
+ # claude.ai; Update Bundle also changes its instructions.
56
+ #
57
+ # Some parameter documentations has been truncated, see
58
+ # {Anthropic::Models::Beta::Organization::ClaudeTag::BetaClaudeTagBundle} for more
59
+ # details.
49
60
  #
50
61
  # @param id [String] The Bundle's identifier. Starts with `capp_`.
51
62
  #
@@ -55,6 +66,8 @@ module Anthropic
55
66
  #
56
67
  # @param display_name [String] The Bundle's name. Always set. Read-only.
57
68
  #
69
+ # @param instructions [String, nil] Instructions for Claude, added to the instructions of every session that can use
70
+ #
58
71
  # @param updated_at [Time] Time of the last change to the Bundle.
59
72
  #
60
73
  # @param type [Symbol, :bundle]
@@ -0,0 +1,50 @@
1
+ # frozen_string_literal: true
2
+
3
+ module Anthropic
4
+ module Models
5
+ module Beta
6
+ module Organization
7
+ module ClaudeTag
8
+ # @see Anthropic::Resources::Beta::Organization::ClaudeTag::Bundles#update
9
+ class BundleUpdateParams < Anthropic::Internal::Type::BaseModel
10
+ extend Anthropic::Internal::Type::RequestParameters::Converter
11
+ include Anthropic::Internal::Type::RequestParameters
12
+
13
+ # @!attribute bundle_id
14
+ # The Bundle's identifier, starting with `capp_`.
15
+ #
16
+ # @return [String]
17
+ required :bundle_id, String
18
+
19
+ # @!attribute instructions
20
+ # Instructions for Claude, up to 10,000 bytes (UTF-8), added to the instructions
21
+ # of every session that can use the Bundle. Null or an empty string clears them.
22
+ #
23
+ # @return [String, nil]
24
+ optional :instructions, String, nil?: true
25
+
26
+ # @!attribute betas
27
+ # This endpoint is in beta: requests must send
28
+ # `experimental-claude-tag-2026-10-21` in this header.
29
+ #
30
+ # @return [Array<Symbol, String, Anthropic::Models::AnthropicBeta>, nil]
31
+ optional :betas, -> { Anthropic::Internal::Type::ArrayOf[union: Anthropic::AnthropicBeta] }
32
+
33
+ # @!method initialize(bundle_id:, instructions: nil, betas: nil, request_options: {})
34
+ # Some parameter documentations has been truncated, see
35
+ # {Anthropic::Models::Beta::Organization::ClaudeTag::BundleUpdateParams} for more
36
+ # details.
37
+ #
38
+ # @param bundle_id [String] The Bundle's identifier, starting with `capp_`.
39
+ #
40
+ # @param instructions [String, nil] Instructions for Claude, up to 10,000 bytes (UTF-8), added to the instructions o
41
+ #
42
+ # @param betas [Array<Symbol, String, Anthropic::Models::AnthropicBeta>] This endpoint is in beta: requests must send
43
+ #
44
+ # @param request_options [Anthropic::RequestOptions, Hash{Symbol=>Object}]
45
+ end
46
+ end
47
+ end
48
+ end
49
+ end
50
+ end
@@ -33,8 +33,9 @@ module Anthropic
33
33
  # customers: bind a customer's key to that customer's user profile. A key bound to
34
34
  # a user profile can only be attached to a Workspace that has the same user
35
35
  # profile, and the binding cannot be changed later. Omit this field only for your
36
- # organization's own key, because a key created without a user profile ID can be
37
- # attached to any Workspace, including another customer's.
36
+ # organization's own key, never a customer's. A key created without a user profile
37
+ # ID can't be attached to a Workspace that has a user profile, and you can't add
38
+ # one to the key later.
38
39
  #
39
40
  # @return [String, nil]
40
41
  optional :user_profile_id, String, nil?: true
@@ -54,7 +54,8 @@ module Anthropic
54
54
  # organization's UUID or its `org_`-prefixed ID. A value that is neither returns a
55
55
  # 400; an organization that is not a child of the key's parent, or where the
56
56
  # Plugins API is not available, returns a 404. Any other key may pass only its own
57
- # organization's ID here; another organization returns a 404.
57
+ # organization's ID here; another organization returns a 404. A key with no
58
+ # organization of its own must always pass `organization_id`.
58
59
  #
59
60
  # @return [String, nil]
60
61
  optional :organization_id, String, nil?: true
@@ -24,7 +24,8 @@ module Anthropic
24
24
  # organization's UUID or its `org_`-prefixed ID. A value that is neither returns a
25
25
  # 400; an organization that is not a child of the key's parent, or where the
26
26
  # Plugins API is not available, returns a 404. Any other key may pass only its own
27
- # organization's ID here; another organization returns a 404.
27
+ # organization's ID here; another organization returns a 404. A key with no
28
+ # organization of its own must always pass `organization_id`.
28
29
  #
29
30
  # @return [String, nil]
30
31
  optional :organization_id, String, nil?: true
@@ -22,7 +22,8 @@ module Anthropic
22
22
  # organization's UUID or its `org_`-prefixed ID. A value that is neither returns a
23
23
  # 400; an organization that is not a child of the key's parent, or where the
24
24
  # Plugins API is not available, returns a 404. Any other key may pass only its own
25
- # organization's ID here; another organization returns a 404.
25
+ # organization's ID here; another organization returns a 404. A key with no
26
+ # organization of its own must always pass `organization_id`.
26
27
  #
27
28
  # @return [String, nil]
28
29
  optional :organization_id, String, nil?: true
@@ -22,7 +22,8 @@ module Anthropic
22
22
  # organization's UUID or its `org_`-prefixed ID. A value that is neither returns a
23
23
  # 400; an organization that is not a child of the key's parent, or where the
24
24
  # Plugins API is not available, returns a 404. Any other key may pass only its own
25
- # organization's ID here; another organization returns a 404.
25
+ # organization's ID here; another organization returns a 404. A key with no
26
+ # organization of its own must always pass `organization_id`.
26
27
  #
27
28
  # @return [String, nil]
28
29
  optional :organization_id, String, nil?: true
@@ -31,7 +31,8 @@ module Anthropic
31
31
  # organization's UUID or its `org_`-prefixed ID. A value that is neither returns a
32
32
  # 400; an organization that is not a child of the key's parent, or where the
33
33
  # Plugins API is not available, returns a 404. Any other key may pass only its own
34
- # organization's ID here; another organization returns a 404.
34
+ # organization's ID here; another organization returns a 404. A key with no
35
+ # organization of its own must always pass `organization_id`.
35
36
  #
36
37
  # @return [String, nil]
37
38
  optional :organization_id, String, nil?: true
@@ -31,7 +31,8 @@ module Anthropic
31
31
  # organization's UUID or its `org_`-prefixed ID. A value that is neither returns a
32
32
  # 400; an organization that is not a child of the key's parent, or where the
33
33
  # Plugins API is not available, returns a 404. Any other key may pass only its own
34
- # organization's ID here; another organization returns a 404.
34
+ # organization's ID here; another organization returns a 404. A key with no
35
+ # organization of its own must always pass `organization_id`.
35
36
  #
36
37
  # @return [String, nil]
37
38
  optional :organization_id, String, nil?: true
@@ -29,7 +29,8 @@ module Anthropic
29
29
  # organization's UUID or its `org_`-prefixed ID. A value that is neither returns a
30
30
  # 400; an organization that is not a child of the key's parent, or where the
31
31
  # Plugins API is not available, returns a 404. Any other key may pass only its own
32
- # organization's ID here; another organization returns a 404.
32
+ # organization's ID here; another organization returns a 404. A key with no
33
+ # organization of its own must always pass `organization_id`.
33
34
  #
34
35
  # @return [String, nil]
35
36
  optional :organization_id, String, nil?: true
@@ -31,7 +31,8 @@ module Anthropic
31
31
  # organization's UUID or its `org_`-prefixed ID. A value that is neither returns a
32
32
  # 400; an organization that is not a child of the key's parent, or where the
33
33
  # Plugins API is not available, returns a 404. Any other key may pass only its own
34
- # organization's ID here; another organization returns a 404.
34
+ # organization's ID here; another organization returns a 404. A key with no
35
+ # organization of its own must always pass `organization_id`.
35
36
  #
36
37
  # @return [String, nil]
37
38
  optional :organization_id, String, nil?: true