@anthropic-ai/sdk 0.124.0 → 0.125.0

package/src/resources/beta/organization/service-accounts/workspaces.ts

@@ -1,5 +1,3 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
 import { APIResource } from '../../../../core/resource';
 import * as BetaAPI from '../../beta';
 import * as ServiceAccountsAPI from './service-accounts';

package/src/resources/beta/organization/service-accounts.ts

@@ -1,3 +1 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
 export * from './service-accounts/index';

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

@@ -1,5 +1,3 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
 import { APIResource } from '../../../core/resource';
 import * as OrganizationAPI from './organization';
 import { APIPromise } from '../../../core/api-promise';

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

@@ -1,5 +1,3 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
 export {
   Members,
   type MemberRemoveResponse,

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

@@ -1,5 +1,3 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
 import { APIResource } from '../../../../core/resource';
 import * as WorkspacesAPI from './workspaces';
 import { BetaWorkspaceMembersPage } from './workspaces';

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

@@ -1,5 +1,3 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
 import { APIResource } from '../../../../core/resource';
 import { PageCursor, type PageCursorParams, PagePromise } from '../../../../core/pagination';
 import { RequestOptions } from '../../../../internal/request-options';

package/src/resources/beta/organization/workspaces/service-accounts.ts

@@ -1,5 +1,3 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
 import { APIResource } from '../../../../core/resource';
 import * as BetaAPI from '../../beta';
 import * as ServiceAccountsAPI from '../service-accounts/service-accounts';

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

@@ -1,5 +1,3 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
 import { APIResource } from '../../../../core/resource';
 import * as BetaAPI from '../../beta';
 import * as MembersAPI from './members';

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

@@ -1,3 +1 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
 export * from './workspaces/index';

package/src/resources/beta/organization.ts

@@ -1,3 +1 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
 export * from './organization/index';

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

@@ -1,5 +1,3 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
 import type { Anthropic } from '../../../client';
 import { APIResource } from '../../../core/resource';
 import * as BetaAPI from '../beta';
@@ -152,6 +150,52 @@ export class Events extends APIResource {
 
 export type BetaManagedAgentsSessionEventsPageCursor = PageCursor<BetaManagedAgentsSessionEvent>;
 
+/**
+ * The server's per-invocation judgement under the auto permission policy. Its type
+ * always equals the event's top-level evaluated_permission. Open union: clients
+ * must tolerate unknown variants.
+ */
+export type BetaManagedAgentsAgentAutoEvaluatedPermission =
+  | BetaManagedAgentsAgentAutoEvaluatedPermissionAllow
+  | BetaManagedAgentsAgentAutoEvaluatedPermissionAsk
+  | BetaManagedAgentsAgentAutoEvaluatedPermissionDeny;
+
+/**
+ * The server judged the invocation safe to execute without client approval.
+ */
+export interface BetaManagedAgentsAgentAutoEvaluatedPermissionAllow {
+  type: 'allow';
+}
+
+/**
+ * The server reached no judgement; the invocation is held for client approval.
+ */
+export interface BetaManagedAgentsAgentAutoEvaluatedPermissionAsk {
+  /**
+   * The judgement's grounds in registry-bound terms, for client branching and audit
+   * rather than end-user display. Open registry; currently "indeterminate" (no
+   * judgement was reached). Clients must tolerate values outside this set.
+   */
+  reason_code: string;
+
+  type: 'ask';
+}
+
+/**
+ * The server judged the invocation high-risk; it does not execute and a synthetic
+ * error tool result is appended.
+ */
+export interface BetaManagedAgentsAgentAutoEvaluatedPermissionDeny {
+  /**
+   * The judgement's grounds in registry-bound terms. Open registry; currently
+   * "high_risk" (judged high-risk; the call does not run). Clients must tolerate
+   * values outside this set.
+   */
+  reason_code: string;
+
+  type: 'deny';
+}
+
 /**
  * Event emitted when the agent calls a custom tool. The session goes idle until
  * the client sends a `user.custom_tool_result` event with the result.
@@ -260,6 +304,13 @@ export interface BetaManagedAgentsAgentMCPToolUseEvent {
    */
   evaluated_permission?: 'allow' | 'ask' | 'deny';
 
+  /**
+   * Names the resolved permission_policy that produced evaluated_permission, and
+   * under auto carries the judgement. Open union: clients must tolerate unknown
+   * variants.
+   */
+  evaluation?: BetaManagedAgentsAgentToolEvaluation;
+
   /**
    * 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
@@ -404,6 +455,47 @@ export interface BetaManagedAgentsAgentThreadMessageSentEvent {
   to_agent_name?: string | null;
 }
 
+/**
+ * Names the resolved permission_policy that produced evaluated_permission, and
+ * under auto carries the judgement. Open union: clients must tolerate unknown
+ * variants.
+ */
+export type BetaManagedAgentsAgentToolEvaluation =
+  | BetaManagedAgentsAgentToolEvaluationAlwaysAllow
+  | BetaManagedAgentsAgentToolEvaluationAlwaysAsk
+  | BetaManagedAgentsAgentToolEvaluationAuto;
+
+/**
+ * The resolved permission_policy was always_allow; accompanies
+ * evaluated_permission "allow".
+ */
+export interface BetaManagedAgentsAgentToolEvaluationAlwaysAllow {
+  type: 'always_allow';
+}
+
+/**
+ * The resolved permission_policy was always_ask; accompanies evaluated_permission
+ * "ask".
+ */
+export interface BetaManagedAgentsAgentToolEvaluationAlwaysAsk {
+  type: 'always_ask';
+}
+
+/**
+ * The resolved permission_policy was auto: the server judged this invocation
+ * individually.
+ */
+export interface BetaManagedAgentsAgentToolEvaluationAuto {
+  /**
+   * The server's per-invocation judgement under the auto permission policy. Its type
+   * always equals the event's top-level evaluated_permission. Open union: clients
+   * must tolerate unknown variants.
+   */
+  evaluated_permission: BetaManagedAgentsAgentAutoEvaluatedPermission;
+
+  type: 'auto';
+}
+
 /**
  * Event representing the result of an agent tool execution.
  */
@@ -472,6 +564,13 @@ export interface BetaManagedAgentsAgentToolUseEvent {
    */
   evaluated_permission?: 'allow' | 'ask' | 'deny';
 
+  /**
+   * Names the resolved permission_policy that produced evaluated_permission, and
+   * under auto carries the judgement. Open union: clients must tolerate unknown
+   * variants.
+   */
+  evaluation?: BetaManagedAgentsAgentToolEvaluation;
+
   /**
    * 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
@@ -2074,6 +2173,10 @@ export declare namespace Events {
   export { SessionToolRunner };
 
   export {
+    type BetaManagedAgentsAgentAutoEvaluatedPermission as BetaManagedAgentsAgentAutoEvaluatedPermission,
+    type BetaManagedAgentsAgentAutoEvaluatedPermissionAllow as BetaManagedAgentsAgentAutoEvaluatedPermissionAllow,
+    type BetaManagedAgentsAgentAutoEvaluatedPermissionAsk as BetaManagedAgentsAgentAutoEvaluatedPermissionAsk,
+    type BetaManagedAgentsAgentAutoEvaluatedPermissionDeny as BetaManagedAgentsAgentAutoEvaluatedPermissionDeny,
     type BetaManagedAgentsAgentCustomToolUseEvent as BetaManagedAgentsAgentCustomToolUseEvent,
     type BetaManagedAgentsAgentMCPToolResultEvent as BetaManagedAgentsAgentMCPToolResultEvent,
     type BetaManagedAgentsAgentMCPToolUseEvent as BetaManagedAgentsAgentMCPToolUseEvent,
@@ -2082,6 +2185,10 @@ export declare namespace Events {
     type BetaManagedAgentsAgentThreadContextCompactedEvent as BetaManagedAgentsAgentThreadContextCompactedEvent,
     type BetaManagedAgentsAgentThreadMessageReceivedEvent as BetaManagedAgentsAgentThreadMessageReceivedEvent,
     type BetaManagedAgentsAgentThreadMessageSentEvent as BetaManagedAgentsAgentThreadMessageSentEvent,
+    type BetaManagedAgentsAgentToolEvaluation as BetaManagedAgentsAgentToolEvaluation,
+    type BetaManagedAgentsAgentToolEvaluationAlwaysAllow as BetaManagedAgentsAgentToolEvaluationAlwaysAllow,
+    type BetaManagedAgentsAgentToolEvaluationAlwaysAsk as BetaManagedAgentsAgentToolEvaluationAlwaysAsk,
+    type BetaManagedAgentsAgentToolEvaluationAuto as BetaManagedAgentsAgentToolEvaluationAuto,
     type BetaManagedAgentsAgentToolResultEvent as BetaManagedAgentsAgentToolResultEvent,
     type BetaManagedAgentsAgentToolUseEvent as BetaManagedAgentsAgentToolUseEvent,
     type BetaManagedAgentsBase64DocumentSource as BetaManagedAgentsBase64DocumentSource,

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

@@ -1,7 +1,9 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
 export {
   Events,
+  type BetaManagedAgentsAgentAutoEvaluatedPermission,
+  type BetaManagedAgentsAgentAutoEvaluatedPermissionAllow,
+  type BetaManagedAgentsAgentAutoEvaluatedPermissionAsk,
+  type BetaManagedAgentsAgentAutoEvaluatedPermissionDeny,
   type BetaManagedAgentsAgentCustomToolUseEvent,
   type BetaManagedAgentsAgentMCPToolResultEvent,
   type BetaManagedAgentsAgentMCPToolUseEvent,
@@ -10,6 +12,10 @@ export {
   type BetaManagedAgentsAgentThreadContextCompactedEvent,
   type BetaManagedAgentsAgentThreadMessageReceivedEvent,
   type BetaManagedAgentsAgentThreadMessageSentEvent,
+  type BetaManagedAgentsAgentToolEvaluation,
+  type BetaManagedAgentsAgentToolEvaluationAlwaysAllow,
+  type BetaManagedAgentsAgentToolEvaluationAlwaysAsk,
+  type BetaManagedAgentsAgentToolEvaluationAuto,
   type BetaManagedAgentsAgentToolResultEvent,
   type BetaManagedAgentsAgentToolUseEvent,
   type BetaManagedAgentsBase64DocumentSource,

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

@@ -1,5 +1,3 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
 import { APIResource } from '../../../core/resource';
 import * as BetaAPI from '../beta';
 import * as SessionsAPI from './sessions';

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

@@ -1,10 +1,12 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
 import { APIResource } from '../../../core/resource';
 import * as BetaAPI from '../beta';
 import * as AgentsAPI from '../agents/agents';
 import * as EventsAPI from './events';
 import {
+  BetaManagedAgentsAgentAutoEvaluatedPermission,
+  BetaManagedAgentsAgentAutoEvaluatedPermissionAllow,
+  BetaManagedAgentsAgentAutoEvaluatedPermissionAsk,
+  BetaManagedAgentsAgentAutoEvaluatedPermissionDeny,
   BetaManagedAgentsAgentCustomToolUseEvent,
   BetaManagedAgentsAgentMCPToolResultEvent,
   BetaManagedAgentsAgentMCPToolUseEvent,
@@ -13,6 +15,10 @@ import {
   BetaManagedAgentsAgentThreadContextCompactedEvent,
   BetaManagedAgentsAgentThreadMessageReceivedEvent,
   BetaManagedAgentsAgentThreadMessageSentEvent,
+  BetaManagedAgentsAgentToolEvaluation,
+  BetaManagedAgentsAgentToolEvaluationAlwaysAllow,
+  BetaManagedAgentsAgentToolEvaluationAlwaysAsk,
+  BetaManagedAgentsAgentToolEvaluationAuto,
   BetaManagedAgentsAgentToolResultEvent,
   BetaManagedAgentsAgentToolUseEvent,
   BetaManagedAgentsBase64DocumentSource,
@@ -543,11 +549,6 @@ export interface BetaManagedAgentsFileResourceParams {
  * Mount a GitHub repository into the session's container.
  */
 export interface BetaManagedAgentsGitHubRepositoryResourceParams {
-  /**
-   * GitHub authorization token used to clone the repository.
-   */
-  authorization_token: string;
-
   type: 'github_repository';
 
   /**
@@ -555,6 +556,12 @@ export interface BetaManagedAgentsGitHubRepositoryResourceParams {
    */
   url: string;
 
+  /**
+   * GitHub authorization token used to clone the repository. Required for private
+   * repositories; optional for public ones.
+   */
+  authorization_token?: string;
+
   /**
    * Branch or commit to check out. Defaults to the repository's default branch.
    */
@@ -1375,6 +1382,10 @@ export declare namespace Sessions {
 
   export {
     Events as Events,
+    type BetaManagedAgentsAgentAutoEvaluatedPermission as BetaManagedAgentsAgentAutoEvaluatedPermission,
+    type BetaManagedAgentsAgentAutoEvaluatedPermissionAllow as BetaManagedAgentsAgentAutoEvaluatedPermissionAllow,
+    type BetaManagedAgentsAgentAutoEvaluatedPermissionAsk as BetaManagedAgentsAgentAutoEvaluatedPermissionAsk,
+    type BetaManagedAgentsAgentAutoEvaluatedPermissionDeny as BetaManagedAgentsAgentAutoEvaluatedPermissionDeny,
     type BetaManagedAgentsAgentCustomToolUseEvent as BetaManagedAgentsAgentCustomToolUseEvent,
     type BetaManagedAgentsAgentMCPToolResultEvent as BetaManagedAgentsAgentMCPToolResultEvent,
     type BetaManagedAgentsAgentMCPToolUseEvent as BetaManagedAgentsAgentMCPToolUseEvent,
@@ -1383,6 +1394,10 @@ export declare namespace Sessions {
     type BetaManagedAgentsAgentThreadContextCompactedEvent as BetaManagedAgentsAgentThreadContextCompactedEvent,
     type BetaManagedAgentsAgentThreadMessageReceivedEvent as BetaManagedAgentsAgentThreadMessageReceivedEvent,
     type BetaManagedAgentsAgentThreadMessageSentEvent as BetaManagedAgentsAgentThreadMessageSentEvent,
+    type BetaManagedAgentsAgentToolEvaluation as BetaManagedAgentsAgentToolEvaluation,
+    type BetaManagedAgentsAgentToolEvaluationAlwaysAllow as BetaManagedAgentsAgentToolEvaluationAlwaysAllow,
+    type BetaManagedAgentsAgentToolEvaluationAlwaysAsk as BetaManagedAgentsAgentToolEvaluationAlwaysAsk,
+    type BetaManagedAgentsAgentToolEvaluationAuto as BetaManagedAgentsAgentToolEvaluationAuto,
     type BetaManagedAgentsAgentToolResultEvent as BetaManagedAgentsAgentToolResultEvent,
     type BetaManagedAgentsAgentToolUseEvent as BetaManagedAgentsAgentToolUseEvent,
     type BetaManagedAgentsBase64DocumentSource as BetaManagedAgentsBase64DocumentSource,

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

@@ -1,5 +1,3 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
 import { APIResource } from '../../../../core/resource';
 import * as BetaAPI from '../../beta';
 import * as EventsAPI from '../events';

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

@@ -1,5 +1,3 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
 export { Events, type EventListParams, type EventStreamParams } from './events';
 export {
   Threads,

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

@@ -1,5 +1,3 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
 import { APIResource } from '../../../../core/resource';
 import * as BetaAPI from '../../beta';
 import * as AgentsAPI from '../../agents/agents';

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

@@ -1,3 +1 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
 export * from './threads/index';

package/src/resources/beta/sessions.ts

@@ -1,3 +1 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
 export * from './sessions/index';

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

@@ -1,5 +1,3 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
 export {
   Skills,
   type BetaDeletedSkill,

package/src/resources/beta/skills/skills.ts

@@ -1,5 +1,3 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
 import { APIResource } from '../../../core/resource';
 import * as BetaAPI from '../beta';
 import * as VersionsAPI from './versions';

package/src/resources/beta/skills/versions.ts

@@ -1,5 +1,3 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
 import { APIResource } from '../../../core/resource';
 import * as BetaAPI from '../beta';
 import { APIPromise } from '../../../core/api-promise';

package/src/resources/beta/skills.ts

@@ -1,3 +1 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
 export * from './skills/index';

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

@@ -1,5 +1,3 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
 import { APIResource } from '../../../core/resource';
 import * as BetaAPI from '../beta';
 import { APIPromise } from '../../../core/api-promise';

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

@@ -1,5 +1,3 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
 export {
   Certificates,
   type BetaTunnelCertificate,

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

@@ -1,5 +1,3 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
 import { APIResource } from '../../../core/resource';
 import * as BetaAPI from '../beta';
 import * as CertificatesAPI from './certificates';

package/src/resources/beta/tunnels.ts

@@ -1,3 +1 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
 export * from './tunnels/index';

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

@@ -1,5 +1,3 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
 import { APIResource } from '../../core/resource';
 import * as BetaAPI from './beta';
 import { APIPromise } from '../../core/api-promise';
@@ -181,10 +179,19 @@ export interface BetaUserProfile {
   access_type?: 'application' | 'passthrough';
 
   /**
-   * Platform's own identifier for this user. Not enforced unique.
+   * Platform's own identifier for this user. Not enforced unique. Present under the
+   * `user-profiles-2026-03-24` and `user-profiles-2026-08-18` beta headers; under
+   * `user-profiles-2026-09-04` the value is `external_user_details.reference_id`.
    */
   external_id?: string | null;
 
+  /**
+   * Details about the entity this profile represents, as the platform states them.
+   * Anthropic does not verify them. Every field is present, `null` until the
+   * platform supplies a value.
+   */
+  external_user_details?: BetaUserProfileExternalUserDetails;
+
   /**
    * A timestamp in RFC 3339 format
    */
@@ -215,6 +222,106 @@ export interface BetaUserProfileEnrollmentURL {
   url: string;
 }
 
+/**
+ * Details about the entity this profile represents, as the platform states them.
+ * Anthropic does not verify them. Every field is present, `null` until the
+ * platform supplies a value.
+ */
+export interface BetaUserProfileExternalUserDetails {
+  /**
+   * The status of the entity's account on the platform, as the platform states it:
+   * `active`; `suspended`, when the platform has restricted the account and may
+   * restore it; or `blocked`, when the platform has barred it. It records the
+   * platform's decision only; the statuses in `trust_grants` are Anthropic's and do
+   * not follow it.
+   */
+  account_status: 'active' | 'suspended' | 'blocked' | null;
+
+  /**
+   * The country the platform associates with the entity, as an ISO 3166-1 alpha-2
+   * code. `null` until the platform supplies one.
+   */
+  country: string | null;
+
+  /**
+   * The platform-computed hash of the entity's email address. `null` until the
+   * platform supplies one.
+   */
+  email_hash: string | null;
+
+  /**
+   * What kind of entity the profile represents, as the platform states it:
+   * `individual`, `business`, `non_profit` or `government`.
+   */
+  entity_type: 'individual' | 'business' | 'non_profit' | 'government' | null;
+
+  /**
+   * The platform-computed hash of the entity's name. `null` until the platform
+   * supplies one.
+   */
+  name_hash: string | null;
+
+  /**
+   * A timestamp in RFC 3339 format
+   */
+  onboarded_at: string | null;
+
+  /**
+   * The platform's own reference for the entity. `null` until the platform supplies
+   * one.
+   */
+  reference_id: string | null;
+}
+
+export interface BetaUserProfileExternalUserDetailsParams {
+  /**
+   * The status of the entity's account on the platform, as the platform states it:
+   * `active`; `suspended`, when the platform has restricted the account and may
+   * restore it; or `blocked`, when the platform has barred it. It records the
+   * platform's decision only; the statuses in `trust_grants` are Anthropic's and do
+   * not follow it.
+   */
+  account_status?: 'active' | 'suspended' | 'blocked' | null;
+
+  /**
+   * The country of the entity (not of the platform), as the platform determines it:
+   * an ISO 3166-1 alpha-2 code in upper case, for example `US`. Only the form, two
+   * uppercase ASCII letters, is checked.
+   */
+  country?: string | null;
+
+  /**
+   * A hash of the entity's email address, computed by the platform. Anthropic treats
+   * it as an opaque string and does not prescribe the hash function. 1 to 255
+   * characters.
+   */
+  email_hash?: string | null;
+
+  /**
+   * What kind of entity the profile represents, as the platform states it:
+   * `individual`, `business`, `non_profit` or `government`.
+   */
+  entity_type?: 'individual' | 'business' | 'non_profit' | 'government' | null;
+
+  /**
+   * A hash of the entity's name, computed by the platform. Anthropic treats it as an
+   * opaque string and does not prescribe the hash function. 1 to 255 characters.
+   */
+  name_hash?: string | null;
+
+  /**
+   * A timestamp in RFC 3339 format
+   */
+  onboarded_at?: string;
+
+  /**
+   * The platform's own reference for the entity, for example the key of the
+   * end-user's row in the platform's database. Not interpreted by Anthropic and not
+   * enforced unique. 1 to 255 characters.
+   */
+  reference_id?: string | null;
+}
+
 export interface BetaUserProfileTrustGrant {
   /**
    * Status of the trust grant.
@@ -234,10 +341,19 @@ export interface UserProfileCreateParams {
 
   /**
    * Body param: Platform's own identifier for this user. Not enforced unique.
-   * Maximum 255 characters.
+   * Maximum 255 characters. Accepted under the `user-profiles-2026-03-24` and
+   * `user-profiles-2026-08-18` beta headers; under `user-profiles-2026-09-04` send
+   * `external_user_details.reference_id` instead.
    */
   external_id?: string | null;
 
+  /**
+   * Body param: Details about the entity this profile represents, as the platform
+   * states them. Every field is optional. Accepted under the
+   * `user-profiles-2026-09-04` beta header only.
+   */
+  external_user_details?: BetaUserProfileExternalUserDetailsParams;
+
   /**
    * Body param: A timestamp in RFC 3339 format
    */
@@ -283,10 +399,20 @@ export interface UserProfileUpdateParams {
 
   /**
    * Body param: If present, replaces the stored external_id. Omit to leave
-   * unchanged. Maximum 255 characters.
+   * unchanged. Maximum 255 characters. Accepted under the `user-profiles-2026-03-24`
+   * and `user-profiles-2026-08-18` beta headers; under `user-profiles-2026-09-04`
+   * send `external_user_details.reference_id` instead.
    */
   external_id?: string | null;
 
+  /**
+   * Body param: Details about the entity this profile represents, as the platform
+   * states them. Each field sent replaces the stored value; omit a field to leave it
+   * unchanged. Once set, a value cannot be cleared and `null` is rejected. Accepted
+   * under the `user-profiles-2026-09-04` beta header only.
+   */
+  external_user_details?: BetaUserProfileExternalUserDetailsParams;
+
   /**
    * Body param: A timestamp in RFC 3339 format
    */
@@ -340,6 +466,8 @@ export declare namespace UserProfiles {
   export {
     type BetaUserProfile as BetaUserProfile,
     type BetaUserProfileEnrollmentURL as BetaUserProfileEnrollmentURL,
+    type BetaUserProfileExternalUserDetails as BetaUserProfileExternalUserDetails,
+    type BetaUserProfileExternalUserDetailsParams as BetaUserProfileExternalUserDetailsParams,
     type BetaUserProfileTrustGrant as BetaUserProfileTrustGrant,
     type BetaUserProfilesPageCursor as BetaUserProfilesPageCursor,
     type UserProfileCreateParams as UserProfileCreateParams,

package/src/resources/beta/vaults/credentials.ts

@@ -1,5 +1,3 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
 import { APIResource } from '../../../core/resource';
 import * as BetaAPI from '../beta';
 import { APIPromise } from '../../../core/api-promise';

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

@@ -1,5 +1,3 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
 export {
   Credentials,
   type BetaManagedAgentsCredential,

package/src/resources/beta/vaults/vaults.ts

@@ -1,5 +1,3 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
 import { APIResource } from '../../../core/resource';
 import * as BetaAPI from '../beta';
 import * as CredentialsAPI from './credentials';

package/src/resources/beta/vaults.ts

@@ -1,3 +1 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
 export * from './vaults/index';

package/src/resources/beta/webhooks.ts

@@ -1,5 +1,3 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
 import { APIResource } from '../../core/resource';
 import { Webhook } from 'standardwebhooks';
 

package/src/resources/beta.ts

@@ -1,3 +1 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
 export * from './beta/index';

package/src/resources/completions.ts

@@ -1,5 +1,3 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
 import { APIResource } from '../core/resource';
 import * as CompletionsAPI from './completions';
 import * as BetaAPI from './beta/beta';

package/src/resources/files.ts

@@ -1,5 +1,3 @@
-// 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 { PageCursor, type PageCursorParams, PagePromise } from '../core/pagination';

package/src/resources/index.ts

@@ -1,5 +1,3 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
 export * from './shared';
 export {
   Beta,