One read of Claude Developer Platformapi-20261014T203720Z
294 pages moved out of 778 read.
Pages moved
294
significant first
Pages read
778
in this capture
Captured
20:37 UTC
Corpus hash
4df5ec3cdb5f
index-hash
What this read moved
1-25 of 294, page 1 of 12This capture is too large to show at once. Changes 1-25 of 294 are below, significant first; the rest are on the following screens.
agents-and-tools/mcp-tunnels/console Changed · +9 / -9 lines
from line 25
2525
2626<Steps>
2727 <Step title="Open the MCP tunnels page">
28 In the Console sidebar, go to **Manage > MCP tunnels**. Tunnels are workspace-scoped; the new tunnel belongs to the workspace currently selected in the Console, so switch workspaces first if you want it elsewhere.
28 In the Claude Console, go to the [MCP tunnels](https://platform.claude.com/settings/workspaces/default/mcp-tunnels) page (`platform.claude.com/settings/workspaces/default/mcp-tunnels`). Tunnels are workspace-scoped; the new tunnel belongs to the workspace currently selected in the Console. Select the workspace you want in the workspace picker in the sidebar.
2929 </Step>
3030
3131 <Step title="Name the tunnel">
from line 37
3737
3838 Programmatic access relies on [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation); read that page first if federation issuers, rules, and service accounts are unfamiliar. To turn the toggle on you need:
3939
40 1. **A registered OIDC issuer** for the identity provider your stack presents tokens from (such as a Kubernetes cluster, AWS IAM, Google Cloud, or GitHub Actions). Register one under **Settings > Workload identity > Issuers** if your organization doesn't have one.
40 1. **A registered OIDC issuer** for the identity provider your stack presents tokens from (such as a Kubernetes cluster, AWS IAM, Google Cloud, or GitHub Actions). Register one on the **Issuers** tab of the [Workload identity](https://platform.claude.com/settings/workload-identity-federation) page (`platform.claude.com/settings/workload-identity-federation`) in the Claude Console if your organization doesn't have one.
4141 2. **A federation rule with the `workspace:manage_tunnels` scope.** Turning on the toggle reveals a **Federation rule** picker. Choose an existing rule with that scope, or click **Create federation rule** to create one inline.
4242 3. **The rule's service account added to this workspace.** The Tunnels API authorizes against the service account's workspace memberships. If you're creating the tunnel in a workspace other than the organization's default, [add the service account to that workspace](https://platform.claude.com/docs/en/manage-claude/workspaces#role-inheritance) and pass the workspace ID at deploy time (`api.wif.workspaceId` for Helm, `ANTHROPIC_WORKSPACE_ID` for Compose).
4343
from line 56
5656
5757 What else you need depends on the [credential-provisioning mode](https://platform.claude.com/docs/en/agents-and-tools/mcp-tunnels/concepts#credential-provisioning):
5858
59 | With programmatic access | Without programmatic access |
60 | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
61 | The **federation rule ID** (`fdrl_...`) of the rule you selected. The rule is org-level, not stored on the tunnel; find it under **Settings > Workload identity > Rules**. | The **tunnel token**, revealed with the eye icon next to **Token** on the detail page. Treat it as a secret. See [Get the connection details](https://platform.claude.com/docs/en/agents-and-tools/mcp-tunnels/console#get-the-connection-details). |
62 | The **organization ID** (a UUID), shown under **Settings > Organization**. | A **CA certificate** that you generate and [register on the tunnel](https://platform.claude.com/docs/en/agents-and-tools/mcp-tunnels/console#add-a-ca-certificate). |
59 | With programmatic access | Without programmatic access |
60 | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
61 | The **federation rule ID** (`fdrl_...`) of the rule you selected. The rule is org-level, not stored on the tunnel; find it on the **Rules** tab of the [Workload identity](https://platform.claude.com/settings/workload-identity-federation?tab=rules) page (`platform.claude.com/settings/workload-identity-federation?tab=rules`) in the Claude Console. | The **tunnel token**, revealed with the eye icon next to **Token** on the detail page. Treat it as a secret. See [Get the connection details](https://platform.claude.com/docs/en/agents-and-tools/mcp-tunnels/console#get-the-connection-details). |
62 | The **organization ID** (a UUID), shown on the [Organization](https://platform.claude.com/settings/organization) page (`platform.claude.com/settings/organization`) in the Claude Console. | A **CA certificate** that you generate and [register on the tunnel](https://platform.claude.com/docs/en/agents-and-tools/mcp-tunnels/console#add-a-ca-certificate). |
6363
6464 With programmatic access, your stack fetches the tunnel token through the Tunnels API, generates the CA and server certificate locally (the private key never leaves your environment), and registers only the CA's public certificate with Anthropic. You're still responsible for securing the private keys and renewing the server certificate before it expires.
6565 </Step>
from line 123
123123</Note>
124124
125125<Steps>
126 <Step title="Open the New session modal">
127 Go to **Managed Agents > Sessions** and click **New session**.
126 <Step title="Open the Create session dialog">
127 In the Claude Console, go to the [Sessions](https://platform.claude.com/sessions) page (`platform.claude.com/sessions`) and click **Create session**.
128128 </Step>
129129
130130 <Step title="Define an inline agent">
from line 148
148148
149149Archiving immediately stops the tunnel from accepting connections and is permanent.
150150
151In the **MCP tunnels** list, open the row menu for the tunnel and choose **Archive**. Archived tunnels remain visible when you filter the list by **Archived** or **All**.
151In the Claude Console, go to the [MCP tunnels](https://platform.claude.com/settings/workspaces/default/mcp-tunnels) page (`platform.claude.com/settings/workspaces/default/mcp-tunnels`). In the workspace picker in the sidebar, select the workspace that holds the tunnel. Open the row menu for the tunnel and choose **Archive**. Archived tunnels remain visible when you filter the list by **Archived** or **All**.
152152
153153## Next steps
154154
api/beta Changed · +3446 / -3 lines
## Beta › Organization › Telemetry Destinations ### Create a Telemetry Destination ### List Telemetry Destinations ### Retrieve a Telemetry Destination ### Update a Telemetry Destination ### Delete a Telemetry Destination ### Test a Telemetry Destination ## Beta › Organization › Telemetry Destinations › Workspaces ### List Telemetry Destination Workspaces ### Add a Telemetry Destination Workspace ### Remove a Telemetry Destination Workspace
This page is larger than the 256 KiB this site keeps, so one side of the diff below stops where the stored text does.
from line 9
99
1010### Anthropic Beta
1111
12- `AnthropicBeta = string or "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 47 more`
12- `AnthropicBeta = string or "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 48 more`
1313
1414 - `string`
1515
from line 113
113113
114114 - `"spend-limit-reads-2026-09-26"`
115115
116 - `"telemetry-destinations-2026-08-11"`
117
116118### Beta API Error
117119
118120- `BetaAPIError object`
from line 591
589591
590592 - `"spend-limit-reads-2026-09-26"`
591593
594 - `"telemetry-destinations-2026-08-11"`
595
592596- `"anthropic-workspace-id": optional string`
593597
594598 Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
from line 1065
10611065
10621066 - `"spend-limit-reads-2026-09-26"`
10631067
1068 - `"telemetry-destinations-2026-08-11"`
1069
10641070- `"anthropic-workspace-id": optional string`
10651071
10661072 Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
from line 1518
15121518
15131519 - `"spend-limit-reads-2026-09-26"`
15141520
1521 - `"telemetry-destinations-2026-08-11"`
1522
15151523- `"anthropic-user-profile-id": optional string`
15161524
15171525 The user profile ID to attribute this request to. Use when acting on behalf of a party other than your organization. Requires the `user-profiles` beta header.
from line 7717
77097717
77107718 `zoom`'s config overrides.
77117719
7712 - `defer_loading: optional boolean or null`
7713
7714 Defer loading for this member. Must resolve to the same value on every enabled member of the toolset.
7715
7716
7720 - `defer_load
api/beta/agents Changed · +322 / -0 lines
### Beta Managed Agents AWS Role Execution Identity ### Beta Managed Agents AWS Role Execution Identity Params ### Beta Managed Agents Execution Identity ### Beta Managed Agents Execution Identity Params ### Beta Managed Agents Service Account Execution Identity ### Beta Managed Agents Service Account Execution Identity Params
This page is larger than the 256 KiB this site keeps, so one side of the diff below stops where the stored text does.
from line 121
121121
122122 - `"spend-limit-reads-2026-09-26"`
123123
124 - `"telemetry-destinations-2026-08-11"`
125
124126- `"anthropic-workspace-id": optional string`
125127
126128 Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
from line 299
297299
298300 maxLength: 2048
299301
302- `execution_identity: optional BetaManagedAgentsExecutionIdentityParams or null`
303
304 Execution principal for runs of this agent. Omitting it, sending null, or sending `{"type": "service_account"}` stores the default.
305
306 - `BetaManagedAgentsAWSRoleExecutionIdentityParams object`
307
308 An AWS IAM role principal.
309
310 - `type: "aws_role"`
311
312 - `role_arn: string`
313
314 The IAM role's ARN, e.g. "arn:aws:iam::123456789012:role/my-agent-runner". Maximum 2048 characters.
315
316 maxLength: 2048
317
318 - `BetaManagedAgentsServiceAccountExecutionIdentityParams object`
319
320 The Anthropic-managed service account — the default execution principal. Carries no identifier.
321
322 - `type: "service_account"`
323
300324- `mcp_servers: optional array of BetaManagedAgentsURLMCPServerParams`
301325
302326 MCP servers this agent connects to. Maximum 20. Names must be unique within the array. Every server must be referenced by an `mcp_toolset` in `tools`; unreferenced servers are rejected. See the [MCP connector guide](https://platform.claude.com/docs/en/managed-agents/mcp-connector?sdk_languages=http).
from line 1099
10751099
10761100 - `description: string or null`
10771101
1102 - `execution_identity: BetaManagedAgentsExecutionIdentity`
1103
1104 Execution principal for runs of this agent. Always present; `{"type": "service_account"}` when runs carry no customer-named principal.
1105
1106 - `BetaManagedAgentsAWSRoleExecutionIdentity object`
1107
1108 An AWS IAM role principal as returned in API responses.
1109
1110 - `type: "aws_role"`
1111
1112 - `role_arn: string`
1113
1114 The IAM role's ARN.
1115
1116 - `BetaManagedAgentsServiceAccountExecutionIdentity object`
1117
1118 The Anthropic-managed service account as returned in API responses.
1119
1120 - `type: "service_account"`
1121
10781122 - `mcp_servers: array of BetaManagedAgentsMCPServerURLDefinition`
10791123
10801124 - `type: "url"`
from line 1895
18511895 "archived_at": null,
18521896 "created_at": "2026-03-15T10:00:00Z",
18531897 "description": "A general-purpose starter agent.",
1898 "execution_identity": {
1899 "type": "service_account"
1900 },
18541901 "mcp_servers": [
18551902 {
18561903 "name": "example-mcp",
from line 2133
20862133
20872134 - `"spend-limit-reads-2026-09-26"`
20882135
2136 - `"telemetry-destinations-2026-08-11"`
2137
20892138- `"anthropic-workspace-id": optional string`
20902139
20912140 Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
from line 2165
21162165
21172166 - `description: string or null`
21182167
2168 - `execution_identity: BetaManagedAgentsExecutionIdentity`
2169
2170 Execution principal for runs of this agent. Always present; `{"type": "service_account"}` when runs carry no customer-named principal.
2171
2172 - `BetaManagedAgentsAWSRoleExecutionIdentity object`
2173
2174 An AWS IAM role principal as returned in API responses.
2175
2176 - `type: "aws_role"`
2177
2178 - `role_arn: string`
2179
2180 The IAM role's ARN.
2181
2182 - `BetaManagedAgentsServiceAccountExecutionIdentity object`
2183
2184 The Anthropic-managed service account as returned in API responses.
2185
2186 - `type: "service_account"`
2187
21192188 - `mcp_servers: array of BetaManagedAgentsMCPServerURLDefinition`
21202189
21212190 - `type: "url"`
from line 2952
28832952 "archived_at": null,
28842953 "created_at": "2026-03-15T10:00:00Z",
28852954 "description": "A general-purpose starter agent.",
2955 "execution_identity": {
2956 "type": "service_account"
2957 },
28862958 "mcp_servers": [
28872959 {
28882960 "name": "example-mcp",
from line 3179
31073179
31083180 - `"spend-limit-reads-2026-09-26"`
31093181
3182 - `"telemetry-destinations-2026-08-11"`
3183
31103184- `"anthropic-workspace-id": optional string`
31113185
31123186 Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
from line 3211
31373211
31383212 - `description: string or null`
31393213
3214 - `execution_identity: BetaManagedAgentsExecutionIdentity`
3215
3216 Execution principal for runs of this agent. Always present; `{"type": "service_account"}` when runs carry no customer-named principal.
3217
3218 - `BetaManagedAgentsAWSRoleExecutionIdentity object`
3219
3220 An AWS IAM role principal as returned in API responses.
3221
3222 - `type: "aws_role"`
3223
3224 - `role_arn: string`
3225
3226 The IAM role's ARN.
3227
3228 - `BetaManagedAgentsServiceAccountExecutionIdentity object`
3229
3230 The Anthropic-managed service account as returned in API responses.
3231
3232 - `type: "service_account"`
3233
31403234 - `mcp_servers: array of BetaManagedAgentsMCPServerURLDefinition`
31413235
31423236 - `type: "url"`
from line 3992
38983992 "archived_at": null,
38993993 "created_at": "2026-03-15T10:00:00Z",
39003994 "description": "A general-purpose starter agent.",
3995 "execution_identity": {
3996 "type": "service_account"
3997 },
39013998 "mcp_servers": [
39023999 {
39034000 "name": "example-mcp",
from line 4208
41114208
41124209 - `"spend-limit-reads-2026-09-26"`
41134210
4211 - `"telemetry-destinations-2026-08-11"`
4212
41144213- `"anthropic-workspace-id": optional string`
41154214
41164215 Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
from line 4224
41254224
41264225 maxLength: 2048
41274226
4227- `execution_identity: optional BetaManagedAgentsExecutionIdentityParams or null`
4228
4229 Execution principal for runs of this agent. Full replacement. Omit to preserve; send null or `{"type": "service_account"}` to restore the default.
4230
4231 - `BetaManagedAgentsAWSRoleExecutionIdentityParams object`
4232
4233 An AWS IAM role principal.
4234
4235 - `type: "aws_role"`
4236
4237 - `role_arn: string`
4238
4239 The IAM role's ARN, e.g. "arn:aws:iam::123456789012:role/my-agent-runner". Maximum 2048 characters.
4240
4241 maxLength: 2048
4242
4243 - `BetaManagedAgentsServiceAccountExecutionIdentityParams object`
4244
4245 The Anthropic-managed service account — the default execution principal. Carries no identifier.
4246
4247 - `type: "service_account"`
4248
41284249- `mcp_servers: optional array of BetaManagedAgentsURLMCPServerParams or null`
41294250
41304251 MCP servers. Full replacement. Omit to preserve; send empty array or `null` to clear. Names must be unique. Maximum 20. Every server must be referenced by an `mcp_toolset` in the agent's resulting `tools`; unreferenced servers are rejected. See the [MCP connector guide](https://platform.claude.com/docs/en/managed-agents/mcp-connector?sdk_languages=http).
from line 5192
50715192
50725193 - `description: string or null`
50735194
5195 - `execution_identity: BetaManagedAgentsExecutionIdentity`
5196
5197 Execution principal for runs of this agent. Always present; `{"type": "service_account"}` when runs carry no customer-named principal.
5198
5199 - `BetaManagedAgentsAWSRoleExecutionIdentity object`
5200
5201 An AWS IAM role principal as returned in API responses.
5202
5203 - `type: "aws_role"`
5204
5205 - `role_arn: string`
5206
5207 The IAM role's ARN.
5208
5209 - `BetaManagedAgentsServiceAccountExecutionIdentity object`
5210
5211 The Anthropic-managed service account as returned in API responses.
5212
5213 - `type: "service_account"`
5214
50745215 - `mcp_servers: array of BetaManagedAgentsMCPServerURLDefinition`
50755216
50765217 - `type: "url"`
from line 5979
58385979 "archived_at": null,
58395980 "created_at": "2026-03-15T10:00:00Z",
58405981 "description": "A general-purpose starter agent.",
5982 "execution_identity": {
5983 "type": "service_account"
5984 },
58415985 "mcp_servers": [
58425986 {
58435987 "name": "example-mcp",
from line 6195
60516195
60526196 - `"spend-limit-reads-2026-09-26"`
60536197
6198 - `"telemetry-destinations-2026-08-11"`
6199
60546200- `"anthropic-workspace-id": optional string`
60556201
60566202 Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
from line 6227
60816227
60826228 - `description: string or null`
60836229
6230 - `execution_identity: BetaManagedAgentsExecutionIdentity`
6231
6232 Execution principal for runs of this agent. Always present; `{"type": "service_account"}` when runs carry no customer-named principal.
6233
6234 - `BetaManagedAgentsAWSRoleExecutionIdentity object`
6235
6236 An AWS IAM role principal as returned in API responses.
6237
6238 - `type: "aws_role"`
6239
6240 - `role_arn: string`
6241
6242 The IAM role's ARN.
6243
6244 - `BetaManagedAgentsServiceAccountExecutionIdentity object`
6245
6246 The Anthropic-managed service account as returned in API responses.
6247
6248 - `type: "service_account"`
6249
60846250 - `mcp_servers: array of BetaManagedAgentsMCPServerURLDefinition`
60856251
60866252 - `type: "url"`
from line 7009
68437009 "archived_at": null,
68447010 "created_at": "2026-03-15T10:00:00Z",
68457011 "description": "A general-purpose starter agent.",
7012 "execution_identity": {
7013 "type": "service_account"
7014 },
68467015 "mcp_servers": [
68477016 {
68487017 "name": "example-mcp",
from line 7141
69727141
69737142 - `description: string or null`
69747143
7144 - `execution_identity: BetaManagedAgentsExecutionIdentity`
7145
7146 Execution principal for runs of this agent. Always present; `{"type": "service_account"}` when runs carry no customer-named principal.
7147
7148 - `BetaManagedAgentsAWSRoleExecutionIdentity object`
7149
7150 An AWS IAM role principal as returned in API responses.
7151
7152 - `type: "aws_role"`
7153
7154 - `role_arn: string`
7155
7156 The IAM role's ARN.
7157
7158 - `BetaManagedAgentsServiceAccountExecutionIdentity object`
7159
7160 The Anthropic-managed service account as returned in API responses.
7161
7162 - `type: "service_account"`
7163
69757164 - `mcp_servers: array of BetaManagedAgentsMCPServerURLDefinition`
69767165
69777166 - `type: "url"`
from line 8221
80328221
80338222 - `BetaManagedAgentsAutoPolicy object`
80348223
8035 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.
8036
8037 - `allowed_domains: optional array of string`
8038
8039 - `blocked_domains: optional array of string`
8040
8041 - `user_location: optional BetaManagedAgentsUserLocation or null`
8042
8043 Approximate user location for search result localization.
8044
8045 - `type: "approximate"`
8046
8047 Location precision. Only "approximate" is supported.
8048
8049 - `city: optional string or null`
8050
8051 City name.
8052
8053 minLength: 1, maxLength: 255
8054
8055 - `country: optional string or null`
8056
8057 Two-letter ISO 3166-1 country code, uppercase.
8058
8059 - `region: optional string or null`
8060
8061 Region or state name.
8062
8063 minLength: 1, maxLength: 255
8064
8065 - `timezone: optional string or null`
8066
8067 IANA timezone identifier, e.g. "America/Los_Angeles".
8068
8069 minLength: 1, maxLength: 255
8070
8071### Beta Managed Agents Agent Tool Config Params
8072
8073- `BetaManagedAgentsAgentToolConfigParams = BetaManagedAgentsBashToolConfigParams or BetaManagedAgentsEditToolConfigParams or BetaManagedAgentsReadToolConfigParams or 5 more`
8074
8075 Configuration override for a specific tool within a toolset.
8076
8077 - `BetaManagedAgentsBashToolConfigParams object`
8078
8079 Configuration override for the bash tool.
8080
8081 - `type: optional "bash"`
8082
8083 - `name: "bash"`
8084
8085 Must be "bash".
8086
8087 - `enabled: optional boolean or null`
8088
8089 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
8090
8091 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy or null`
8092
8093 Permission policy for this tool. Controls whether tool calls are auto-approved or require confirmation.
8094
8095 - `BetaManagedAgentsAlwaysAllowPolicy object`
8096
8097 Tool calls are automatically approved without user confirmation.
8098
8099 - `type: "always_allow"`
8100
8101 - `BetaManagedAgentsAlwaysAskPolicy object`
8102
8103 Tool calls require user confirmation before execution.
8104
8105 - `type: "always_ask"`
8106
8107 - `BetaManagedAgentsAutoPolicy object`
8108
8109 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.
8110
8111 - `type: "auto"`
8112
8113 - `BetaManagedAgentsEditToolConfigParams object`
8114
8115 Configuration override for the edit tool.
8116
8117 - `type: optional "edit"`
8118
8119 - `name: "edit"`
8120
8121 Must be "edit".
8122
8123 - `enabled: optional boolean or null`
8124
8125 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
8126
8127 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy or null`
8128
8129 Permission policy for this tool. Controls whether tool calls are auto-approved or require confirmation.
8130
8131 - `BetaManagedAgentsAlwaysAllowPolicy object`
8132
8133 Tool calls are automatically approved without user confirmation.
8134
8135 - `BetaManagedAgentsAlwaysAskPolicy object`
8136
8137 Tool calls require user confirmation before execution.
8138
8139 - `BetaManagedAgentsAutoPolicy object`
8140
8141 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.
8142
8143 - `BetaManagedAgentsReadToolConfigParams object`
8144
8145 Configuration override for the read tool.
8146
8147 - `type: optional "read"`
8148
8149 - `name: "read"`
8150
8151 Must be "read".
8152
8153 - `enabled: optional boolean or null`
8154
8155 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
8156
8157 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy or null`
8158
8159 Permission policy for this tool. Controls whether tool calls are auto-approved or require confirmation.
8160
8161 - `BetaManagedAgentsAlwaysAllowPolicy object`
8162
8163 Tool calls are automatically approved without user confirmation.
8164
8165 - `BetaManagedAgentsAlwaysAskPolicy object`
8166
8167 Tool calls require user confirmation before execution.
8168
8169 - `BetaManagedAgentsAutoPolicy object`
8170
8171 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.
8172
8173 - `BetaManagedAgentsWriteToolConfigParams object`
8174
8175 Configuration override for the write tool.
8176
8177 - `type: optional "write"`
8178
8179 - `name: "write"`
8180
8181 Must be "write".
8182
8183 - `enabled: optional boolean or null`
8184
8185 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
8186
8187 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy or null`
8188
8189 Permission policy for this tool. Controls whether tool calls are auto-approved or require confirmation.
8190
8191 - `BetaManagedAgentsAlwaysAllowPolicy object`
8192
8193 Tool calls are automatically approved without user con
8224 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
api/beta/agents/archive Changed · +25 / -0 lines
from line 125
125125
126126 - `"spend-limit-reads-2026-09-26"`
127127
128 - `"telemetry-destinations-2026-08-11"`
129
128130- `"anthropic-workspace-id": optional string`
129131
130132 Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
from line 157
155157
156158 - `description: string or null`
157159
160 - `execution_identity: BetaManagedAgentsExecutionIdentity`
161
162 Execution principal for runs of this agent. Always present; `{"type": "service_account"}` when runs carry no customer-named principal.
163
164 - `BetaManagedAgentsAWSRoleExecutionIdentity object`
165
166 An AWS IAM role principal as returned in API responses.
167
168 - `type: "aws_role"`
169
170 - `role_arn: string`
171
172 The IAM role's ARN.
173
174 - `BetaManagedAgentsServiceAccountExecutionIdentity object`
175
176 The Anthropic-managed service account as returned in API responses.
177
178 - `type: "service_account"`
179
158180 - `mcp_servers: array of BetaManagedAgentsMCPServerURLDefinition`
159181
160182 - `type: "url"`
from line 939
917939 "archived_at": null,
918940 "created_at": "2026-03-15T10:00:00Z",
919941 "description": "A general-purpose starter agent.",
942 "execution_identity": {
943 "type": "service_account"
944 },
920945 "mcp_servers": [
921946 {
922947 "name": "example-mcp",
api/beta/agents/create Changed · +47 / -0 lines
from line 119
119119
120120 - `"spend-limit-reads-2026-09-26"`
121121
122 - `"telemetry-destinations-2026-08-11"`
123
122124- `"anthropic-workspace-id": optional string`
123125
124126 Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
from line 297
295297
296298 maxLength: 2048
297299
300- `execution_identity: optional BetaManagedAgentsExecutionIdentityParams or null`
301
302 Execution principal for runs of this agent. Omitting it, sending null, or sending `{"type": "service_account"}` stores the default.
303
304 - `BetaManagedAgentsAWSRoleExecutionIdentityParams object`
305
306 An AWS IAM role principal.
307
308 - `type: "aws_role"`
309
310 - `role_arn: string`
311
312 The IAM role's ARN, e.g. "arn:aws:iam::123456789012:role/my-agent-runner". Maximum 2048 characters.
313
314 maxLength: 2048
315
316 - `BetaManagedAgentsServiceAccountExecutionIdentityParams object`
317
318 The Anthropic-managed service account — the default execution principal. Carries no identifier.
319
320 - `type: "service_account"`
321
298322- `mcp_servers: optional array of BetaManagedAgentsURLMCPServerParams`
299323
300324 MCP servers this agent connects to. Maximum 20. Names must be unique within the array. Every server must be referenced by an `mcp_toolset` in `tools`; unreferenced servers are rejected. See the [MCP connector guide](https://platform.claude.com/docs/en/managed-agents/mcp-connector?sdk_languages=http).
from line 1097
10731097
10741098 - `description: string or null`
10751099
1100 - `execution_identity: BetaManagedAgentsExecutionIdentity`
1101
1102 Execution principal for runs of this agent. Always present; `{"type": "service_account"}` when runs carry no customer-named principal.
1103
1104 - `BetaManagedAgentsAWSRoleExecutionIdentity object`
1105
1106 An AWS IAM role principal as returned in API responses.
1107
1108 - `type: "aws_role"`
1109
1110 - `role_arn: string`
1111
1112 The IAM role's ARN.
1113
1114 - `BetaManagedAgentsServiceAccountExecutionIdentity object`
1115
1116 The Anthropic-managed service account as returned in API responses.
1117
1118 - `type: "service_account"`
1119
10761120 - `mcp_servers: array of BetaManagedAgentsMCPServerURLDefinition`
10771121
10781122 - `type: "url"`
from line 1893
18491893 "archived_at": null,
18501894 "created_at": "2026-03-15T10:00:00Z",
18511895 "description": "A general-purpose starter agent.",
1896 "execution_identity": {
1897 "type": "service_account"
1898 },
18521899 "mcp_servers": [
18531900 {
18541901 "name": "example-mcp",
api/beta/agents/list Changed · +25 / -0 lines
from line 147
147147
148148 - `"spend-limit-reads-2026-09-26"`
149149
150 - `"telemetry-destinations-2026-08-11"`
151
150152- `"anthropic-workspace-id": optional string`
151153
152154 Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
from line 179
177179
178180 - `description: string or null`
179181
182 - `execution_identity: BetaManagedAgentsExecutionIdentity`
183
184 Execution principal for runs of this agent. Always present; `{"type": "service_account"}` when runs carry no customer-named principal.
185
186 - `BetaManagedAgentsAWSRoleExecutionIdentity object`
187
188 An AWS IAM role principal as returned in API responses.
189
190 - `type: "aws_role"`
191
192 - `role_arn: string`
193
194 The IAM role's ARN.
195
196 - `BetaManagedAgentsServiceAccountExecutionIdentity object`
197
198 The Anthropic-managed service account as returned in API responses.
199
200 - `type: "service_account"`
201
180202 - `mcp_servers: array of BetaManagedAgentsMCPServerURLDefinition`
181203
182204 - `type: "url"`
from line 966
944966 "archived_at": null,
945967 "created_at": "2026-03-15T10:00:00Z",
946968 "description": "A general-purpose starter agent.",
969 "execution_identity": {
970 "type": "service_account"
971 },
947972 "mcp_servers": [
948973 {
949974 "name": "example-mcp",
api/beta/agents/retrieve Changed · +25 / -0 lines
from line 133
133133
134134 - `"spend-limit-reads-2026-09-26"`
135135
136 - `"telemetry-destinations-2026-08-11"`
137
136138- `"anthropic-workspace-id": optional string`
137139
138140 Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
from line 165
163165
164166 - `description: string or null`
165167
168 - `execution_identity: BetaManagedAgentsExecutionIdentity`
169
170 Execution principal for runs of this agent. Always present; `{"type": "service_account"}` when runs carry no customer-named principal.
171
172 - `BetaManagedAgentsAWSRoleExecutionIdentity object`
173
174 An AWS IAM role principal as returned in API responses.
175
176 - `type: "aws_role"`
177
178 - `role_arn: string`
179
180 The IAM role's ARN.
181
182 - `BetaManagedAgentsServiceAccountExecutionIdentity object`
183
184 The Anthropic-managed service account as returned in API responses.
185
186 - `type: "service_account"`
187
166188 - `mcp_servers: array of BetaManagedAgentsMCPServerURLDefinition`
167189
168190 - `type: "url"`
from line 946
924946 "archived_at": null,
925947 "created_at": "2026-03-15T10:00:00Z",
926948 "description": "A general-purpose starter agent.",
949 "execution_identity": {
950 "type": "service_account"
951 },
927952 "mcp_servers": [
928953 {
929954 "name": "example-mcp",
api/beta/agents/update Changed · +47 / -0 lines
from line 125
125125
126126 - `"spend-limit-reads-2026-09-26"`
127127
128 - `"telemetry-destinations-2026-08-11"`
129
128130- `"anthropic-workspace-id": optional string`
129131
130132 Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
from line 141
139141
140142 maxLength: 2048
141143
144- `execution_identity: optional BetaManagedAgentsExecutionIdentityParams or null`
145
146 Execution principal for runs of this agent. Full replacement. Omit to preserve; send null or `{"type": "service_account"}` to restore the default.
147
148 - `BetaManagedAgentsAWSRoleExecutionIdentityParams object`
149
150 An AWS IAM role principal.
151
152 - `type: "aws_role"`
153
154 - `role_arn: string`
155
156 The IAM role's ARN, e.g. "arn:aws:iam::123456789012:role/my-agent-runner". Maximum 2048 characters.
157
158 maxLength: 2048
159
160 - `BetaManagedAgentsServiceAccountExecutionIdentityParams object`
161
162 The Anthropic-managed service account — the default execution principal. Carries no identifier.
163
164 - `type: "service_account"`
165
142166- `mcp_servers: optional array of BetaManagedAgentsURLMCPServerParams or null`
143167
144168 MCP servers. Full replacement. Omit to preserve; send empty array or `null` to clear. Names must be unique. Maximum 20. Every server must be referenced by an `mcp_toolset` in the agent's resulting `tools`; unreferenced servers are rejected. See the [MCP connector guide](https://platform.claude.com/docs/en/managed-agents/mcp-connector?sdk_languages=http).
from line 1109
10851109
10861110 - `description: string or null`
10871111
1112 - `execution_identity: BetaManagedAgentsExecutionIdentity`
1113
1114 Execution principal for runs of this agent. Always present; `{"type": "service_account"}` when runs carry no customer-named principal.
1115
1116 - `BetaManagedAgentsAWSRoleExecutionIdentity object`
1117
1118 An AWS IAM role principal as returned in API responses.
1119
1120 - `type: "aws_role"`
1121
1122 - `role_arn: string`
1123
1124 The IAM role's ARN.
1125
1126 - `BetaManagedAgentsServiceAccountExecutionIdentity object`
1127
1128 The Anthropic-managed service account as returned in API responses.
1129
1130 - `type: "service_account"`
1131
10881132 - `mcp_servers: array of BetaManagedAgentsMCPServerURLDefinition`
10891133
10901134 - `type: "url"`
from line 1896
18521896 "archived_at": null,
18531897 "created_at": "2026-03-15T10:00:00Z",
18541898 "description": "A general-purpose starter agent.",
1899 "execution_identity": {
1900 "type": "service_account"
1901 },
18551902 "mcp_servers": [
18561903 {
18571904 "name": "example-mcp",
api/beta/agents/versions Changed · +25 / -0 lines
from line 139
139139
140140 - `"spend-limit-reads-2026-09-26"`
141141
142 - `"telemetry-destinations-2026-08-11"`
143
142144- `"anthropic-workspace-id": optional string`
143145
144146 Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
from line 171
169171
170172 - `description: string or null`
171173
174 - `execution_identity: BetaManagedAgentsExecutionIdentity`
175
176 Execution principal for runs of this agent. Always present; `{"type": "service_account"}` when runs carry no customer-named principal.
177
178 - `BetaManagedAgentsAWSRoleExecutionIdentity object`
179
180 An AWS IAM role principal as returned in API responses.
181
182 - `type: "aws_role"`
183
184 - `role_arn: string`
185
186 The IAM role's ARN.
187
188 - `BetaManagedAgentsServiceAccountExecutionIdentity object`
189
190 The Anthropic-managed service account as returned in API responses.
191
192 - `type: "service_account"`
193
172194 - `mcp_servers: array of BetaManagedAgentsMCPServerURLDefinition`
173195
174196 - `type: "url"`
from line 958
936958 "archived_at": null,
937959 "created_at": "2026-03-15T10:00:00Z",
938960 "description": "A general-purpose starter agent.",
961 "execution_identity": {
962 "type": "service_account"
963 },
939964 "mcp_servers": [
940965 {
941966 "name": "example-mcp",
api/beta/agents/versions/list Changed · +25 / -0 lines
from line 137
137137
138138 - `"spend-limit-reads-2026-09-26"`
139139
140 - `"telemetry-destinations-2026-08-11"`
141
140142- `"anthropic-workspace-id": optional string`
141143
142144 Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
from line 169
167169
168170 - `description: string or null`
169171
172 - `execution_identity: BetaManagedAgentsExecutionIdentity`
173
174 Execution principal for runs of this agent. Always present; `{"type": "service_account"}` when runs carry no customer-named principal.
175
176 - `BetaManagedAgentsAWSRoleExecutionIdentity object`
177
178 An AWS IAM role principal as returned in API responses.
179
180 - `type: "aws_role"`
181
182 - `role_arn: string`
183
184 The IAM role's ARN.
185
186 - `BetaManagedAgentsServiceAccountExecutionIdentity object`
187
188 The Anthropic-managed service account as returned in API responses.
189
190 - `type: "service_account"`
191
170192 - `mcp_servers: array of BetaManagedAgentsMCPServerURLDefinition`
171193
172194 - `type: "url"`
from line 956
934956 "archived_at": null,
935957 "created_at": "2026-03-15T10:00:00Z",
936958 "description": "A general-purpose starter agent.",
959 "execution_identity": {
960 "type": "service_account"
961 },
937962 "mcp_servers": [
938963 {
939964 "name": "example-mcp",
api/beta/deployments Changed · +16 / -0 lines
from line 121
121121
122122 - `"spend-limit-reads-2026-09-26"`
123123
124 - `"telemetry-destinations-2026-08-11"`
125
124126- `"anthropic-workspace-id": optional string`
125127
126128 Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
from line 1309
13071309
13081310 - `"spend-limit-reads-2026-09-26"`
13091311
1312 - `"telemetry-destinations-2026-08-11"`
1313
13101314- `"anthropic-workspace-id": optional string`
13111315
13121316 Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
from line 2044
20402044
20412045 - `"spend-limit-reads-2026-09-26"`
20422046
2047 - `"telemetry-destinations-2026-08-11"`
2048
20432049- `"anthropic-workspace-id": optional string`
20442050
20452051 Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
from line 2770
27642770
27652771 - `"spend-limit-reads-2026-09-26"`
27662772
2773 - `"telemetry-destinations-2026-08-11"`
2774
27672775- `"anthropic-workspace-id": optional string`
27682776
27692777 Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
from line 3906
38983906
38993907 - `"spend-limit-reads-2026-09-26"`
39003908
3909 - `"telemetry-destinations-2026-08-11"`
3910
39013911- `"anthropic-workspace-id": optional string`
39023912
39033913 Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
from line 4633
46234633
46244634 - `"spend-limit-reads-2026-09-26"`
46254635
4636 - `"telemetry-destinations-2026-08-11"`
4637
46264638- `"anthropic-workspace-id": optional string`
46274639
46284640 Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
from line 5022
50105022
50115023 - `"spend-limit-reads-2026-09-26"`
50125024
5025 - `"telemetry-destinations-2026-08-11"`
5026
50135027- `"anthropic-workspace-id": optional string`
50145028
50155029 Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
from line 5748
57345748 - `"ce-plugins-2026-09-01"`
57355749
57365750 - `"spend-limit-reads-2026-09-26"`
5751
5752 - `"telemetry-destinations-2026-08-11"`
57375753
57385754- `"anthropic-workspace-id": optional string`
57395755
api/beta/dreams Changed · +10 / -0 lines
from line 125
125125
126126 - `"spend-limit-reads-2026-09-26"`
127127
128 - `"telemetry-destinations-2026-08-11"`
129
128130- `"anthropic-workspace-id": optional string`
129131
130132 Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
from line 708
706708
707709 - `"spend-limit-reads-2026-09-26"`
708710
711 - `"telemetry-destinations-2026-08-11"`
712
709713- `"anthropic-workspace-id": optional string`
710714
711715 Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
from line 1124
11201124
11211125 - `"spend-limit-reads-2026-09-26"`
11221126
1127 - `"telemetry-destinations-2026-08-11"`
1128
11231129- `"anthropic-workspace-id": optional string`
11241130
11251131 Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
from line 1535
15291535
15301536 - `"spend-limit-reads-2026-09-26"`
15311537
1538 - `"telemetry-destinations-2026-08-11"`
1539
15321540- `"anthropic-workspace-id": optional string`
15331541
15341542 Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
from line 1946
19381946 - `"ce-plugins-2026-09-01"`
19391947
19401948 - `"spend-limit-reads-2026-09-26"`
1949
1950 - `"telemetry-destinations-2026-08-11"`
19411951
19421952- `"anthropic-workspace-id": optional string`
19431953
api/beta/environments Changed · +28 / -0 lines
from line 125
125125
126126 - `"spend-limit-reads-2026-09-26"`
127127
128 - `"telemetry-destinations-2026-08-11"`
129
128130- `"anthropic-workspace-id": optional string`
129131
130132 Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
from line 602
600602
601603 - `"spend-limit-reads-2026-09-26"`
602604
605 - `"telemetry-destinations-2026-08-11"`
606
603607- `"anthropic-workspace-id": optional string`
604608
605609 Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
from line 935
931935
932936 - `"spend-limit-reads-2026-09-26"`
933937
938 - `"telemetry-destinations-2026-08-11"`
939
934940- `"anthropic-workspace-id": optional string`
935941
936942 Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
from line 1259
12531259
12541260 - `"spend-limit-reads-2026-09-26"`
12551261
1262 - `"telemetry-destinations-2026-08-11"`
1263
12561264- `"anthropic-workspace-id": optional string`
12571265
12581266 Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
from line 1705
16971705
16981706 - `"spend-limit-reads-2026-09-26"`
16991707
1708 - `"telemetry-destinations-2026-08-11"`
1709
17001710- `"anthropic-workspace-id": optional string`
17011711
17021712 Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
from line 1872
18621872
18631873 - `"spend-limit-reads-2026-09-26"`
18641874
1875 - `"telemetry-destinations-2026-08-11"`
1876
18651877- `"anthropic-workspace-id": optional string`
18661878
18671879 Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
from line 2666
26542666
26552667 - `"spend-limit-reads-2026-09-26"`
26562668
2669 - `"telemetry-destinations-2026-08-11"`
2670
26572671- `"anthropic-workspace-id": optional string`
26582672
26592673 Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
from line 2930
29162930
29172931 - `"spend-limit-reads-2026-09-26"`
29182932
2933 - `"telemetry-destinations-2026-08-11"`
2934
29192935- `"Anthropic-Worker-ID": optional string`
29202936
29212937 Unique identifier for the specific worker polling, used to track aggregated environment-level work metrics in Console
from line 3180
31643180
31653181 - `"spend-limit-reads-2026-09-26"`
31663182
3183 - `"telemetry-destinations-2026-08-11"`
3184
31673185#### Returns
31683186
31693187- `BetaSelfHostedWork object`
from line 3437
34193437
34203438 - `"spend-limit-reads-2026-09-26"`
34213439
3440 - `"telemetry-destinations-2026-08-11"`
3441
34223442#### Returns
34233443
34243444- `BetaSelfHostedWorkHeartbeatResponse object`
from line 3627
36073627
36083628 - `"spend-limit-reads-2026-09-26"`
36093629
3630 - `"telemetry-destinations-2026-08-11"`
3631
36103632- `"anthropic-workspace-id": optional string`
36113633
36123634 Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
from line 3899
38773899
38783900 - `"spend-limit-reads-2026-09-26"`
38793901
3902 - `"telemetry-destinations-2026-08-11"`
3903
38803904#### Returns
38813905
38823906- `BetaSelfHostedWorkListResponse object`
from line 4154
41304154
41314155 - `"spend-limit-reads-2026-09-26"`
41324156
4157 - `"telemetry-destinations-2026-08-11"`
4158
41334159- `"anthropic-workspace-id": optional string`
41344160
41354161 Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
from line 4413
43874413 - `"ce-plugins-2026-09-01"`
43884414
43894415 - `"spend-limit-reads-2026-09-26"`
4416
4417 - `"telemetry-destinations-2026-08-11"`
43904418
43914419- `"anthropic-workspace-id": optional string`
43924420
api/beta/environments/work Changed · +16 / -0 lines
from line 133
133133
134134 - `"spend-limit-reads-2026-09-26"`
135135
136 - `"telemetry-destinations-2026-08-11"`
137
136138- `"anthropic-workspace-id": optional string`
137139
138140 Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
from line 397
395397
396398 - `"spend-limit-reads-2026-09-26"`
397399
400 - `"telemetry-destinations-2026-08-11"`
401
398402- `"Anthropic-Worker-ID": optional string`
399403
400404 Unique identifier for the specific worker polling, used to track aggregated environment-level work metrics in Console
from line 647
643647
644648 - `"spend-limit-reads-2026-09-26"`
645649
650 - `"telemetry-destinations-2026-08-11"`
651
646652### Returns
647653
648654- `BetaSelfHostedWork object`
from line 904
898904
899905 - `"spend-limit-reads-2026-09-26"`
900906
907 - `"telemetry-destinations-2026-08-11"`
908
901909### Returns
902910
903911- `BetaSelfHostedWorkHeartbeatResponse object`
from line 1094
10861094
10871095 - `"spend-limit-reads-2026-09-26"`
10881096
1097 - `"telemetry-destinations-2026-08-11"`
1098
10891099- `"anthropic-workspace-id": optional string`
10901100
10911101 Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
from line 1366
13561366
13571367 - `"spend-limit-reads-2026-09-26"`
13581368
1369 - `"telemetry-destinations-2026-08-11"`
1370
13591371### Returns
13601372
13611373- `BetaSelfHostedWorkListResponse object`
from line 1621
16091621
16101622 - `"spend-limit-reads-2026-09-26"`
16111623
1624 - `"telemetry-destinations-2026-08-11"`
1625
16121626- `"anthropic-workspace-id": optional string`
16131627
16141628 Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
from line 1880
18661880 - `"ce-plugins-2026-09-01"`
18671881
18681882 - `"spend-limit-reads-2026-09-26"`
1883
1884 - `"telemetry-destinations-2026-08-11"`
18691885
18701886- `"anthropic-workspace-id": optional string`
18711887
api/beta/files Changed · +10 / -0 lines
from line 125
125125
126126 - `"spend-limit-reads-2026-09-26"`
127127
128 - `"telemetry-destinations-2026-08-11"`
129
128130- `"anthropic-workspace-id": optional string`
129131
130132 Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
from line 382
380382
381383 - `"spend-limit-reads-2026-09-26"`
382384
385 - `"telemetry-destinations-2026-08-11"`
386
383387- `"anthropic-workspace-id": optional string`
384388
385389 Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
from line 618
614618
615619 - `"spend-limit-reads-2026-09-26"`
616620
621 - `"telemetry-destinations-2026-08-11"`
622
617623- `"anthropic-workspace-id": optional string`
618624
619625 Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
from line 760
754760
755761 - `"spend-limit-reads-2026-09-26"`
756762
763 - `"telemetry-destinations-2026-08-11"`
764
757765- `"anthropic-workspace-id": optional string`
758766
759767 Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
from line 984
976984 - `"ce-plugins-2026-09-01"`
977985
978986 - `"spend-limit-reads-2026-09-26"`
987
988 - `"telemetry-destinations-2026-08-11"`
979989
980990- `"anthropic-workspace-id": optional string`
981991
api/beta/memory_stores Changed · +28 / -0 lines
from line 121
121121
122122 - `"spend-limit-reads-2026-09-26"`
123123
124 - `"telemetry-destinations-2026-08-11"`
125
124126- `"anthropic-workspace-id": optional string`
125127
126128 Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
from line 363
361363
362364 - `"spend-limit-reads-2026-09-26"`
363365
366 - `"telemetry-destinations-2026-08-11"`
367
364368- `"anthropic-workspace-id": optional string`
365369
366370 Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
from line 568
564568
565569 - `"spend-limit-reads-2026-09-26"`
566570
571 - `"telemetry-destinations-2026-08-11"`
572
567573- `"anthropic-workspace-id": optional string`
568574
569575 Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
from line 766
760766
761767 - `"spend-limit-reads-2026-09-26"`
762768
769 - `"telemetry-destinations-2026-08-11"`
770
763771- `"anthropic-workspace-id": optional string`
764772
765773 Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
from line 984
976984
977985 - `"spend-limit-reads-2026-09-26"`
978986
987 - `"telemetry-destinations-2026-08-11"`
988
979989- `"anthropic-workspace-id": optional string`
980990
981991 Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
from line 1145
11351145
11361146 - `"spend-limit-reads-2026-09-26"`
11371147
1148 - `"telemetry-destinations-2026-08-11"`
1149
11381150- `"anthropic-workspace-id": optional string`
11391151
11401152 Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
from line 1416
14041416
14051417 - `"spend-limit-reads-2026-09-26"`
14061418
1419 - `"telemetry-destinations-2026-08-11"`
1420
14071421- `"anthropic-workspace-id": optional string`
14081422
14091423 Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
from line 1673
16591673
16601674 - `"spend-limit-reads-2026-09-26"`
16611675
1676 - `"telemetry-destinations-2026-08-11"`
1677
16621678- `"anthropic-workspace-id": optional string`
16631679
16641680 Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
from line 1920
19041920
19051921 - `"spend-limit-reads-2026-09-26"`
19061922
1923 - `"telemetry-destinations-2026-08-11"`
1924
19071925- `"anthropic-workspace-id": optional string`
19081926
19091927 Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
from line 2144
21262144
21272145 - `"spend-limit-reads-2026-09-26"`
21282146
2147 - `"telemetry-destinations-2026-08-11"`
2148
21292149- `"anthropic-workspace-id": optional string`
21302150
21312151 Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
from line 2386
23662386
23672387 - `"spend-limit-reads-2026-09-26"`
23682388
2389 - `"telemetry-destinations-2026-08-11"`
2390
23692391- `"anthropic-workspace-id": optional string`
23702392
23712393 Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
from line 2619
25972619
25982620 - `"spend-limit-reads-2026-09-26"`
25992621
2622 - `"telemetry-destinations-2026-08-11"`
2623
26002624- `"anthropic-workspace-id": optional string`
26012625
26022626 Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
from line 2933
29092933
29102934 - `"spend-limit-reads-2026-09-26"`
29112935
2936 - `"telemetry-destinations-2026-08-11"`
2937
29122938- `"anthropic-workspace-id": optional string`
29132939
29142940 Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
from line 3223
31973223 - `"ce-plugins-2026-09-01"`
31983224
31993225 - `"spend-limit-reads-2026-09-26"`
3226
3227 - `"telemetry-destinations-2026-08-11"`
32003228
32013229- `"anthropic-workspace-id": optional string`
32023230
api/beta/memory_stores/memories Changed · +10 / -0 lines
from line 141
141141
142142 - `"spend-limit-reads-2026-09-26"`
143143
144 - `"telemetry-destinations-2026-08-11"`
145
144146- `"anthropic-workspace-id": optional string`
145147
146148 Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
from line 398
396398
397399 - `"spend-limit-reads-2026-09-26"`
398400
401 - `"telemetry-destinations-2026-08-11"`
402
399403- `"anthropic-workspace-id": optional string`
400404
401405 Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
from line 645
641645
642646 - `"spend-limit-reads-2026-09-26"`
643647
648 - `"telemetry-destinations-2026-08-11"`
649
644650- `"anthropic-workspace-id": optional string`
645651
646652 Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
from line 869
863869
864870 - `"spend-limit-reads-2026-09-26"`
865871
872 - `"telemetry-destinations-2026-08-11"`
873
866874- `"anthropic-workspace-id": optional string`
867875
868876 Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
from line 1110
11021110 - `"ce-plugins-2026-09-01"`
11031111
11041112 - `"spend-limit-reads-2026-09-26"`
1113
1114 - `"telemetry-destinations-2026-08-11"`
11051115
11061116- `"anthropic-workspace-id": optional string`
11071117
api/beta/memory_stores/memory_versions Changed · +6 / -0 lines
from line 197
197197
198198 - `"spend-limit-reads-2026-09-26"`
199199
200 - `"telemetry-destinations-2026-08-11"`
201
200202- `"anthropic-workspace-id": optional string`
201203
202204 Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
from line 511
509511
510512 - `"spend-limit-reads-2026-09-26"`
511513
514 - `"telemetry-destinations-2026-08-11"`
515
512516- `"anthropic-workspace-id": optional string`
513517
514518 Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
from line 801
797801 - `"ce-plugins-2026-09-01"`
798802
799803 - `"spend-limit-reads-2026-09-26"`
804
805 - `"telemetry-destinations-2026-08-11"`
800806
801807- `"anthropic-workspace-id": optional string`
802808
api/beta/messages Changed · +16 / -0 lines
This page is larger than the 256 KiB this site keeps, so one side of the diff below stops where the stored text does.
from line 129
129129
130130 - `"spend-limit-reads-2026-09-26"`
131131
132 - `"telemetry-destinations-2026-08-11"`
133
132134- `"anthropic-user-profile-id": optional string`
133135
134136 The user profile ID to attribute this request to. Use when acting on behalf of a party other than your organization. Requires the `user-profiles` beta header.
from line 7162
71607162
71617163 - `"direct"`
71627164
7163 - `"code_execution_20250825"`
7164
7165 - `"code_exe
7165 - `"code_execution_2
api/beta/messages/batches Changed · +12 / -0 lines
This page is larger than the 256 KiB this site keeps, so one side of the diff below stops where the stored text does.
from line 129
129129
130130 - `"spend-limit-reads-2026-09-26"`
131131
132 - `"telemetry-destinations-2026-08-11"`
133
132134- `"anthropic-user-profile-id": optional string`
133135
134136 The user profile ID to attribute the requests in this batch to. Use when acting on behalf of a party other than your organization. Requires the `user-profiles` beta header. Applies to every request in the batch; an individual request whose `user_profile_id` body field conflicts with this header is errored.
from line 4555
45534555
45544556 - `"spend-limit-reads-2026-09-26"`
45554557
4558 - `"telemetry-destinations-2026-08-11"`
4559
45564560- `"anthropic-workspace-id": optional string`
45574561
45584562 Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
from line 4845
48414845
48424846 - `"spend-limit-reads-2026-09-26"`
48434847
4848 - `"telemetry-destinations-2026-08-11"`
4849
48444850- `"anthropic-workspace-id": optional string`
48454851
48464852 Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
from line 5144
51385144
51395145 - `"spend-limit-reads-2026-09-26"`
51405146
5147 - `"telemetry-destinations-2026-08-11"`
5148
51415149- `"anthropic-workspace-id": optional string`
51425150
51435151 Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
from line 5425
54175425
54185426 - `"spend-limit-reads-2026-09-26"`
54195427
5428 - `"telemetry-destinations-2026-08-11"`
5429
54205430- `"anthropic-workspace-id": optional string`
54215431
54225432 Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
from line 5598
55885598
55895599 - `"spend-limit-reads-2026-09-26"`
55905600
5601 - `"telemetry-destinations-2026-08-11"`
5602
55915603- `"anthropic-workspace-id": optional string`
55925604
55935605 Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
from line 7326
73147326
73157327 This is how the tool will be called by the model and in `tool_use` blocks.
73167328
7317 - `allowed_callers: optional array of "direct" or "code_execution_20250825" or "code_execution_20260120" or "code_execution_20260521"`
7318
7319 - `"direct"`
7320
7321 - `"code_execution_20250825"`
7322
7323 - `"code_execution_20260120"`
7324
7325 - `"code_execut
7329 - `allowed_callers: optional array of "direct" or "code_execution_2025082
api/beta/organization Changed · +2622 / -2 lines
## Organization › Telemetry Destinations ### Create a Telemetry Destination ### List Telemetry Destinations ### Retrieve a Telemetry Destination ### Update a Telemetry Destination ### Delete a Telemetry Destination ### Test a Telemetry Destination ## Organization › Telemetry Destinations › Workspaces ### List Telemetry Destination Workspaces ### Add a Telemetry Destination Workspace ### Remove a Telemetry Destination Workspace
This page is larger than the 256 KiB this site keeps, so one side of the diff below stops where the stored text does.
from line 1730
17301730
17311731 - `"spend-limit-reads-2026-09-26"`
17321732
1733 - `"telemetry-destinations-2026-08-11"`
1734
17331735#### Body parameters
17341736
17351737- `issuer_url: string`
from line 2130
21282130
21292131 - `"spend-limit-reads-2026-09-26"`
21302132
2133 - `"telemetry-destinations-2026-08-11"`
2134
21312135#### Returns
21322136
21332137- `data: array of BetaFederationIssuer`
from line 2441
24372441
24382442 - `"spend-limit-reads-2026-09-26"`
24392443
2444 - `"telemetry-destinations-2026-08-11"`
2445
24402446#### Returns
24412447
24422448- `BetaFederationIssuer object`
from line 2755
27492755
27502756 - `"spend-limit-reads-2026-09-26"`
27512757
2758 - `"telemetry-destinations-2026-08-11"`
2759
27522760#### Body parameters
27532761
27542762- `check_jti: optional boolean or null`
from line 3147
31393147
31403148 - `"spend-limit-reads-2026-09-26"`
31413149
3150 - `"telemetry-destinations-2026-08-11"`
3151
31423152#### Returns
31433153
31443154- `BetaFederationIssuer object`
from line 3465
34553465
34563466 - `"spend-limit-reads-2026-09-26"`
34573467
3468 - `"telemetry-destinations-2026-08-11"`
3469
34583470#### Body parameters
34593471
34603472- `issuer_id: string`
from line 3890
38783890
38793891 - `"spend-limit-reads-2026-09-26"`
38803892
3893 - `"telemetry-destinations-2026-08-11"`
3894
38813895#### Returns
38823896
38833897- `data: array of BetaFederationRule`
from line 4201
41874201
41884202 - `"spend-limit-reads-2026-09-26"`
41894203
4204 - `"telemetry-destinations-2026-08-11"`
4205
41904206#### Returns
41914207
41924208- `BetaFederationRule object`
from line 4530
45144530
45154531 - `"spend-limit-reads-2026-09-26"`
45164532
4533 - `"telemetry-destinations-2026-08-11"`
4534
45174535#### Body parameters
45184536
45194537- `applies_to_all_workspaces: optional boolean or null`
from line 4931
49134931
49144932 - `"spend-limit-reads-2026-09-26"`
49154933
4934 - `"telemetry-destinations-2026-08-11"`
4935
49164936#### Returns
49174937
49184938- `BetaFederationRule object`
from line 5256
52365256
52375257 - `"spend-limit-reads-2026-09-26"`
52385258
5259 - `"telemetry-destinations-2026-08-11"`
5260
52395261#### Body parameters
52405262
52415263- `workspace_id: string`
from line 5465
54435465
54445466 - `"spend-limit-reads-2026-09-26"`
54455467
5468 - `"telemetry-destinations-2026-08-11"`
5469
54465470#### Returns
54475471
54485472- `data: array of BetaFederationRuleWorkspace`
from line 5664
56405664
56415665 - `"spend-limit-reads-2026-09-26"`
56425666
5667 - `"telemetry-destinations-2026-08-11"`
5668
56435669#### Returns
56445670
56455671- `type: "federation_rule_workspace_deleted"`
from line 5729
57035729
57045730 Role for the invited User.
57055731
5706 The accepted values depend on the organization type. Console and API organizations accept `user`, `developer`, `billing`, and `claude_code_user`; `admin` cannot be assigned through the API. Claude Enterprise organizations accept `user` and `managed`.
5732 The accepted values depend on the organization type. Console and API organizations accept `user`, `developer`, `billing`, and `claude_code_user`; `admin` cannot be assigned through the API. Claude Enterprise organizations accept `user` and `managed`; inviting with the `managed` role requires the `write:rbac_groups` scope in addition to `write:members`.
57075733
57085734 - `"billing"`
57095735
from line 6335
63096335
63106336 - `"spend-limit-reads-2026-09-26"`
63116337
6338 - `"telemetry-destinations-2026-08-11"`
6339
63126340#### Body parameters
63136341
63146342- `name: string`
from line 6596
65686596
65696597 - `"spend-limit-reads-2026-09-26"`
65706598
6599 - `"telemetry-destinations-2026-08-11"`
6600
65716601#### Returns
65726602
65736603- `data: array of BetaServiceAccount`
from line 6819
67896819
67906820 - `"spend-limit-reads-2026-09-26"`
67916821
6822 - `"telemetry-destinations-2026-08-11"`
6823
67926824#### Returns
67936825
67946826- `BetaServiceAccount object`
from line 7043
70117043
70127044 - `"spend-limit-reads-2026-09-26"`
70137045
7046 - `"telemetry-destinations-2026-08-11"`
7047
70147048#### Body parameters
70157049
70167050- `description: optional string or null`
from line 7285
72517285
72527286 - `"spend-limit-reads-2026-09-26"`
72537287
7288 - `"telemetry-destinations-2026-08-11"`
7289
72547290#### Returns
72557291
72567292- `BetaServiceAccount object`
from line 7514
74787514
74797515 - `"spend-limit-reads-2026-09-26"`
74807516
7517 - `"telemetry-destinations-2026-08-11"`
7518
74817519#### Body parameters
74827520
74837521- `workspace_id: string`
from line 7752
77147752
77157753 - `"spend-limit-reads-2026-09-26"`
77167754
7755 - `"telemetry-destinations-2026-08-11"`
7756
77177757#### Returns
77187758
77197759- `data: array of BetaServiceAccountWorkspaceMember`
from line 7962
79227962
79237963 - `"spend-limit-reads-2026-09-26"`
79247964
7965 - `"telemetry-destinations-2026-08-11"`
7966
79257967#### Returns
79267968
79277969- `type: "service_account_workspace_member_deleted"`
from line 8254
82128254
82138255 New role for the User.
82148256
8215 The accepted values depend on the organization type. Console and API organizations accept `user`, `developer`, `billing`, and `claude_code_user`; `admin` cannot be assigned through the API. Claude Enterprise organizations accept `user` and `managed`.
8257 The accepted values depend on the organization type. Console and API organizations accept `user`, `developer`, `billing`, and `claude_code_user`; `admin` cannot be assigned through the API. Claude Enterprise organizations accept `user` and `managed`; changing a User's role to `managed` requires the `write:rbac_groups` scope in addition to `write:members`.
82168258
82178259 - `"billing"`
82188260
from line 8708
86668708
86678709 - `"spend-limit-reads-2026-09-26"`
86688710
8711 - `"telemetry-destinations-2026-08-11"`
8712
86698713#### Body parameters
86708714
86718715- `name: string`
from line 10278
1023410278
1023510279 - `"spend-limit-reads-2026-09-26"`
1023610280
10281 - `"telemetry-destinations-2026-08-11"`
10282
1023710283#### Returns
1023810284
1023910285- `data: array of BetaServiceAccountWorkspaceMember`
from line 10485
1043910485
1044010486 - `"spend-limit-reads-2026-09-26"`
1044110487
10488 - `"telemetry-destinations-2026-08-11"`
10489
1044210490#### Body parameters
1044310491
1044410492- `service_account_id: string`
from line 10495
1044710495
1044810496- `workspace_role: BetaNoBillingWorkspaceRole`
1044910497
10450 Role to assign to the service account in this workspace.
10451
10452 - `"workspace_admin"`
10453
10454 - `"workspace_developer"`
10455
10456 - `"workspace_restricted_developer"`
10457
10458 - `"workspace_user"`
10459
10460#### Returns
10461
10462- `BetaServiceAccountWorkspaceMember object`
10463
10464 - `type: "service_account_workspace_member"`
10465
10466 default: service_account_workspace_member
10467
10468 - `created_by_actor_id: string or null`
10469
10470 Tagged ID (`user_...`/`svac_...`) of the actor who created this membership.
10471
10472 - `implicit: boolean or null`
10473
10474 True when this is the implicit default-workspace membership every service account has when no explicit membership exists. Implicit memberships have role `workspace_user` and cannot be removed.
10475
10476 - `service_account_id: string`
10477
10478 Tagged service account ID (`svac_...`).
10479
10480 - `workspace_id: string`
10481
10482 Tagged workspace ID (`wrkspc_...`).
10483
10484 - `workspace_role: BetaWorkspaceRole`
10485
10486 Role of the service account in this workspace. Service accounts cannot hold the `workspace_billing` role.
10487
10488 - `"workspace_admin"`
10489
10490 - `"workspace_billing"`
10491
10492 - `"workspace_developer"`
10493
10494 - `"workspace_restricted_developer"`
10495
10496 - `"workspace_user"`
10497
10498#### Example
10499
10500```bash
10501curl https://api.anthropic.com/v1/organizations/workspaces/$WORKSPACE_ID/service_accounts \
10502 -H 'Content-Type: a
10498 Role to assign to the service accou
api/beta/organization/federation Changed · +26 / -0 lines
from line 139
139139
140140 - `"spend-limit-reads-2026-09-26"`
141141
142 - `"telemetry-destinations-2026-08-11"`
143
142144#### Body parameters
143145
144146- `issuer_url: string`
from line 539
537539
538540 - `"spend-limit-reads-2026-09-26"`
539541
542 - `"telemetry-destinations-2026-08-11"`
543
540544#### Returns
541545
542546- `data: array of BetaFederationIssuer`
from line 850
846850
847851 - `"spend-limit-reads-2026-09-26"`
848852
853 - `"telemetry-destinations-2026-08-11"`
854
849855#### Returns
850856
851857- `BetaFederationIssuer object`
from line 1164
11581164
11591165 - `"spend-limit-reads-2026-09-26"`
11601166
1167 - `"telemetry-destinations-2026-08-11"`
1168
11611169#### Body parameters
11621170
11631171- `check_jti: optional boolean or null`
from line 1556
15481556
15491557 - `"spend-limit-reads-2026-09-26"`
15501558
1559 - `"telemetry-destinations-2026-08-11"`
1560
15511561#### Returns
15521562
15531563- `BetaFederationIssuer object`
from line 1874
18641874
18651875 - `"spend-limit-reads-2026-09-26"`
18661876
1877 - `"telemetry-destinations-2026-08-11"`
1878
18671879#### Body parameters
18681880
18691881- `issuer_id: string`
from line 2299
22872299
22882300 - `"spend-limit-reads-2026-09-26"`
22892301
2302 - `"telemetry-destinations-2026-08-11"`
2303
22902304#### Returns
22912305
22922306- `data: array of BetaFederationRule`
from line 2610
25962610
25972611 - `"spend-limit-reads-2026-09-26"`
25982612
2613 - `"telemetry-destinations-2026-08-11"`
2614
25992615#### Returns
26002616
26012617- `BetaFederationRule object`
from line 2939
29232939
29242940 - `"spend-limit-reads-2026-09-26"`
29252941
2942 - `"telemetry-destinations-2026-08-11"`
2943
29262944#### Body parameters
29272945
29282946- `applies_to_all_workspaces: optional boolean or null`
from line 3340
33223340
33233341 - `"spend-limit-reads-2026-09-26"`
33243342
3343 - `"telemetry-destinations-2026-08-11"`
3344
33253345#### Returns
33263346
33273347- `BetaFederationRule object`
from line 3665
36453665
36463666 - `"spend-limit-reads-2026-09-26"`
36473667
3668 - `"telemetry-destinations-2026-08-11"`
3669
36483670#### Body parameters
36493671
36503672- `workspace_id: string`
from line 3874
38523874
38533875 - `"spend-limit-reads-2026-09-26"`
38543876
3877 - `"telemetry-destinations-2026-08-11"`
3878
38553879#### Returns
38563880
38573881- `data: array of BetaFederationRuleWorkspace`
from line 4072
40484072 - `"ce-plugins-2026-09-01"`
40494073
40504074 - `"spend-limit-reads-2026-09-26"`
4075
4076 - `"telemetry-destinations-2026-08-11"`
40514077
40524078#### Returns
40534079
api/beta/organization/federation/issuers Changed · +10 / -0 lines
from line 137
137137
138138 - `"spend-limit-reads-2026-09-26"`
139139
140 - `"telemetry-destinations-2026-08-11"`
141
140142### Body parameters
141143
142144- `issuer_url: string`
from line 537
535537
536538 - `"spend-limit-reads-2026-09-26"`
537539
540 - `"telemetry-destinations-2026-08-11"`
541
538542### Returns
539543
540544- `data: array of BetaFederationIssuer`
from line 848
844848
845849 - `"spend-limit-reads-2026-09-26"`
846850
851 - `"telemetry-destinations-2026-08-11"`
852
847853### Returns
848854
849855- `BetaFederationIssuer object`
from line 1162
11561162
11571163 - `"spend-limit-reads-2026-09-26"`
11581164
1165 - `"telemetry-destinations-2026-08-11"`
1166
11591167### Body parameters
11601168
11611169- `check_jti: optional boolean or null`
from line 1553
15451553 - `"ce-plugins-2026-09-01"`
15461554
15471555 - `"spend-limit-reads-2026-09-26"`
1556
1557 - `"telemetry-destinations-2026-08-11"`
15481558
15491559### Returns
15501560
api/beta/organization/federation/rules Changed · +16 / -0 lines
from line 141
141141
142142 - `"spend-limit-reads-2026-09-26"`
143143
144 - `"telemetry-destinations-2026-08-11"`
145
144146### Body parameters
145147
146148- `issuer_id: string`
from line 566
564566
565567 - `"spend-limit-reads-2026-09-26"`
566568
569 - `"telemetry-destinations-2026-08-11"`
570
567571### Returns
568572
569573- `data: array of BetaFederationRule`
from line 877
873877
874878 - `"spend-limit-reads-2026-09-26"`
875879
880 - `"telemetry-destinations-2026-08-11"`
881
876882### Returns
877883
878884- `BetaFederationRule object`
from line 1206
12001206
12011207 - `"spend-limit-reads-2026-09-26"`
12021208
1209 - `"telemetry-destinations-2026-08-11"`
1210
12031211### Body parameters
12041212
12051213- `applies_to_all_workspaces: optional boolean or null`
from line 1607
15991607
16001608 - `"spend-limit-reads-2026-09-26"`
16011609
1610 - `"telemetry-destinations-2026-08-11"`
1611
16021612### Returns
16031613
16041614- `BetaFederationRule object`
from line 2145
21352145
21362146 - `"spend-limit-reads-2026-09-26"`
21372147
2148 - `"telemetry-destinations-2026-08-11"`
2149
21382150#### Body parameters
21392151
21402152- `workspace_id: string`
from line 2354
23422354
23432355 - `"spend-limit-reads-2026-09-26"`
23442356
2357 - `"telemetry-destinations-2026-08-11"`
2358
23452359#### Returns
23462360
23472361- `data: array of BetaFederationRuleWorkspace`
from line 2552
25382552 - `"ce-plugins-2026-09-01"`
25392553
25402554 - `"spend-limit-reads-2026-09-26"`
2555
2556 - `"telemetry-destinations-2026-08-11"`
25412557
25422558#### Returns
25432559
api/beta/organization/federation/rules/workspaces Changed · +6 / -0 lines
from line 142
142142
143143 - `"spend-limit-reads-2026-09-26"`
144144
145 - `"telemetry-destinations-2026-08-11"`
146
145147### Body parameters
146148
147149- `workspace_id: string`
from line 351
349351
350352 - `"spend-limit-reads-2026-09-26"`
351353
354 - `"telemetry-destinations-2026-08-11"`
355
352356### Returns
353357
354358- `data: array of BetaFederationRuleWorkspace`
from line 549
545549 - `"ce-plugins-2026-09-01"`
546550
547551 - `"spend-limit-reads-2026-09-26"`
552
553 - `"telemetry-destinations-2026-08-11"`
548554
549555### Returns
550556