feat(api): add claude-opus-4-7, token budgets and user_profiles

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 72
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/anthropic%2Fanthropic-f4d4f18820ecfbe244fb1bbc2232939afca73dfcb21ce23bc296571ee7320e3a.yml
-openapi_spec_hash: d849fdf2c4dd6631a60c4340e9bc1322
-config_hash: 2e9a2fd5355db62857f6be16f46a3ccc
+configured_endpoints: 77
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/anthropic%2Fanthropic-e0696f59ae07dc1a9c5a8fc87a4eb05eb35afabaac0b5ff0ea38810fa9dd4a74.yml
+openapi_spec_hash: 69278ebbb0d1aa0b322bbbd5128bcec5
+config_hash: b0dbd234c2752507397c139a416f6cba

MIGRATION.md

@@ -135,6 +135,9 @@ client.example.list(undefined, { headers: { ... } });
 - `client.beta.skills.delete()`
 - `client.beta.skills.versions.create()`
 - `client.beta.skills.versions.list()`
+- `client.beta.userProfiles.retrieve()`
+- `client.beta.userProfiles.list()`
+- `client.beta.userProfiles.createEnrollmentURL()`
 
 </details>
 

api.md

@@ -426,6 +426,7 @@ Types:
 - <code><a href="./src/resources/beta/messages/messages.ts">BetaThinkingConfigParam</a></code>
 - <code><a href="./src/resources/beta/messages/messages.ts">BetaThinkingDelta</a></code>
 - <code><a href="./src/resources/beta/messages/messages.ts">BetaThinkingTurns</a></code>
+- <code><a href="./src/resources/beta/messages/messages.ts">BetaTokenTaskBudget</a></code>
 - <code><a href="./src/resources/beta/messages/messages.ts">BetaTool</a></code>
 - <code><a href="./src/resources/beta/messages/messages.ts">BetaToolBash20241022</a></code>
 - <code><a href="./src/resources/beta/messages/messages.ts">BetaToolBash20250124</a></code>
@@ -785,3 +786,19 @@ Methods:
 - <code title="get /v1/skills/{skill_id}/versions/{version}?beta=true">client.beta.skills.versions.<a href="./src/resources/beta/skills/versions.ts">retrieve</a>(version, { ...params }) -> VersionRetrieveResponse</code>
 - <code title="get /v1/skills/{skill_id}/versions?beta=true">client.beta.skills.versions.<a href="./src/resources/beta/skills/versions.ts">list</a>(skillID, { ...params }) -> VersionListResponsesPageCursor</code>
 - <code title="delete /v1/skills/{skill_id}/versions/{version}?beta=true">client.beta.skills.versions.<a href="./src/resources/beta/skills/versions.ts">delete</a>(version, { ...params }) -> VersionDeleteResponse</code>
+
+## UserProfiles
+
+Types:
+
+- <code><a href="./src/resources/beta/user-profiles.ts">BetaUserProfile</a></code>
+- <code><a href="./src/resources/beta/user-profiles.ts">BetaUserProfileEnrollmentURL</a></code>
+- <code><a href="./src/resources/beta/user-profiles.ts">BetaUserProfileTrustGrant</a></code>
+
+Methods:
+
+- <code title="post /v1/user_profiles?beta=true">client.beta.userProfiles.<a href="./src/resources/beta/user-profiles.ts">create</a>({ ...params }) -> BetaUserProfile</code>
+- <code title="get /v1/user_profiles/{user_profile_id}?beta=true">client.beta.userProfiles.<a href="./src/resources/beta/user-profiles.ts">retrieve</a>(userProfileID, { ...params }) -> BetaUserProfile</code>
+- <code title="post /v1/user_profiles/{user_profile_id}?beta=true">client.beta.userProfiles.<a href="./src/resources/beta/user-profiles.ts">update</a>(userProfileID, { ...params }) -> BetaUserProfile</code>
+- <code title="get /v1/user_profiles?beta=true">client.beta.userProfiles.<a href="./src/resources/beta/user-profiles.ts">list</a>({ ...params }) -> BetaUserProfilesPageCursor</code>
+- <code title="post /v1/user_profiles/{user_profile_id}/enrollment_url?beta=true">client.beta.userProfiles.<a href="./src/resources/beta/user-profiles.ts">createEnrollmentURL</a>(userProfileID, { ...params }) -> BetaUserProfileEnrollmentURL</code>

scripts/detect-breaking-changes

@@ -26,6 +26,7 @@ TEST_PATHS=(
 	tests/api-resources/beta/files.test.ts
 	tests/api-resources/beta/skills/skills.test.ts
 	tests/api-resources/beta/skills/versions.test.ts
+	tests/api-resources/beta/user-profiles.test.ts
 	tests/index.test.ts
 )
 

src/resources/beta/agents/agents.ts

