@anthropic-ai/sdk 0.125.0 → 0.127.0

package/src/resources/beta/models.ts

@@ -83,6 +83,23 @@ export interface BetaCapabilitySupport {
   supported: boolean;
 }
 
+/**
+ * Compaction capability details: whether the model accepts the top-level
+ * `compaction` request parameter, with one entry per supported `compaction.type`
+ * value.
+ */
+export interface BetaCompactionCapability {
+  /**
+   * Whether the summarize compaction type is supported.
+   */
+  summarize: BetaCapabilitySupport;
+
+  /**
+   * Whether this capability is supported by the model.
+   */
+  supported: boolean;
+}
+
 /**
  * Context management capability details.
  */
@@ -162,6 +179,13 @@ export interface BetaModelCapabilities {
    */
   code_execution: BetaCapabilitySupport;
 
+  /**
+   * Compaction capability details: whether the model accepts the top-level
+   * `compaction` request parameter, with one entry per supported `compaction.type`
+   * value.
+   */
+  compaction: BetaCompactionCapability | null;
+
   /**
    * Context management support and available strategies.
    */
@@ -307,6 +331,7 @@ export interface ModelListParams extends PageParams {
 export declare namespace Models {
   export {
     type BetaCapabilitySupport as BetaCapabilitySupport,
+    type BetaCompactionCapability as BetaCompactionCapability,
     type BetaContextManagementCapability as BetaContextManagementCapability,
     type BetaEffortCapability as BetaEffortCapability,
     type BetaModelCapabilities as BetaModelCapabilities,

package/src/resources/beta/organization/index.ts

@@ -50,7 +50,13 @@ export { Organization, type BetaOrganization, type BetaOrganizationRole } from '
 export {
   RateLimits,
   type BetaOrganizationRateLimit,
+  type BetaOrganizationRateLimitBatchGroup,
+  type BetaOrganizationRateLimitFilesGroup,
+  type BetaOrganizationRateLimitModelGroup,
+  type BetaOrganizationRateLimitSkillsGroup,
+  type BetaOrganizationRateLimitTokenCountGroup,
   type BetaOrganizationRateLimitValue,
+  type BetaOrganizationRateLimitWebSearchGroup,
   type RateLimitListParams,
   type BetaOrganizationRateLimitsPageCursor,
 } from './rate-limits';

package/src/resources/beta/organization/organization.ts

@@ -53,7 +53,13 @@ import {
 import * as RateLimitsAPI from './rate-limits';
 import {
   BetaOrganizationRateLimit,
+  BetaOrganizationRateLimitBatchGroup,
+  BetaOrganizationRateLimitFilesGroup,
+  BetaOrganizationRateLimitModelGroup,
+  BetaOrganizationRateLimitSkillsGroup,
+  BetaOrganizationRateLimitTokenCountGroup,
   BetaOrganizationRateLimitValue,
+  BetaOrganizationRateLimitWebSearchGroup,
   BetaOrganizationRateLimitsPageCursor,
   RateLimitListParams,
   RateLimits,
@@ -252,7 +258,13 @@ export declare namespace Organization {
   export {
     RateLimits as RateLimits,
     type BetaOrganizationRateLimit as BetaOrganizationRateLimit,
+    type BetaOrganizationRateLimitBatchGroup as BetaOrganizationRateLimitBatchGroup,
+    type BetaOrganizationRateLimitFilesGroup as BetaOrganizationRateLimitFilesGroup,
+    type BetaOrganizationRateLimitModelGroup as BetaOrganizationRateLimitModelGroup,
+    type BetaOrganizationRateLimitSkillsGroup as BetaOrganizationRateLimitSkillsGroup,
+    type BetaOrganizationRateLimitTokenCountGroup as BetaOrganizationRateLimitTokenCountGroup,
     type BetaOrganizationRateLimitValue as BetaOrganizationRateLimitValue,
+    type BetaOrganizationRateLimitWebSearchGroup as BetaOrganizationRateLimitWebSearchGroup,
     type BetaOrganizationRateLimitsPageCursor as BetaOrganizationRateLimitsPageCursor,
     type RateLimitListParams as RateLimitListParams,
   };

package/src/resources/beta/organization/rate-limits.ts

@@ -37,14 +37,26 @@ export type BetaOrganizationRateLimitsPageCursor = PageCursor<BetaOrganizationRa
 
 export interface BetaOrganizationRateLimit {
   /**
-   * Stable identifier for this rate-limit group within the organization.
+   * Identifier of this rate-limit entry. It is stable within the organization and
+   * differs between organizations; the group's own identifier is `group.id`.
    */
   id: string;
 
   /**
-   * The kind of rate-limit group this entry represents. `model_group` entries apply
-   * to a family of models (listed in `models`); other values apply to an API-surface
-   * category and have `models` set to `null`.
+   * The rate-limit group this entry's limits apply to. Its `type` equals
+   * `group_type`.
+   */
+  group:
+    | BetaOrganizationRateLimitModelGroup
+    | BetaOrganizationRateLimitBatchGroup
+    | BetaOrganizationRateLimitTokenCountGroup
+    | BetaOrganizationRateLimitFilesGroup
+    | BetaOrganizationRateLimitSkillsGroup
+    | BetaOrganizationRateLimitWebSearchGroup;
+
+  /**
+   * @deprecated Use `group.type` instead. `group_type` is still returned and always
+   * equals `group.type`.
    */
   group_type: 'batch' | 'files' | 'model_group' | 'skills' | 'token_count' | 'web_search';
 
@@ -65,6 +77,82 @@ export interface BetaOrganizationRateLimit {
   type: 'rate_limit';
 }
 
+export interface BetaOrganizationRateLimitBatchGroup {
+  /**
+   * Opaque identifier of the rate-limit group (for example,
+   * `rlg_01VPTCmyiu5ZLsWkcxYG2pY8`). It is the same in every organization and never
+   * changes, unlike the entry's own identifier, which differs per organization.
+   */
+  id: string;
+
+  /**
+   * Always `batch`: the Message Batches API.
+   */
+  type: 'batch';
+}
+
+export interface BetaOrganizationRateLimitFilesGroup {
+  /**
+   * Opaque identifier of the rate-limit group (for example,
+   * `rlg_01VPTCmyiu5ZLsWkcxYG2pY8`). It is the same in every organization and never
+   * changes, unlike the entry's own identifier, which differs per organization.
+   */
+  id: string;
+
+  /**
+   * Always `files`: the Files API.
+   */
+  type: 'files';
+}
+
+export interface BetaOrganizationRateLimitModelGroup {
+  /**
+   * Opaque identifier of the rate-limit group (for example,
+   * `rlg_01VPTCmyiu5ZLsWkcxYG2pY8`). It is the same in every organization and never
+   * changes, unlike the entry's own identifier, which differs per organization.
+   */
+  id: string;
+
+  /**
+   * Human-readable name of the model group (for example, `Claude Sonnet 4.x`). For
+   * display only; it may change.
+   */
+  display_name: string;
+
+  /**
+   * Always `model_group`: a family of models.
+   */
+  type: 'model_group';
+}
+
+export interface BetaOrganizationRateLimitSkillsGroup {
+  /**
+   * Opaque identifier of the rate-limit group (for example,
+   * `rlg_01VPTCmyiu5ZLsWkcxYG2pY8`). It is the same in every organization and never
+   * changes, unlike the entry's own identifier, which differs per organization.
+   */
+  id: string;
+
+  /**
+   * Always `skills`: the Skills API.
+   */
+  type: 'skills';
+}
+
+export interface BetaOrganizationRateLimitTokenCountGroup {
+  /**
+   * Opaque identifier of the rate-limit group (for example,
+   * `rlg_01VPTCmyiu5ZLsWkcxYG2pY8`). It is the same in every organization and never
+   * changes, unlike the entry's own identifier, which differs per organization.
+   */
+  id: string;
+
+  /**
+   * Always `token_count`: the Token Count API.
+   */
+  type: 'token_count';
+}
+
 export interface BetaOrganizationRateLimitValue {
   /**
    * The limiter type (for example, `requests_per_minute` or
@@ -78,6 +166,20 @@ export interface BetaOrganizationRateLimitValue {
   value: number;
 }
 
+export interface BetaOrganizationRateLimitWebSearchGroup {
+  /**
+   * Opaque identifier of the rate-limit group (for example,
+   * `rlg_01VPTCmyiu5ZLsWkcxYG2pY8`). It is the same in every organization and never
+   * changes, unlike the entry's own identifier, which differs per organization.
+   */
+  id: string;
+
+  /**
+   * Always `web_search`: the Messages API web search tool.
+   */
+  type: 'web_search';
+}
+
 export interface RateLimitListParams extends PageCursorParams {
   /**
    * Filter by group type.
@@ -95,7 +197,13 @@ export interface RateLimitListParams extends PageCursorParams {
 export declare namespace RateLimits {
   export {
     type BetaOrganizationRateLimit as BetaOrganizationRateLimit,
+    type BetaOrganizationRateLimitBatchGroup as BetaOrganizationRateLimitBatchGroup,
+    type BetaOrganizationRateLimitFilesGroup as BetaOrganizationRateLimitFilesGroup,
+    type BetaOrganizationRateLimitModelGroup as BetaOrganizationRateLimitModelGroup,
+    type BetaOrganizationRateLimitSkillsGroup as BetaOrganizationRateLimitSkillsGroup,
+    type BetaOrganizationRateLimitTokenCountGroup as BetaOrganizationRateLimitTokenCountGroup,
     type BetaOrganizationRateLimitValue as BetaOrganizationRateLimitValue,
+    type BetaOrganizationRateLimitWebSearchGroup as BetaOrganizationRateLimitWebSearchGroup,
     type BetaOrganizationRateLimitsPageCursor as BetaOrganizationRateLimitsPageCursor,
     type RateLimitListParams as RateLimitListParams,
   };

package/src/resources/beta/organization/workspaces/rate-limits.ts

@@ -1,4 +1,5 @@
 import { APIResource } from '../../../../core/resource';
+import * as RateLimitsAPI from '../rate-limits';
 import { PageCursor, type PageCursorParams, PagePromise } from '../../../../core/pagination';
 import { RequestOptions } from '../../../../internal/request-options';
 import { path } from '../../../../internal/utils/path';
@@ -41,9 +42,20 @@ export type BetaWorkspaceRateLimitsPageCursor = PageCursor<BetaWorkspaceRateLimi
 
 export interface BetaWorkspaceRateLimit {
   /**
-   * The kind of rate-limit group this entry represents. `model_group` entries apply
-   * to a family of models (listed in `models`); other values apply to an API-surface
-   * category and have `models` set to `null`.
+   * The rate-limit group this entry's limits apply to. Its `type` equals
+   * `group_type`.
+   */
+  group:
+    | RateLimitsAPI.BetaOrganizationRateLimitModelGroup
+    | RateLimitsAPI.BetaOrganizationRateLimitBatchGroup
+    | RateLimitsAPI.BetaOrganizationRateLimitTokenCountGroup
+    | RateLimitsAPI.BetaOrganizationRateLimitFilesGroup
+    | RateLimitsAPI.BetaOrganizationRateLimitSkillsGroup
+    | RateLimitsAPI.BetaOrganizationRateLimitWebSearchGroup;
+
+  /**
+   * @deprecated Use `group.type` instead. `group_type` is still returned and always
+   * equals `group.type`.
    */
   group_type: 'batch' | 'files' | 'model_group' | 'skills' | 'token_count' | 'web_search';
 
@@ -60,7 +72,7 @@ export interface BetaWorkspaceRateLimit {
   models: Array<string> | null;
 
   /**
-   * The `id` of the RateLimit group this override applies to.
+   * The `id` of the organization's RateLimit entry this override applies to.
    */
   rate_limit_id: string;
 

package/src/resources/beta/organization/workspaces/workspaces.ts

@@ -146,17 +146,17 @@ export interface BetaDataResidency {
   /**
    * Permitted inference geo values. 'unrestricted' means all geos are allowed.
    */
-  allowed_inference_geos: Array<string> | 'unrestricted';
+  allowed_inference_geos: Array<BetaAllowedInferenceGeo> | 'unrestricted';
 
   /**
    * Default inference geo applied when requests omit the parameter.
    */
-  default_inference_geo: string;
+  default_inference_geo: 'global' | 'us';
 
   /**
    * Geographic region for workspace data storage. Immutable after creation.
    */
-  workspace_geo: string;
+  workspace_geo: 'us';
 }
 
 export interface BetaDataResidencyCreateConfig {

package/src/resources/beta/sessions/events.ts

@@ -226,7 +226,9 @@ export interface BetaManagedAgentsAgentCustomToolUseEvent {
   /**
    * When set, this event was cross-posted from a subagent's thread to surface its
    * custom tool use on the primary thread's stream. Empty on the thread's own
-   * events. Echo this on a `user.custom_tool_result` event to route the result back.
+   * events. Informational only: the server routes the matching
+   * `user.custom_tool_result` by `custom_tool_use_id`, so clients do not send it
+   * back.
    */
   session_thread_id?: string | null;
 }
@@ -314,8 +316,8 @@ export interface BetaManagedAgentsAgentMCPToolUseEvent {
   /**
    * When set, this event was cross-posted from a subagent's thread to surface its
    * permission request on the primary thread's stream. Empty on the thread's own
-   * events. Echo this on a `user.tool_confirmation` event to route the approval
-   * back.
+   * events. Informational only: the server routes the matching
+   * `user.tool_confirmation` by `tool_use_id`, so clients do not send it back.
    */
   session_thread_id?: string | null;
 }
@@ -574,8 +576,9 @@ export interface BetaManagedAgentsAgentToolUseEvent {
   /**
    * When set, this event was cross-posted from a subagent's thread to surface its
    * permission request on the primary thread's stream. Empty on the thread's own
-   * events. Echo this on a `user.tool_confirmation` event to route the approval
-   * back.
+   * events. Informational only: the server routes the matching
+   * `user.tool_confirmation` or `user.tool_result` by `tool_use_id`, so clients do
+   * not send it back.
    */
   session_thread_id?: string | null;
 }
@@ -1041,11 +1044,6 @@ export interface BetaManagedAgentsSessionErrorEvent {
    */
   id: string;
 
-  /**
-   * An unknown or unexpected error occurred during session execution. A fallback
-   * variant; clients that don't recognize a new error code can match on
-   * `retry_status` and `message` alone.
-   */
   error:
     | BetaManagedAgentsUnknownError
     | BetaManagedAgentsModelOverloadedError
@@ -1141,9 +1139,6 @@ export interface BetaManagedAgentsSessionStatusIdleEvent {
    */
   processed_at: string;
 
-  /**
-   * The agent completed its turn naturally and is ready for the next user message.
-   */
   stop_reason:
     | BetaManagedAgentsSessionEndTurn
     | BetaManagedAgentsSessionRequiresAction
@@ -1258,9 +1253,6 @@ export interface BetaManagedAgentsSessionThreadStatusIdleEvent {
    */
   session_thread_id: string;
 
-  /**
-   * The agent completed its turn naturally and is ready for the next user message.
-   */
   stop_reason:
     | BetaManagedAgentsSessionEndTurn
     | BetaManagedAgentsSessionRequiresAction
@@ -1777,8 +1769,8 @@ export interface BetaManagedAgentsUserCustomToolResultEvent {
   processed_at?: string | null;
 
   /**
-   * Routes this result to a subagent thread. Copy from the `agent.custom_tool_use`
-   * event's `session_thread_id`.
+   * Set by the server to the subagent thread this result was routed to. Omitted when
+   * it was routed to the primary thread.
    */
   session_thread_id?: string | null;
 }
@@ -1993,9 +1985,8 @@ export interface BetaManagedAgentsUserToolConfirmationEvent {
   processed_at?: string | null;
 
   /**
-   * When set, the confirmation routes to this subagent's thread rather than the
-   * primary. Echo this from the `session_thread_id` on the `agent.tool_use` or
-   * `agent.mcp_tool_use` event that prompted the approval.
+   * Set by the server to the subagent thread this confirmation was routed to.
+   * Omitted when it was routed to the primary thread.
    */
   session_thread_id?: string | null;
 }

package/src/resources/beta/sessions/resources.ts

@@ -268,9 +268,6 @@ export interface BetaManagedAgentsMemoryStoreResource {
   name?: string | null;
 }
 
-/**
- * A memory store attached to an agent session.
- */
 export type BetaManagedAgentsSessionResource =
   | BetaManagedAgentsGitHubRepositoryResource
   | BetaManagedAgentsFileResource

package/src/resources/beta/sessions/sessions.ts

@@ -741,6 +741,12 @@ export interface BetaManagedAgentsSession {
 
   /**
    * SessionStatus enum
+   *
+   * - `rescheduling` - Transient error occurred, retrying automatically.
+   * - `running` - Agent is actively executing.
+   * - `idle` - Agent is waiting for input, including user messages or tool
+   *   confirmations. Sessions start in idle.
+   * - `terminated` - Session has ended, either due to an error or completion.
    */
   status: 'rescheduling' | 'running' | 'idle' | 'terminated';
 
@@ -1077,8 +1083,8 @@ export interface BetaManagedAgentsUserToolResultEvent {
   processed_at?: string | null;
 
   /**
-   * Routes this result to a subagent thread. Copy from the `agent.tool_use` event's
-   * `session_thread_id`.
+   * Set by the server to the subagent thread this result was routed to. Omitted when
+   * it was routed to the primary thread.
    */
   session_thread_id?: string | null;
 }

package/src/resources/beta/tunnels/certificates.ts

@@ -225,7 +225,7 @@ export interface CertificateCreateParams {
 
 export interface CertificateRetrieveParams {
   /**
-   * Path param: Path parameter tunnel_id
+   * Path param: ID of the tunnel (`tnl_...`).
    */
   tunnel_id: string;
 
@@ -270,7 +270,7 @@ export interface CertificateListParams extends PageCursorParams {
 
 export interface CertificateArchiveParams {
   /**
-   * Path param: Path parameter tunnel_id
+   * Path param: ID of the tunnel (`tnl_...`).
    */
   tunnel_id: string;
 

package/src/resources/beta/user-profiles.ts

@@ -17,12 +17,15 @@ export class UserProfiles extends APIResource {
    * ```
    */
   create(params: UserProfileCreateParams, options?: RequestOptions): APIPromise<BetaUserProfile> {
-    const { betas, ...body } = params;
+    const { betas, workspace_id, ...body } = params;
     return this._client.post('/v1/user_profiles?beta=true', {
       body,
       ...options,
       headers: buildHeaders([
-        { 'anthropic-beta': [...(betas ?? []), 'user-profiles-2026-08-18'].toString() },
+        {
+          'anthropic-beta': [...(betas ?? []), 'user-profiles-2026-08-18'].toString(),
+          ...(workspace_id != null ? { 'anthropic-workspace-id': workspace_id } : undefined),
+        },
         options?.headers,
       ]),
     });
@@ -44,11 +47,14 @@ export class UserProfiles extends APIResource {
     params: UserProfileRetrieveParams | null | undefined = {},
     options?: RequestOptions,
   ): APIPromise<BetaUserProfile> {
-    const { betas } = params ?? {};
+    const { betas, workspace_id } = params ?? {};
     return this._client.get(path`/v1/user_profiles/${userProfileID}?beta=true`, {
       ...options,
       headers: buildHeaders([
-        { 'anthropic-beta': [...(betas ?? []), 'user-profiles-2026-08-18'].toString() },
+        {
+          'anthropic-beta': [...(betas ?? []), 'user-profiles-2026-08-18'].toString(),
+          ...(workspace_id != null ? { 'anthropic-workspace-id': workspace_id } : undefined),
+        },
         options?.headers,
       ]),
     });
@@ -70,12 +76,15 @@ export class UserProfiles extends APIResource {
     params: UserProfileUpdateParams,
     options?: RequestOptions,
   ): APIPromise<BetaUserProfile> {
-    const { betas, ...body } = params;
+    const { betas, workspace_id, ...body } = params;
     return this._client.post(path`/v1/user_profiles/${userProfileID}?beta=true`, {
       body,
       ...options,
       headers: buildHeaders([
-        { 'anthropic-beta': [...(betas ?? []), 'user-profiles-2026-08-18'].toString() },
+        {
+          'anthropic-beta': [...(betas ?? []), 'user-profiles-2026-08-18'].toString(),
+          ...(workspace_id != null ? { 'anthropic-workspace-id': workspace_id } : undefined),
+        },
         options?.headers,
       ]),
     });
@@ -96,12 +105,15 @@ export class UserProfiles extends APIResource {
     params: UserProfileListParams | null | undefined = {},
     options?: RequestOptions,
   ): PagePromise<BetaUserProfilesPageCursor, BetaUserProfile> {
-    const { betas, ...query } = params ?? {};
+    const { betas, workspace_id, ...query } = params ?? {};
     return this._client.getAPIList('/v1/user_profiles?beta=true', PageCursor<BetaUserProfile>, {
       query,
       ...options,
       headers: buildHeaders([
-        { 'anthropic-beta': [...(betas ?? []), 'user-profiles-2026-08-18'].toString() },
+        {
+          'anthropic-beta': [...(betas ?? []), 'user-profiles-2026-08-18'].toString(),
+          ...(workspace_id != null ? { 'anthropic-workspace-id': workspace_id } : undefined),
+        },
         options?.headers,
       ]),
     });
@@ -123,11 +135,14 @@ export class UserProfiles extends APIResource {
     params: UserProfileCreateEnrollmentURLParams | null | undefined = {},
     options?: RequestOptions,
   ): APIPromise<BetaUserProfileEnrollmentURL> {
-    const { betas } = params ?? {};
+    const { betas, workspace_id } = params ?? {};
     return this._client.post(path`/v1/user_profiles/${userProfileID}/enrollment_url?beta=true`, {
       ...options,
       headers: buildHeaders([
-        { 'anthropic-beta': [...(betas ?? []), 'user-profiles-2026-08-18'].toString() },
+        {
+          'anthropic-beta': [...(betas ?? []), 'user-profiles-2026-08-18'].toString(),
+          ...(workspace_id != null ? { 'anthropic-workspace-id': workspace_id } : undefined),
+        },
         options?.headers,
       ]),
     });
@@ -378,6 +393,16 @@ export interface UserProfileCreateParams {
    * Header param: Optional header to specify the beta version(s) you want to use.
    */
   betas?: Array<BetaAPI.AnthropicBeta>;
+
+  /**
+   * Header param: Optional header to select the Workspace for this request. The
+   * value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
+   *
+   * Only needed for credentials that can act on more than one Workspace. A
+   * credential that belongs to a specific Workspace may omit it; if sent, it must
+   * match that Workspace.
+   */
+  workspace_id?: string;
 }
 
 export interface UserProfileRetrieveParams {
@@ -385,6 +410,16 @@ export interface UserProfileRetrieveParams {
    * Optional header to specify the beta version(s) you want to use.
    */
   betas?: Array<BetaAPI.AnthropicBeta>;
+
+  /**
+   * Optional header to select the Workspace for this request. The value is a
+   * Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
+   *
+   * Only needed for credentials that can act on more than one Workspace. A
+   * credential that belongs to a specific Workspace may omit it; if sent, it must
+   * match that Workspace.
+   */
+  workspace_id?: string;
 }
 
 export interface UserProfileUpdateParams {
@@ -436,6 +471,16 @@ export interface UserProfileUpdateParams {
    * Header param: Optional header to specify the beta version(s) you want to use.
    */
   betas?: Array<BetaAPI.AnthropicBeta>;
+
+  /**
+   * Header param: Optional header to select the Workspace for this request. The
+   * value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
+   *
+   * Only needed for credentials that can act on more than one Workspace. A
+   * credential that belongs to a specific Workspace may omit it; if sent, it must
+   * match that Workspace.
+   */
+  workspace_id?: string;
 }
 
 export interface UserProfileListParams extends PageCursorParams {
@@ -453,6 +498,16 @@ export interface UserProfileListParams extends PageCursorParams {
    * Header param: Optional header to specify the beta version(s) you want to use.
    */
   betas?: Array<BetaAPI.AnthropicBeta>;
+
+  /**
+   * Header param: Optional header to select the Workspace for this request. The
+   * value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
+   *
+   * Only needed for credentials that can act on more than one Workspace. A
+   * credential that belongs to a specific Workspace may omit it; if sent, it must
+   * match that Workspace.
+   */
+  workspace_id?: string;
 }
 
 export interface UserProfileCreateEnrollmentURLParams {
@@ -460,6 +515,16 @@ export interface UserProfileCreateEnrollmentURLParams {
    * Optional header to specify the beta version(s) you want to use.
    */
   betas?: Array<BetaAPI.AnthropicBeta>;
+
+  /**
+   * Optional header to select the Workspace for this request. The value is a
+   * Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
+   *
+   * Only needed for credentials that can act on more than one Workspace. A
+   * credential that belongs to a specific Workspace may omit it; if sent, it must
+   * match that Workspace.
+   */
+  workspace_id?: string;
 }
 
 export declare namespace UserProfiles {