@anthropic-ai/sdk 0.122.0 → 0.123.0

package/src/resources/beta/messages/messages.ts

@@ -1221,10 +1221,6 @@ export interface BetaBrowserSwitchTabConfig {
 export interface BetaBrowserToolset20260801 {
   type: 'browser_toolset_20260801';
 
-  allowed_callers?: Array<
-    'direct' | 'code_execution_20250825' | 'code_execution_20260120' | 'code_execution_20260521'
-  >;
-
   /**
    * Create a cache control breakpoint at this content block.
    */
@@ -2472,10 +2468,6 @@ export interface BetaComputerScrollConfig {
 export interface BetaComputerToolset20260801 {
   type: 'computer_toolset_20260801';
 
-  allowed_callers?: Array<
-    'direct' | 'code_execution_20250825' | 'code_execution_20260120' | 'code_execution_20260521'
-  >;
-
   /**
    * Create a cache control breakpoint at this content block.
    */
@@ -3692,6 +3684,25 @@ export interface BetaMessage {
    * `cache_creation_input_tokens`, and `cache_read_input_tokens`.
    */
   usage: BetaUsage;
+
+  /**
+   * Changes the API made to the request's input before showing it to the model: one
+   * entry per change, in request order. Today the only entry type is
+   * `thinking_dropped` — a `thinking`, `redacted_thinking` or `connector_text` block
+   * from the request's `messages` that was removed from the prompt instead of being
+   * shown to the model because it failed a binding check. More entry types may be
+   * added over time; ignore types you do not recognize.
+   *
+   * Requires `anthropic-beta: thinking-binding-controls-2026-08-01`. Present on
+   * every such response from a model that supports extended thinking, as `[]` when
+   * nothing was changed; without the beta, blocks are removed all the same but
+   * nothing is reported. Removed blocks contribute nothing to `usage.input_tokens`.
+   * When streaming, the array is final in `message_start`; the final `message_delta`
+   * event carries it only when a server-side model fallback happened mid-stream, in
+   * which case it holds the serving model's entries and replaces the one in
+   * `message_start`.
+   */
+  input_transformations?: Array<BetaThinkingDroppedInputTransformation> | null;
 }
 
 export interface BetaMessageDeltaUsage {
@@ -3809,6 +3820,25 @@ export interface BetaMessageParam {
   content: string | Array<BetaContentBlockParam>;
 
   role: 'user' | 'assistant' | 'system';
+
+  /**
+   * How long this system message's text stays in front of the model. `"never"` (the
+   * default) renders it on every request that includes it. `"next_user_message"`
+   * renders it only for the user turn it follows: once a later `role: "user"`
+   * message exists in `messages` the message stays in the array (send it unchanged)
+   * but is no longer shown to the model. Only permitted on `role: "system"`
+   * messages.
+   */
+  clear_at?: 'next_user_message' | 'never' | null;
+
+  /**
+   * Per-message output configuration on a role:"system" input message.
+   *
+   * Fields here apply per-turn; `format` remains top-level only. An empty `{}` is
+   * accepted on a message that carries content; a message with neither content nor
+   * output_config fields is rejected.
+   */
+  output_config?: BetaSystemMessageOutputConfig | null;
 }
 
 export interface BetaMessageTokensCount {
@@ -3953,6 +3983,25 @@ export interface BetaRawMessageDeltaEvent {
    * `cache_creation_input_tokens`, and `cache_read_input_tokens`.
    */
   usage: BetaMessageDeltaUsage;
+
+  /**
+   * Changes the API made to the request's input before showing it to the model: one
+   * entry per change, in request order. Today the only entry type is
+   * `thinking_dropped` — a `thinking`, `redacted_thinking` or `connector_text` block
+   * from the request's `messages` that was removed from the prompt instead of being
+   * shown to the model because it failed a binding check. More entry types may be
+   * added over time; ignore types you do not recognize.
+   *
+   * Requires `anthropic-beta: thinking-binding-controls-2026-08-01`. Present on
+   * every such response from a model that supports extended thinking, as `[]` when
+   * nothing was changed; without the beta, blocks are removed all the same but
+   * nothing is reported. Removed blocks contribute nothing to `usage.input_tokens`.
+   * When streaming, the array is final in `message_start`; the final `message_delta`
+   * event carries it only when a server-side model fallback happened mid-stream, in
+   * which case it holds the serving model's entries and replaces the one in
+   * `message_start`.
+   */
+  input_transformations?: Array<BetaThinkingDroppedInputTransformation> | null;
 }
 
 export namespace BetaRawMessageDeltaEvent {
@@ -4343,6 +4392,20 @@ export type BetaStopReason =
   | 'refusal'
   | 'model_context_window_exceeded';
 
+/**
+ * Per-message output configuration on a role:"system" input message.
+ *
+ * Fields here apply per-turn; `format` remains top-level only. An empty `{}` is
+ * accepted on a message that carries content; a message with neither content nor
+ * output_config fields is rejected.
+ */
+export interface BetaSystemMessageOutputConfig {
+  /**
+   * All possible effort levels.
+   */
+  effort?: 'low' | 'medium' | 'high' | 'xhigh' | 'max' | null;
+}
+
 export interface BetaTextBlock {
   /**
    * Citations supporting the text block.
@@ -4537,6 +4600,22 @@ export interface BetaThinkingBlock {
   type: 'thinking';
 }
 
+/**
+ * Controls for block binding: what happens when a thinking block this request
+ * sends back fails the conversation check. Every field is optional; an empty
+ * object means every default.
+ */
+export interface BetaThinkingBlockBinding {
+  /**
+   * What happens when a thinking block in `messages` fails the conversation check:
+   * it was created in a different conversation, or the messages before it have
+   * changed since. `"error"` (the default) fails the request with a 400 error.
+   * `"drop_block"` removes the failing blocks and the request proceeds; the model no
+   * longer sees the dropped reasoning.
+   */
+  prefix_mismatch_behavior?: BetaThinkingPrefixMismatchBehavior | null;
+}
+
 export interface BetaThinkingBlockParam {
   /**
    * The `signature` value of this thinking block, exactly as returned by the API in
@@ -4558,6 +4637,13 @@ export interface BetaThinkingBlockParam {
 export interface BetaThinkingConfigAdaptive {
   type: 'adaptive';
 
+  /**
+   * Controls for block binding: what happens when a thinking block this request
+   * sends back fails the conversation check. Every field is optional; an empty
+   * object means every default.
+   */
+  block_binding?: BetaThinkingBlockBinding | null;
+
   /**
    * Controls how thinking content appears in the response. When set to `summarized`,
    * thinking is returned normally. When set to `omitted`, thinking content is
@@ -4587,6 +4673,13 @@ export interface BetaThinkingConfigEnabled {
 
   type: 'enabled';
 
+  /**
+   * Controls for block binding: what happens when a thinking block this request
+   * sends back fails the conversation check. Every field is optional; an empty
+   * object means every default.
+   */
+  block_binding?: BetaThinkingBlockBinding | null;
+
   /**
    * Controls how thinking content appears in the response. When set to `summarized`,
    * thinking is returned normally. When set to `omitted`, thinking content is
@@ -4635,6 +4728,50 @@ export interface BetaThinkingDelta {
   type: 'thinking_delta';
 }
 
+export interface BetaThinkingDroppedInputTransformation {
+  /**
+   * Where the removed block was in your request, as `messages.{i}.content.{j}`: `i`
+   * indexes the `messages` array you sent and `j` that message's `content` array —
+   * the same form error messages use.
+   */
+  path: string;
+
+  /**
+   * Which binding check removed the block: `model_binding_mismatch` — it was created
+   * by a model whose reasoning the requested model may not read;
+   * `prefix_binding_mismatch` — the conversation before it differs from the
+   * conversation it was created in (the rest of that turn's consecutive thinking
+   * blocks are removed with it, each with this reason);
+   * `organization_binding_mismatch` — it was created under a different organization
+   * (an Anthropic organization, AWS account or Google Cloud project) and this
+   * organization is not one of its additional organizations;
+   * `end_user_binding_mismatch` — it was created for a different end user, or was
+   * removed by the consumer-organization binding. A block that would fail several
+   * checks reports one reason, in this order of precedence:
+   * `organization_binding_mismatch`, `end_user_binding_mismatch`,
+   * `model_binding_mismatch`, `prefix_binding_mismatch`.
+   */
+  reason:
+    | 'model_binding_mismatch'
+    | 'prefix_binding_mismatch'
+    | 'organization_binding_mismatch'
+    | 'end_user_binding_mismatch';
+
+  /**
+   * Always `thinking_dropped` for this entry type.
+   */
+  type: 'thinking_dropped';
+}
+
+/**
+ * What happens when a thinking block in `messages` fails the conversation check:
+ * it was created in a different conversation, or the messages before it have
+ * changed since. `"error"` (the default) fails the request with a 400 error.
+ * `"drop_block"` removes the failing blocks and the request proceeds; the model no
+ * longer sees the dropped reasoning.
+ */
+export type BetaThinkingPrefixMismatchBehavior = 'error' | 'drop_block';
+
 export interface BetaThinkingTurns {
   type: 'thinking_turns';
 
@@ -7060,6 +7197,7 @@ export declare namespace Messages {
     type BetaSignatureDelta as BetaSignatureDelta,
     type BetaSkillParams as BetaSkillParams,
     type BetaStopReason as BetaStopReason,
+    type BetaSystemMessageOutputConfig as BetaSystemMessageOutputConfig,
     type BetaTextBlock as BetaTextBlock,
     type BetaTextBlockParam as BetaTextBlockParam,
     type BetaTextCitation as BetaTextCitation,
@@ -7076,12 +7214,15 @@ export declare namespace Messages {
     type BetaTextEditorCodeExecutionViewResultBlock as BetaTextEditorCodeExecutionViewResultBlock,
     type BetaTextEditorCodeExecutionViewResultBlockParam as BetaTextEditorCodeExecutionViewResultBlockParam,
     type BetaThinkingBlock as BetaThinkingBlock,
+    type BetaThinkingBlockBinding as BetaThinkingBlockBinding,
     type BetaThinkingBlockParam as BetaThinkingBlockParam,
     type BetaThinkingConfigAdaptive as BetaThinkingConfigAdaptive,
     type BetaThinkingConfigDisabled as BetaThinkingConfigDisabled,
     type BetaThinkingConfigEnabled as BetaThinkingConfigEnabled,
     type BetaThinkingConfigParam as BetaThinkingConfigParam,
     type BetaThinkingDelta as BetaThinkingDelta,
+    type BetaThinkingDroppedInputTransformation as BetaThinkingDroppedInputTransformation,
+    type BetaThinkingPrefixMismatchBehavior as BetaThinkingPrefixMismatchBehavior,
     type BetaThinkingTurns as BetaThinkingTurns,
     type BetaTokenTaskBudget as BetaTokenTaskBudget,
     type BetaTool as BetaTool,

package/src/resources/beta/organization/compliance-settings.ts

@@ -0,0 +1,96 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../core/resource';
+import { APIPromise } from '../../../core/api-promise';
+import { RequestOptions } from '../../../internal/request-options';
+
+export class ComplianceSettings extends APIResource {
+  /**
+   * Retrieve your organization's Compliance Settings.
+   *
+   * Compliance Settings is a singleton resource: there is exactly one per
+   * organization, addressed without an identifier. The `state` field reflects
+   * whether the Compliance API is enabled. An organization with a parent
+   * organization reads the state inherited from the parent's configuration.
+   *
+   * @example
+   * ```ts
+   * const betaComplianceSettings =
+   *   await client.beta.organization.complianceSettings.retrieve();
+   * ```
+   */
+  retrieve(options?: RequestOptions): APIPromise<BetaComplianceSettings> {
+    return this._client.get('/v1/organizations/compliance_settings?beta=true', options);
+  }
+
+  /**
+   * Update your organization's Compliance Settings.
+   *
+   * Setting `state` to `enabled` turns on the Compliance API and begins capturing
+   * organization activity events. Setting it to `disabled` turns both off. `state`
+   * reflects whether the Compliance API is enabled.
+   *
+   * A request that sets `state` to its current value succeeds and leaves the
+   * resource unchanged. A `disabled` request stays in effect until a later `enabled`
+   * request or the organization's next provisioning action that enables Access
+   * Transparency: enabling Access Transparency also enables the Compliance API,
+   * which serves its activity events, so such provisioning (including re-runs)
+   * re-enables the Compliance API even after a `disabled` request. Automated
+   * provisioning never disables compliance settings.
+   *
+   * @example
+   * ```ts
+   * const betaComplianceSettings =
+   *   await client.beta.organization.complianceSettings.update({
+   *     state: { type: 'enabled' },
+   *   });
+   * ```
+   */
+  update(body: ComplianceSettingUpdateParams, options?: RequestOptions): APIPromise<BetaComplianceSettings> {
+    return this._client.post('/v1/organizations/compliance_settings?beta=true', { body, ...options });
+  }
+}
+
+export interface BetaComplianceSettings {
+  /**
+   * Whether the Compliance API is enabled for this organization.
+   */
+  state: BetaComplianceSettingsStateEnabled | BetaComplianceSettingsStateDisabled;
+
+  type: 'compliance_settings';
+}
+
+export interface BetaComplianceSettingsStateDisabled {
+  type: 'disabled';
+}
+
+export interface BetaComplianceSettingsStateDisabledParam {
+  type: 'disabled';
+}
+
+export interface BetaComplianceSettingsStateEnabled {
+  type: 'enabled';
+}
+
+export interface BetaComplianceSettingsStateEnabledParam {
+  type: 'enabled';
+}
+
+export interface ComplianceSettingUpdateParams {
+  /**
+   * Desired state. Accepts the string shorthand "enabled" or "disabled" in place of
+   * the object form; the response always returns the canonical object form.
+   */
+  state: BetaComplianceSettingsStateEnabledParam | BetaComplianceSettingsStateDisabledParam;
+}
+
+export declare namespace ComplianceSettings {
+  export {
+    type BetaComplianceSettings as BetaComplianceSettings,
+    type BetaComplianceSettingsStateDisabled as BetaComplianceSettingsStateDisabled,
+    type BetaComplianceSettingsStateDisabledParam as BetaComplianceSettingsStateDisabledParam,
+    type BetaComplianceSettingsStateEnabled as BetaComplianceSettingsStateEnabled,
+    type BetaComplianceSettingsStateEnabledParam as BetaComplianceSettingsStateEnabledParam,
+    type ComplianceSettingUpdateParams as ComplianceSettingUpdateParams,
+  };
+}

package/src/resources/beta/organization/external-keys.ts

@@ -136,7 +136,9 @@ export type BetaExternalKeysPageCursor = PageCursor<BetaExternalKey>;
 
 export interface BetaAWSExternalKeyConfig {
   /**
-   * Full ARN of the AWS KMS key.
+   * Full ARN of the AWS KMS key. On Claude Platform on AWS the key must be a
+   * single-Region key in your organization's own AWS account; cross-account keys,
+   * multi-Region keys, and alias ARNs are rejected.
    */
   kms_arn: string;
 
@@ -148,8 +150,9 @@ export interface BetaAWSExternalKeyConfig {
   region?: string | null;
 
   /**
-   * @deprecated IAM role ARN. Deprecated — Anthropic reaches the KMS key via a
-   * managed intermediate role; this field is ignored.
+   * @deprecated IAM role ARN. Deprecated — Anthropic reaches the KMS key through its
+   * own intermediate role (or, on Claude Platform on AWS, with credentials AWS
+   * issues for the Workspace); this field is ignored.
    */
   role_arn?: string | null;
 }

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

@@ -12,6 +12,15 @@ export {
   type APIKeyListParams,
   type BetaAPIKeysPage,
 } from './api-keys';
+export {
+  ComplianceSettings,
+  type BetaComplianceSettings,
+  type BetaComplianceSettingsStateDisabled,
+  type BetaComplianceSettingsStateDisabledParam,
+  type BetaComplianceSettingsStateEnabled,
+  type BetaComplianceSettingsStateEnabledParam,
+  type ComplianceSettingUpdateParams,
+} from './compliance-settings';
 export {
   ExternalKeys,
   type BetaAWSExternalKeyConfig,

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

@@ -14,6 +14,16 @@ import {
   BetaAPIKeyWorkspaceScope,
   BetaAPIKeysPage,
 } from './api-keys';
+import * as ComplianceSettingsAPI from './compliance-settings';
+import {
+  BetaComplianceSettings,
+  BetaComplianceSettingsStateDisabled,
+  BetaComplianceSettingsStateDisabledParam,
+  BetaComplianceSettingsStateEnabled,
+  BetaComplianceSettingsStateEnabledParam,
+  ComplianceSettingUpdateParams,
+  ComplianceSettings,
+} from './compliance-settings';
 import * as ExternalKeysAPI from './external-keys';
 import {
   BetaAWSExternalKeyConfig,
@@ -99,6 +109,9 @@ export class Organization extends APIResource {
   users: UsersAPI.Users = new UsersAPI.Users(this._client);
   workspaces: WorkspacesAPI.Workspaces = new WorkspacesAPI.Workspaces(this._client);
   rateLimits: RateLimitsAPI.RateLimits = new RateLimitsAPI.RateLimits(this._client);
+  complianceSettings: ComplianceSettingsAPI.ComplianceSettings = new ComplianceSettingsAPI.ComplianceSettings(
+    this._client,
+  );
 
   /**
    * Retrieve information about the organization associated with the authenticated
@@ -153,6 +166,7 @@ Organization.ServiceAccounts = ServiceAccounts;
 Organization.Users = Users;
 Organization.Workspaces = Workspaces;
 Organization.RateLimits = RateLimits;
+Organization.ComplianceSettings = ComplianceSettings;
 
 export declare namespace Organization {
   export { type BetaOrganization as BetaOrganization, type BetaOrganizationRole as BetaOrganizationRole };
@@ -242,4 +256,14 @@ export declare namespace Organization {
     type BetaOrganizationRateLimitsPageCursor as BetaOrganizationRateLimitsPageCursor,
     type RateLimitListParams as RateLimitListParams,
   };
+
+  export {
+    ComplianceSettings as ComplianceSettings,
+    type BetaComplianceSettings as BetaComplianceSettings,
+    type BetaComplianceSettingsStateDisabled as BetaComplianceSettingsStateDisabled,
+    type BetaComplianceSettingsStateDisabledParam as BetaComplianceSettingsStateDisabledParam,
+    type BetaComplianceSettingsStateEnabled as BetaComplianceSettingsStateEnabled,
+    type BetaComplianceSettingsStateEnabledParam as BetaComplianceSettingsStateEnabledParam,
+    type ComplianceSettingUpdateParams as ComplianceSettingUpdateParams,
+  };
 }

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

@@ -221,8 +221,12 @@ export interface BetaWorkspace {
    * key-policy condition so the key is scoped to this compartment. On GCP and Azure,
    * Anthropic enforces the compartment binding automatically; you do not need to
    * reference this value in your key configuration. See the CMEK integration guide
-   * for the required key configuration, including the value used during key
-   * validation.
+   * for the required key configuration; unless your organization is on Claude
+   * Platform on AWS, it includes a separate value used during key validation. On
+   * Claude Platform on AWS there is no separate validation value: the key is
+   * validated against this Workspace's own value when it is attached, so if your key
+   * policy uses the compartment condition, add this value to it before attaching the
+   * key.
    */
   compartment_id: string;
 
@@ -245,10 +249,14 @@ export interface BetaWorkspace {
    * ID of the customer-managed encryption key (CMEK) configuration to use for this
    * Workspace. Setting this field requires CMEK to be enabled for your organization.
    * When set, data stored for this Workspace is encrypted with the referenced key.
-   * Create key configurations with the External Keys API. This field is write-once:
-   * once a key is attached to a Workspace it cannot be detached or replaced. To
-   * rotate key material, rotate the underlying key on your cloud KMS; the
-   * `external_key_id` stays the same.
+   * Create key configurations with the External Keys API. On Claude Platform on AWS
+   * the value is the AWS KMS key ARN, and the key must be a single-Region key in the
+   * same AWS account and Region as the Workspace. On that platform the key is
+   * validated against this Workspace when it is attached, so a key-policy problem is
+   * reported as an error on this request. This field is write-once: once a key is
+   * attached to a Workspace it cannot be detached or replaced. To rotate key
+   * material, rotate the underlying key on your cloud KMS; the `external_key_id`
+   * stays the same.
    */
   external_key_id: string | null;
 
@@ -324,8 +332,12 @@ export interface WorkspaceCreateParams {
    * Body param: ID of the customer-managed encryption key (CMEK) configuration to
    * use for this Workspace. Setting this field requires CMEK to be enabled for your
    * organization. When set, data stored for this Workspace is encrypted with the
-   * referenced key. Create key configurations with the External Keys API. This field
-   * is write-once: once a key is attached to a Workspace it cannot be detached or
+   * referenced key. Create key configurations with the External Keys API. On Claude
+   * Platform on AWS the value is the AWS KMS key ARN, and the key must be a
+   * single-Region key in the same AWS account and Region as the Workspace. On that
+   * platform the key is validated against this Workspace when it is attached, so a
+   * key-policy problem is reported as an error on this request. This field is
+   * write-once: once a key is attached to a Workspace it cannot be detached or
    * replaced. To rotate key material, rotate the underlying key on your cloud KMS;
    * the `external_key_id` stays the same.
    */
@@ -358,10 +370,14 @@ export interface WorkspaceUpdateParams {
    * ID of the customer-managed encryption key (CMEK) configuration to use for this
    * Workspace. Setting this field requires CMEK to be enabled for your organization.
    * When set, data stored for this Workspace is encrypted with the referenced key.
-   * Create key configurations with the External Keys API. This field is write-once:
-   * once a key is attached to a Workspace it cannot be detached or replaced. To
-   * rotate key material, rotate the underlying key on your cloud KMS; the
-   * `external_key_id` stays the same.
+   * Create key configurations with the External Keys API. On Claude Platform on AWS
+   * the value is the AWS KMS key ARN, and the key must be a single-Region key in the
+   * same AWS account and Region as the Workspace. On that platform the key is
+   * validated against this Workspace when it is attached, so a key-policy problem is
+   * reported as an error on this request. This field is write-once: once a key is
+   * attached to a Workspace it cannot be detached or replaced. To rotate key
+   * material, rotate the underlying key on your cloud KMS; the `external_key_id`
+   * stays the same.
    */
   external_key_id?: string;
 

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

@@ -1977,7 +1977,7 @@ export interface EventListParams extends PageCursorParams {
 
   /**
    * Query param: Sort direction for results, ordered by the event's `processed_at`.
-   * Defaults to asc (chronological).
+   * Defaults to `asc` (chronological).
    */
   order?: 'asc' | 'desc';
 

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

@@ -614,7 +614,7 @@ export type BetaManagedAgentsMultiagentRosterEntryParams =
   | BetaManagedAgentsAdvisorParams;
 
 /**
- * Evaluation state for a single outcome defined via a define_outcome event.
+ * Evaluation state for a single outcome defined via a `define_outcome` event.
  */
 export interface BetaManagedAgentsOutcomeEvaluationResource {
   /**
@@ -628,9 +628,9 @@ export interface BetaManagedAgentsOutcomeEvaluationResource {
   description: string;
 
   /**
-   * Grader's verdict text from the most recent evaluation. For satisfied, explains
-   * why criteria are met; for needs_revision (intermediate), what's missing; for
-   * failed, why unrecoverable.
+   * Grader's verdict text from the most recent evaluation. For `satisfied`, explains
+   * why criteria are met; for `needs_revision` (intermediate), what's missing; for
+   * `failed`, why unrecoverable.
    */
   explanation: string | null;
 
@@ -702,7 +702,7 @@ export interface BetaManagedAgentsSession {
   metadata: { [key: string]: string };
 
   /**
-   * Per-outcome evaluation state. One entry per define_outcome event sent to the
+   * Per-outcome evaluation state. One entry per `define_outcome` event sent to the
    * session.
    */
   outcome_evaluations: Array<BetaManagedAgentsOutcomeEvaluationResource>;
@@ -826,7 +826,7 @@ export interface BetaManagedAgentsSessionMultiagentCoordinator {
  */
 export interface BetaManagedAgentsSessionStats {
   /**
-   * Cumulative time in seconds the session spent in running status. Excludes idle
+   * Cumulative time in seconds the session spent in `running` status. Excludes idle
    * time.
    */
   active_seconds?: number;
@@ -1173,7 +1173,7 @@ export interface SessionListParams extends BidirectionalPageCursorParams {
   agent_id?: string;
 
   /**
-   * Query param: Filter by agent version. Only applies when agent_id is also set.
+   * Query param: Filter by agent version. Only applies when `agent_id` is also set.
    */
   agent_version?: number;
 
@@ -1209,14 +1209,14 @@ export interface SessionListParams extends BidirectionalPageCursorParams {
   include_archived?: boolean;
 
   /**
-   * Query param: Filter sessions whose resources contain a memory_store with this
+   * Query param: Filter sessions whose resources contain a `memory_store` with this
    * memory store ID.
    */
   memory_store_id?: string;
 
   /**
-   * Query param: Sort direction for results, ordered by created_at. Defaults to desc
-   * (newest first).
+   * Query param: Sort direction for results, ordered by `created_at`. Defaults to
+   * `desc` (newest first).
    */
   order?: 'asc' | 'desc';
 

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

@@ -186,18 +186,16 @@ export interface BetaUserProfile {
   external_id?: string | null;
 
   /**
-   * Real-world name of the entity this profile represents (company or individual).
-   * For a resold-to company (`access_type` `passthrough`, or `relationship` `resold`
-   * under the `user-profiles-2026-03-24` header) this is that company's name.
+   * A timestamp in RFC 3339 format
    */
-  name?: string | null;
+  external_user_onboarded_at?: string | null;
 
   /**
-   * How the entity behind a user profile relates to the platform that owns the API
-   * key. `external`: an individual end-user of the platform. `resold`: a company the
-   * platform resells Claude access to. `internal`: the platform's own usage.
+   * Real-world name of the entity this profile represents (company or individual).
+   * For a company the platform resells Claude access to (`access_type`
+   * `passthrough`) this is that company's name.
    */
-  relationship?: 'external' | 'resold' | 'internal';
+  name?: string | null;
 }
 
 export interface BetaUserProfileEnrollmentURL {
@@ -240,6 +238,11 @@ export interface UserProfileCreateParams {
    */
   external_id?: string | null;
 
+  /**
+   * Body param: A timestamp in RFC 3339 format
+   */
+  external_user_onboarded_at?: string;
+
   /**
    * Body param: Free-form key-value data to attach to this user profile. Maximum 16
    * keys, with keys up to 64 characters and values up to 512 characters. Values must
@@ -249,20 +252,12 @@ export interface UserProfileCreateParams {
 
   /**
    * Body param: Optional for all profiles. Real-world name of the entity this
-   * profile represents (company or individual); for a resold-to company
-   * (`relationship` `resold` / `access_type` `passthrough`), that company's name
-   * where known. Maximum 255 characters.
+   * profile represents (company or individual); for a company the platform resells
+   * Claude access to (`access_type` `passthrough`), that company's name where known.
+   * Maximum 255 characters.
    */
   name?: string | null;
 
-  /**
-   * Body param: How the entity behind a user profile relates to the platform that
-   * owns the API key. `external`: an individual end-user of the platform. `resold`:
-   * a company the platform resells Claude access to. `internal`: the platform's own
-   * usage.
-   */
-  relationship?: 'external' | 'resold' | 'internal';
-
   /**
    * Header param: Optional header to specify the beta version(s) you want to use.
    */
@@ -292,6 +287,11 @@ export interface UserProfileUpdateParams {
    */
   external_id?: string | null;
 
+  /**
+   * Body param: A timestamp in RFC 3339 format
+   */
+  external_user_onboarded_at?: string;
+
   /**
    * Body param: Key-value pairs to merge into the stored metadata. Keys provided
    * overwrite existing values. To remove a key, set its value to an empty string.
@@ -306,14 +306,6 @@ export interface UserProfileUpdateParams {
    */
   name?: string | null;
 
-  /**
-   * Body param: How the entity behind a user profile relates to the platform that
-   * owns the API key. `external`: an individual end-user of the platform. `resold`:
-   * a company the platform resells Claude access to. `internal`: the platform's own
-   * usage.
-   */
-  relationship?: 'external' | 'resold' | 'internal' | null;
-
   /**
    * Header param: Optional header to specify the beta version(s) you want to use.
    */
@@ -326,6 +318,11 @@ export interface UserProfileListParams extends PageCursorParams {
    */
   order?: 'asc' | 'desc';
 
+  /**
+   * Query param: Query parameter for order_by
+   */
+  order_by?: 'created_at' | 'name';
+
   /**
    * Header param: Optional header to specify the beta version(s) you want to use.
    */