@@ -540,6 +540,7 @@ export interface BetaManagedAgentsMCPToolsetParams {
  * details and options.
  */
 export type BetaManagedAgentsModel =
+  | 'claude-opus-4-7'
   | 'claude-opus-4-6'
   | 'claude-sonnet-4-6'
   | 'claude-haiku-4-5'

src/resources/beta/beta.ts

@@ -48,6 +48,19 @@ import {
   ModelRetrieveParams,
   Models,
 } from './models';
+import * as UserProfilesAPI from './user-profiles';
+import {
+  BetaUserProfile,
+  BetaUserProfileEnrollmentURL,
+  BetaUserProfileTrustGrant,
+  BetaUserProfilesPageCursor,
+  UserProfileCreateEnrollmentURLParams,
+  UserProfileCreateParams,
+  UserProfileListParams,
+  UserProfileRetrieveParams,
+  UserProfileUpdateParams,
+  UserProfiles,
+} from './user-profiles';
 import * as AgentsAPI from './agents/agents';
 import {
   AgentArchiveParams,
@@ -238,6 +251,7 @@ import {
   BetaThinkingConfigParam,
   BetaThinkingDelta,
   BetaThinkingTurns,
+  BetaTokenTaskBudget,
   BetaTool,
   BetaToolBash20241022,
   BetaToolBash20250124,
@@ -352,6 +366,7 @@ export class Beta extends APIResource {
   vaults: VaultsAPI.Vaults = new VaultsAPI.Vaults(this._client);
   files: FilesAPI.Files = new FilesAPI.Files(this._client);
   skills: SkillsAPI.Skills = new SkillsAPI.Skills(this._client);
+  userProfiles: UserProfilesAPI.UserProfiles = new UserProfilesAPI.UserProfiles(this._client);
 }
 
 export type AnthropicBeta =
@@ -377,7 +392,8 @@ export type AnthropicBeta =
   | 'skills-2025-10-02'
   | 'fast-mode-2026-02-01'
   | 'output-300k-2026-03-24'
-  | 'advisor-tool-2026-03-01';
+  | 'advisor-tool-2026-03-01'
+  | 'user-profiles-2026-03-24';
 
 export interface BetaAPIError {
   message: string;
@@ -460,6 +476,7 @@ Beta.Sessions = Sessions;
 Beta.Vaults = Vaults;
 Beta.Files = Files;
 Beta.Skills = Skills;
+Beta.UserProfiles = UserProfiles;
 
 export declare namespace Beta {
   export {
@@ -644,6 +661,7 @@ export declare namespace Beta {
     type BetaThinkingConfigParam as BetaThinkingConfigParam,
     type BetaThinkingDelta as BetaThinkingDelta,
     type BetaThinkingTurns as BetaThinkingTurns,
+    type BetaTokenTaskBudget as BetaTokenTaskBudget,
     type BetaTool as BetaTool,
     type BetaToolBash20241022 as BetaToolBash20241022,
     type BetaToolBash20250124 as BetaToolBash20250124,
@@ -817,4 +835,17 @@ export declare namespace Beta {
     type SkillListParams as SkillListParams,
     type SkillDeleteParams as SkillDeleteParams,
   };
+
+  export {
+    UserProfiles as UserProfiles,
+    type BetaUserProfile as BetaUserProfile,
+    type BetaUserProfileEnrollmentURL as BetaUserProfileEnrollmentURL,
+    type BetaUserProfileTrustGrant as BetaUserProfileTrustGrant,
+    type BetaUserProfilesPageCursor as BetaUserProfilesPageCursor,
+    type UserProfileCreateParams as UserProfileCreateParams,
+    type UserProfileRetrieveParams as UserProfileRetrieveParams,
+    type UserProfileUpdateParams as UserProfileUpdateParams,
+    type UserProfileListParams as UserProfileListParams,
+    type UserProfileCreateEnrollmentURLParams as UserProfileCreateEnrollmentURLParams,
+  };
 }

src/resources/beta/index.ts

@@ -236,6 +236,7 @@ export {
   type BetaThinkingConfigParam,
   type BetaThinkingDelta,
   type BetaThinkingTurns,
+  type BetaTokenTaskBudget,
   type BetaTool,
   type BetaToolBash20241022,
   type BetaToolBash20250124,
@@ -345,6 +346,18 @@ export {
   type SkillDeleteParams,
   type SkillListResponsesPageCursor,
 } from './skills/index';
+export {
+  UserProfiles,
+  type BetaUserProfile,
+  type BetaUserProfileEnrollmentURL,
+  type BetaUserProfileTrustGrant,
+  type UserProfileCreateParams,
+  type UserProfileRetrieveParams,
+  type UserProfileUpdateParams,
+  type UserProfileListParams,
+  type UserProfileCreateEnrollmentURLParams,
+  type BetaUserProfilesPageCursor,
+} from './user-profiles';
 export {
   Vaults,
   type BetaManagedAgentsDeletedVault,

src/resources/beta/messages/batches.ts

@@ -750,6 +750,12 @@ export namespace BatchCreateParams {
        * other values will be rejected with a 400 error.
        */
       top_p?: number;
+
+      /**
+       * The user profile ID to attribute this request to. Use when acting on behalf of a
+       * party other than your organization.
+       */
+      user_profile_id?: string | null;
     }
   }
 }

src/resources/beta/messages/index.ts

@@ -170,6 +170,7 @@ export {
   type BetaThinkingConfigParam,
   type BetaThinkingDelta,
   type BetaThinkingTurns,
+  type BetaTokenTaskBudget,
   type BetaTool,
   type BetaToolBash20241022,
   type BetaToolBash20250124,

src/resources/beta/messages/messages.ts

@@ -62,7 +62,7 @@ const DEPRECATED_MODELS: {
   'claude-3-7-sonnet-20250219': 'February 19th, 2026',
 };
 
-const MODELS_TO_WARN_WITH_THINKING_ENABLED: Model[] = ['claude-opus-4-6'];
+const MODELS_TO_WARN_WITH_THINKING_ENABLED: Model[] = ['claude-mythos-preview', 'claude-opus-4-6'];
 
 export class Messages extends APIResource {
   batches: BatchesAPI.Batches = new BatchesAPI.Batches(this._client);
@@ -113,7 +113,7 @@ export class Messages extends APIResource {
     }
 
     if (
-      body.model in MODELS_TO_WARN_WITH_THINKING_ENABLED &&
+      MODELS_TO_WARN_WITH_THINKING_ENABLED.includes(body.model) &&
       body.thinking &&
       body.thinking.type === 'enabled'
     ) {
@@ -1025,6 +1025,11 @@ export interface BetaCompactionBlock {
    */
   content: string | null;
 
+  /**
+   * Opaque metadata from prior compaction, to be round-tripped verbatim
+   */
+  encrypted_content: string | null;
+
   type: 'compaction';
 }
 
@@ -1049,11 +1054,21 @@ export interface BetaCompactionBlockParam {
    * Create a cache control breakpoint at this content block.
    */
   cache_control?: BetaCacheControlEphemeral | null;
+
+  /**
+   * Opaque metadata from prior compaction, to be round-tripped verbatim
+   */
+  encrypted_content?: string | null;
 }
 
 export interface BetaCompactionContentBlockDelta {
   content: string | null;
 
+  /**
+   * Opaque metadata from prior compaction, to be round-tripped verbatim
+   */
+  encrypted_content: string | null;
+
   type: 'compaction_delta';
 }
 
@@ -1824,13 +1839,18 @@ export interface BetaOutputConfig {
   /**
    * All possible effort levels.
    */
-  effort?: 'low' | 'medium' | 'high' | 'max' | null;
+  effort?: 'low' | 'medium' | 'high' | 'xhigh' | 'max' | null;
 
   /**
    * A schema to specify Claude's output format in responses. See
    * [structured outputs](https://platform.claude.com/docs/en/build-with-claude/structured-outputs)
    */
   format?: BetaJSONOutputFormat | null;
+
+  /**
+   * User-configurable total token budget across contexts.
+   */
+  task_budget?: BetaTokenTaskBudget | null;
 }
 
 export interface BetaPlainTextSource {
@@ -2453,6 +2473,27 @@ export interface BetaThinkingTurns {
   value: number;
 }
 
+/**
+ * User-configurable total token budget across contexts.
+ */
+export interface BetaTokenTaskBudget {
+  /**
+   * Total token budget across all contexts in the session.
+   */
+  total: number;
+
+  /**
+   * The budget type. Currently only 'tokens' is supported.
+   */
+  type: 'tokens';
+
+  /**
+   * Remaining tokens in the budget. Use this to track usage across contexts when
+   * implementing compaction client-side. Defaults to total if not provided.
+   */
+  remaining?: number | null;
+}
+
 export interface BetaTool {
   /**
    * [JSON schema](https://json-schema.org/draft/2020-12) for this tool's input.
@@ -4008,6 +4049,12 @@ export interface MessageCreateParamsBase {
    */
   top_p?: number;
 
+  /**
+   * Body param: The user profile ID to attribute this request to. Use when acting on
+   * behalf of a party other than your organization.
+   */
+  user_profile_id?: string | null;
+
   /**
    * Header param: Optional header to specify the beta version(s) you want to use.
    */
@@ -4455,6 +4502,7 @@ export declare namespace Messages {
     type BetaThinkingConfigParam as BetaThinkingConfigParam,
     type BetaThinkingDelta as BetaThinkingDelta,
     type BetaThinkingTurns as BetaThinkingTurns,
+    type BetaTokenTaskBudget as BetaTokenTaskBudget,
     type BetaTool as BetaTool,
     type BetaToolBash20241022 as BetaToolBash20241022,
     type BetaToolBash20250124 as BetaToolBash20250124,