> ## Documentation Index
> Fetch the complete documentation index at: https://openrouter.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# API Changelog

> Changes to the OpenRouter API, generated from the OpenAPI specification on every release.

Entries on this page are generated automatically from [OpenAPI specification](/docs/api_reference/overview) diffs when releases ship. Breaking changes are reviewed by a human before publication. See [API Versioning](/docs/api_reference/versioning) for what counts as a breaking change and how deprecations are announced. Endpoint paths are shown relative to the API base URL (`https://openrouter.ai/api/v1`).

<Update label="October 9, 2026" tags={["API Keys","Breaking","End Users","Guardrails","Interns","Schemas"]} rss="12 breaking changes, 10 modified endpoints, 2 new response codes, 3 modified schemas.">
  ## Breaking changes

  * `CreateEndUserRequest`: maxLength `256` modified<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
    * No action required for existing consumers. The maximum end-user ID length increased from 256 to 512 characters.
    * Used by [`POST /end-users`](/docs/api/api-reference/end-users/register-an-end-user)
  * `CreateEndUserRequest`: pattern `^[^\p{Cc}]+$` modified<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
    * No action required for existing consumers. The pattern now permits control characters other than NUL.
    * Used by [`POST /end-users`](/docs/api/api-reference/end-users/register-an-end-user)
  * `EndUser`: maxLength `256` modified<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

      <Expandable title="4 endpoints using this schema">
        * [`GET /end-users`](/docs/api/api-reference/end-users/list-registered-end-users)
        * [`GET /end-users/{user}`](/docs/api/api-reference/end-users/get-a-registered-end-user)
        * [`PATCH /end-users/{user}`](/docs/api/api-reference/end-users/update-a-registered-end-user)
        * [`POST /end-users`](/docs/api/api-reference/end-users/register-an-end-user)
      </Expandable>
  * `EndUser`: pattern `^[^\p{Cc}]+$` modified<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

      <Expandable title="4 endpoints using this schema">
        * [`GET /end-users`](/docs/api/api-reference/end-users/list-registered-end-users)
        * [`GET /end-users/{user}`](/docs/api/api-reference/end-users/get-a-registered-end-user)
        * [`PATCH /end-users/{user}`](/docs/api/api-reference/end-users/update-a-registered-end-user)
        * [`POST /end-users`](/docs/api/api-reference/end-users/register-an-end-user)
      </Expandable>
  * [`GET /end-users`](/docs/api/api-reference/end-users/list-registered-end-users): maxLength `256` modified<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * [`GET /end-users`](/docs/api/api-reference/end-users/list-registered-end-users): pattern `^[^\p{Cc}]+$` modified<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * [`DELETE /end-users/{user}`](/docs/api/api-reference/end-users/deactivate-a-registered-end-user): maxLength `256` modified<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * [`DELETE /end-users/{user}`](/docs/api/api-reference/end-users/deactivate-a-registered-end-user): pattern `^[^\p{Cc}]+$` modified<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * [`GET /end-users/{user}`](/docs/api/api-reference/end-users/get-a-registered-end-user): maxLength `256` modified<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * [`GET /end-users/{user}`](/docs/api/api-reference/end-users/get-a-registered-end-user): pattern `^[^\p{Cc}]+$` modified<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * [`PATCH /end-users/{user}`](/docs/api/api-reference/end-users/update-a-registered-end-user): maxLength `256` modified<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * [`PATCH /end-users/{user}`](/docs/api/api-reference/end-users/update-a-registered-end-user): pattern `^[^\p{Cc}]+$` modified<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

  ## Modified endpoints

  * [`GET /end-users`](/docs/api/api-reference/end-users/list-registered-end-users): description updated
  * [`DELETE /end-users/{user}`](/docs/api/api-reference/end-users/deactivate-a-registered-end-user): description updated
  * [`GET /end-users/{user}`](/docs/api/api-reference/end-users/get-a-registered-end-user): description updated
  * [`PATCH /end-users/{user}`](/docs/api/api-reference/end-users/update-a-registered-end-user): description updated
  * [`PATCH /keys/{hash}`](/docs/api/api-reference/api-keys/update-an-api-key): description updated; request schema updated
  * [`POST /guardrails`](/docs/api/api-reference/guardrails/create-a-guardrail): description updated
  * [`PATCH /guardrails/{id}`](/docs/api/api-reference/guardrails/update-a-guardrail): description updated
  * [`POST /guardrails/{id}/assignments/keys`](/docs/api/api-reference/guardrails/bulk-assign-keys-to-a-guardrail): description updated
  * [`POST /interns`](/docs/api/api-reference/interns/create-an-intern): description updated
  * [`PATCH /keys/{hash}`](/docs/api/api-reference/api-keys/update-an-api-key): description updated

  ## New response codes

  * [`PATCH /keys/{hash}`](/docs/api/api-reference/api-keys/update-an-api-key): now returns `403`
  * [`PATCH /keys/{hash}`](/docs/api/api-reference/api-keys/update-an-api-key): now returns `409`

  ## Modified schemas

  * `CreateEndUserRequest`: description updated
    * Used by [`POST /end-users`](/docs/api/api-reference/end-users/register-an-end-user)
  * `EndUser`: description updated

      <Expandable title="4 endpoints using this schema">
        * [`GET /end-users`](/docs/api/api-reference/end-users/list-registered-end-users)
        * [`GET /end-users/{user}`](/docs/api/api-reference/end-users/get-a-registered-end-user)
        * [`PATCH /end-users/{user}`](/docs/api/api-reference/end-users/update-a-registered-end-user)
        * [`POST /end-users`](/docs/api/api-reference/end-users/register-an-end-user)
      </Expandable>
  * `AlignmentPlugin`: description updated

      <Expandable title="6 endpoints using this schema">
        * [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion)
        * [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
        * [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
        * [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
        * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body)
        * [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
      </Expandable>
</Update>

<Update label="October 8, 2026" tags={["API Keys","Interns","Schemas"]} rss="2 modified endpoints, 4 modified schemas.">
  ## Modified endpoints

  * [`GET /keys`](/docs/api/api-reference/api-keys/list-api-keys): new parameter `include_expired`
  * [`POST /interns`](/docs/api/api-reference/interns/create-an-intern): description updated; response schema updated

  ## Modified schemas

  * `PublicEndpoint`: description updated
    * Used by [`GET /endpoints/zdr`](/docs/api/api-reference/endpoints/preview-the-impact-of-zdr-on-the-available-endpoints), [`GET /models/{author}/{slug}/endpoints`](/docs/api/api-reference/endpoints/list-all-endpoints-for-a-model)
  * `JevRouterPlugin`: new property `cost_tier`

      <Expandable title="6 endpoints using this schema">
        * [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion)
        * [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
        * [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
        * [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
        * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body)
        * [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
      </Expandable>
  * `BulkAssignKeysRequest`: maxItems property\_added
    * Used by [`POST /guardrails/{id}/assignments/keys`](/docs/api/api-reference/guardrails/bulk-assign-keys-to-a-guardrail)
  * `BulkUnassignKeysRequest`: maxItems property\_added
    * Used by [`POST /guardrails/{id}/assignments/keys/remove`](/docs/api/api-reference/guardrails/bulk-unassign-keys-from-a-guardrail)
</Update>

<Update label="October 7, 2026" tags={["Interns","Schemas"]} rss="2 new endpoints, 5 new schemas, 10 modified schemas.">
  ## New endpoints

  * [`POST /interns/{internId}/daemon-access/sign`](/docs/api/api-reference/interns/sign-a-daemon-request-with-the-callers-identity-deprecated-alias): Sign a daemon request with the caller's identity (deprecated alias)
  * [`POST /interns/{internId}/daemon/sign`](/docs/api/api-reference/interns/sign-a-daemon-request-with-the-callers-identity): Sign a daemon request with the caller's identity

  ## New schemas

  * `ToolSearchCallItem`
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `ToolSearchOutputItem`
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `SignInternDaemonRequest`
    * Used by [`POST /interns/{internId}/daemon-access/sign`](/docs/api/api-reference/interns/sign-a-daemon-request-with-the-callers-identity-deprecated-alias), [`POST /interns/{internId}/daemon/sign`](/docs/api/api-reference/interns/sign-a-daemon-request-with-the-callers-identity)
  * `SignInternDaemonResponse`
    * Used by [`POST /interns/{internId}/daemon-access/sign`](/docs/api/api-reference/interns/sign-a-daemon-request-with-the-callers-identity-deprecated-alias), [`POST /interns/{internId}/daemon/sign`](/docs/api/api-reference/interns/sign-a-daemon-request-with-the-callers-identity)
  * `OutputToolSearchCallItem`
    * Used by [`GET /batches/{id}`](/docs/api/api-reference/batch/get-a-batch), [`POST /batches`](/docs/api/api-reference/batch/create-a-batch), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)

  ## Modified schemas

  * `OutputApplyPatchServerToolItem`: new property `error`; \$ref modified

      <Expandable title="4 endpoints using this schema">
        * [`GET /batches/{id}`](/docs/api/api-reference/batch/get-a-batch)
        * [`POST /batches`](/docs/api/api-reference/batch/create-a-batch)
        * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body)
        * [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
      </Expandable>
  * `OutputDatetimeItem`: new property `error`; \$ref modified

      <Expandable title="4 endpoints using this schema">
        * [`GET /batches/{id}`](/docs/api/api-reference/batch/get-a-batch)
        * [`POST /batches`](/docs/api/api-reference/batch/create-a-batch)
        * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body)
        * [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
      </Expandable>
  * `OutputImageGenerationServerToolItem`: new property `error`; \$ref modified

      <Expandable title="4 endpoints using this schema">
        * [`GET /batches/{id}`](/docs/api/api-reference/batch/get-a-batch)
        * [`POST /batches`](/docs/api/api-reference/batch/create-a-batch)
        * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body)
        * [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
      </Expandable>
  * `OutputSearchModelsServerToolItem`: new property `error`; \$ref modified

      <Expandable title="4 endpoints using this schema">
        * [`GET /batches/{id}`](/docs/api/api-reference/batch/get-a-batch)
        * [`POST /batches`](/docs/api/api-reference/batch/create-a-batch)
        * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body)
        * [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
      </Expandable>
  * `OutputToolSearchServerToolItem`: new property `error`; \$ref modified

      <Expandable title="4 endpoints using this schema">
        * [`GET /batches/{id}`](/docs/api/api-reference/batch/get-a-batch)
        * [`POST /batches`](/docs/api/api-reference/batch/create-a-batch)
        * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body)
        * [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
      </Expandable>
  * `OutputWebSearchServerToolItem`: new property `error`; \$ref modified

      <Expandable title="4 endpoints using this schema">
        * [`GET /batches/{id}`](/docs/api/api-reference/batch/get-a-batch)
        * [`POST /batches`](/docs/api/api-reference/batch/create-a-batch)
        * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body)
        * [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
      </Expandable>
  * `SwitchyardRouterPlugin`: description updated

      <Expandable title="6 endpoints using this schema">
        * [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion)
        * [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
        * [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
        * [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
        * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body)
        * [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
      </Expandable>
  * `MessagesStartEvent`: property `provider` updated
    * Used by [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
  * `ProviderResponse`: x-speakeasy-unknown-values object\_added
    * Used by [`GET /generation`](/docs/api/api-reference/generations/get-request-&-usage-metadata-for-a-generation)
  * `OutputItems`: new union variant added
    * Used by [`GET /batches/{id}`](/docs/api/api-reference/batch/get-a-batch), [`POST /batches`](/docs/api/api-reference/batch/create-a-batch), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
</Update>

<Update label="October 6, 2026" tags={["API Keys","BYOK","Breaking","Schemas"]} rss="5 breaking changes, 8 modified endpoints, 1 new response code, 2 new schemas, 9 modified schemas.">
  ## Breaking changes

  * `BYOKKey`: required `declared_region` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

    * **No action required for existing consumers.** Responses from BYOK endpoints now include `declared_region` (`"global"`, `"europe"`, `"us"`, or `null`) indicating the key's declared data region.

      <Expandable title="4 endpoints using this schema">
        - [`GET /byok`](/docs/api/api-reference/byok/list-byok-provider-credentials)
        - [`GET /byok/{id}`](/docs/api/api-reference/byok/get-a-byok-provider-credential)
        - [`PATCH /byok/{id}`](/docs/api/api-reference/byok/update-a-byok-provider-credential)
        - [`POST /byok`](/docs/api/api-reference/byok/create-a-byok-provider-credential)
      </Expandable>
  * [`GET /keys`](/docs/api/api-reference/api-keys/list-api-keys): required `last_used_at` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
    * No action required for existing consumers. API key responses now include `last_used_at`, an ISO 8601 UTC timestamp of the key's most recent recorded usage, or `null` if none has been recorded.
  * [`POST /keys`](/docs/api/api-reference/api-keys/create-a-new-api-key): required `last_used_at` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * [`GET /keys/{hash}`](/docs/api/api-reference/api-keys/get-a-single-api-key): required `last_used_at` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * [`PATCH /keys/{hash}`](/docs/api/api-reference/api-keys/update-an-api-key): required `last_used_at` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

  ## Modified endpoints

  * [`GET /byok`](/docs/api/api-reference/byok/list-byok-provider-credentials): response schema updated
  * [`POST /byok`](/docs/api/api-reference/byok/create-a-byok-provider-credential): response schema updated
  * [`GET /byok/{id}`](/docs/api/api-reference/byok/get-a-byok-provider-credential): response schema updated
  * [`PATCH /byok/{id}`](/docs/api/api-reference/byok/update-a-byok-provider-credential): response schema updated
  * [`GET /keys`](/docs/api/api-reference/api-keys/list-api-keys): response schema updated
  * [`POST /keys`](/docs/api/api-reference/api-keys/create-a-new-api-key): response schema updated
  * [`GET /keys/{hash}`](/docs/api/api-reference/api-keys/get-a-single-api-key): response schema updated
  * [`PATCH /keys/{hash}`](/docs/api/api-reference/api-keys/update-an-api-key): response schema updated

  ## New response codes

  * [`PATCH /byok/{id}`](/docs/api/api-reference/byok/update-a-byok-provider-credential): now returns `409`

  ## New schemas

  * `SpeechInput`
    * Used by [`POST /audio/speech`](/docs/api/api-reference/tts/create-speech)
  * `SpeechTurn`
    * Used by [`POST /audio/speech`](/docs/api/api-reference/tts/create-speech)

  ## Modified schemas

  * `BYOKKey`: example modified; new property `declared_region`

      <Expandable title="4 endpoints using this schema">
        * [`GET /byok`](/docs/api/api-reference/byok/list-byok-provider-credentials)
        * [`GET /byok/{id}`](/docs/api/api-reference/byok/get-a-byok-provider-credential)
        * [`PATCH /byok/{id}`](/docs/api/api-reference/byok/update-a-byok-provider-credential)
        * [`POST /byok`](/docs/api/api-reference/byok/create-a-byok-provider-credential)
      </Expandable>
  * `CreateBYOKKeyRequest`: new property `declared_region`
    * Used by [`POST /byok`](/docs/api/api-reference/byok/create-a-byok-provider-credential)
  * `CreateBYOKKeyResponse`: example modified
    * Used by [`POST /byok`](/docs/api/api-reference/byok/create-a-byok-provider-credential)
  * `GetBYOKKeyResponse`: example modified
    * Used by [`GET /byok/{id}`](/docs/api/api-reference/byok/get-a-byok-provider-credential)
  * `ListBYOKKeysResponse`: example modified
    * Used by [`GET /byok`](/docs/api/api-reference/byok/list-byok-provider-credentials)
  * `UpdateBYOKKeyRequest`: new property `declared_region`
    * Used by [`PATCH /byok/{id}`](/docs/api/api-reference/byok/update-a-byok-provider-credential)
  * `UpdateBYOKKeyResponse`: example modified
    * Used by [`PATCH /byok/{id}`](/docs/api/api-reference/byok/update-a-byok-provider-credential)
  * `SwitchyardRouterPlugin`: new property `judge_model`

      <Expandable title="6 endpoints using this schema">
        * [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion)
        * [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
        * [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
        * [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
        * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body)
        * [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
      </Expandable>
  * `SpeechRequest`: new property `instructions`; \$ref modified
    * Used by [`POST /audio/speech`](/docs/api/api-reference/tts/create-speech)
</Update>

<Update label="October 5, 2026" tags={["Schemas"]} rss="1 modified schema.">
  ## Modified schemas

  * `BatchProviderPreferences`: description updated; new property `allow_fallbacks`
    * Used by [`POST /batches`](/docs/api/api-reference/batch/create-a-batch)
</Update>

<Update label="October 2, 2026" tags={["Breaking","STT","Schemas"]} rss="1 breaking change, 1 modified endpoint, 4 modified schemas.">
  ## Breaking changes

  * spec: ^[a-z0-9\*](\[a-z0-9*-]\{0,61}\[a-z0-9*])?(.[a-z0-9\*](\[a-z0-9*-]\{0,61}\[a-z0-9*])?)\*\$ modified<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

  ## Modified endpoints

  * [`POST /audio/transcriptions`](/docs/api/api-reference/stt/create-transcription): description updated

  ## Modified schemas

  * `ObservabilityClickhouseDestination`: new property `shouldIncludeCacheWriteTokens`

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilitySnowflakeDestination`: new property `shouldIncludeCacheWriteTokens`

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `STTRequest`: description updated; new property `data_collection`; new property `zdr`
    * Used by [`POST /audio/transcriptions`](/docs/api/api-reference/stt/create-transcription)
  * `SpeechRequest`: description updated; new property `data_collection`; new property `zdr`
    * Used by [`POST /audio/speech`](/docs/api/api-reference/tts/create-speech)
</Update>

<Update label="October 1, 2026" tags={["API Keys","Analytics","Breaking","Generations","Schemas"]} rss="1 breaking change, 4 modified endpoints, 2 new response codes, 1 new schema, 4 modified schemas.">
  ## Breaking changes

  * `ActivityItem`: required `cached_tokens` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
    * Used by [`GET /activity`](/docs/api/api-reference/analytics/get-user-activity-grouped-by-endpoint)

  ## Modified endpoints

  * [`GET /generation`](/docs/api/api-reference/generations/get-request-&-usage-metadata-for-a-generation): parameter `id` updated
  * [`GET /generation/content`](/docs/api/api-reference/generations/get-stored-prompt-completion-and-error-content-for-a-generation): parameter `id` updated
  * [`GET /activity`](/docs/api/api-reference/analytics/get-user-activity-grouped-by-endpoint): response schema updated
  * [`PATCH /keys/{hash}`](/docs/api/api-reference/api-keys/update-an-api-key): description updated; response schema updated

  ## New response codes

  * [`GET /generation`](/docs/api/api-reference/generations/get-request-&-usage-metadata-for-a-generation): now returns `400`
  * [`GET /generation/content`](/docs/api/api-reference/generations/get-stored-prompt-completion-and-error-content-for-a-generation): now returns `400`

  ## New schemas

  * `ChatDynamicServerTool`
    * Used by [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion), [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)

  ## Modified schemas

  * `ChatFunctionTool`: new union variant added
    * Used by [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion), [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
  * `ActivityItem`: example modified; new property `cached_tokens`
    * Used by [`GET /activity`](/docs/api/api-reference/analytics/get-user-activity-grouped-by-endpoint)
  * `ActivityResponse`: example modified
    * Used by [`GET /activity`](/docs/api/api-reference/analytics/get-user-activity-grouped-by-endpoint)
  * `ImageGenerationRequest`: enum property\_added
    * Used by [`POST /images`](/docs/api/api-reference/images/generate-an-image)
</Update>

<Update label="September 30, 2026" tags={["Containers","End Users","Organization","Schemas"]} rss="7 new endpoints, 1 modified endpoint, 22 new schemas, 4 modified schemas.">
  ## New endpoints

  * [`GET /end-users`](/docs/api/api-reference/end-users/list-registered-end-users): List registered end users
  * [`POST /end-users`](/docs/api/api-reference/end-users/register-an-end-user): Register an end user
  * [`GET /end-users/{user}`](/docs/api/api-reference/end-users/get-a-registered-end-user): Get a registered end user
  * [`PATCH /end-users/{user}`](/docs/api/api-reference/end-users/update-a-registered-end-user): Update a registered end user
  * [`DELETE /end-users/{user}`](/docs/api/api-reference/end-users/deactivate-a-registered-end-user): Deactivate a registered end user
  * [`GET /organization/settings`](/docs/api/api-reference/organization/get-organization-settings): Get organization settings
  * [`PATCH /organization/settings`](/docs/api/api-reference/organization/update-organization-settings): Update organization settings

  ## Modified endpoints

  * [`GET /containers/{container_id}/files`](/docs/api/api-reference/containers/list-container-files): description updated

  ## New schemas

  * `Alignment`
    * Used by [`GET /batches/{id}`](/docs/api/api-reference/batch/get-a-batch), [`POST /batches`](/docs/api/api-reference/batch/create-a-batch), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `AlignmentAllowedCallRecord`
    * Used by [`GET /batches/{id}`](/docs/api/api-reference/batch/get-a-batch), [`POST /batches`](/docs/api/api-reference/batch/create-a-batch), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `AlignmentBlockedCallRecord`
    * Used by [`GET /batches/{id}`](/docs/api/api-reference/batch/get-a-batch), [`POST /batches`](/docs/api/api-reference/batch/create-a-batch), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `AlignmentCallRecord`
    * Used by [`GET /batches/{id}`](/docs/api/api-reference/batch/get-a-batch), [`POST /batches`](/docs/api/api-reference/batch/create-a-batch), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `AlignmentChatAudio`
    * Used by [`GET /batches/{id}`](/docs/api/api-reference/batch/get-a-batch), [`POST /batches`](/docs/api/api-reference/batch/create-a-batch), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `AlignmentChatImage`
    * Used by [`GET /batches/{id}`](/docs/api/api-reference/batch/get-a-batch), [`POST /batches`](/docs/api/api-reference/batch/create-a-batch), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `AlignmentChatRejected`
    * Used by [`GET /batches/{id}`](/docs/api/api-reference/batch/get-a-batch), [`POST /batches`](/docs/api/api-reference/batch/create-a-batch), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `AlignmentChatToolCall`
    * Used by [`GET /batches/{id}`](/docs/api/api-reference/batch/get-a-batch), [`POST /batches`](/docs/api/api-reference/batch/create-a-batch), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `AlignmentPlugin`

      <Expandable title="6 endpoints using this schema">
        * [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion)
        * [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
        * [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
        * [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
        * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body)
        * [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
      </Expandable>
  * `AlignmentRejected`
    * Used by [`GET /batches/{id}`](/docs/api/api-reference/batch/get-a-batch), [`POST /batches`](/docs/api/api-reference/batch/create-a-batch), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `AlignmentResponsesRejected`
    * Used by [`GET /batches/{id}`](/docs/api/api-reference/batch/get-a-batch), [`POST /batches`](/docs/api/api-reference/batch/create-a-batch), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `AlignmentRuleRecord`
    * Used by [`GET /batches/{id}`](/docs/api/api-reference/batch/get-a-batch), [`POST /batches`](/docs/api/api-reference/batch/create-a-batch), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `AlignmentUnavailableCallRecord`
    * Used by [`GET /batches/{id}`](/docs/api/api-reference/batch/get-a-batch), [`POST /batches`](/docs/api/api-reference/batch/create-a-batch), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `OpenResponsesErrorField`
    * Used by [`GET /batches/{id}`](/docs/api/api-reference/batch/get-a-batch), [`POST /batches`](/docs/api/api-reference/batch/create-a-batch), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `OpenResponsesErrorMetadata`
    * Used by [`GET /batches/{id}`](/docs/api/api-reference/batch/get-a-batch), [`POST /batches`](/docs/api/api-reference/batch/create-a-batch), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `CreateEndUserRequest`
    * Used by [`POST /end-users`](/docs/api/api-reference/end-users/register-an-end-user)
  * `EndUser`

      <Expandable title="4 endpoints using this schema">
        * [`GET /end-users`](/docs/api/api-reference/end-users/list-registered-end-users)
        * [`GET /end-users/{user}`](/docs/api/api-reference/end-users/get-a-registered-end-user)
        * [`PATCH /end-users/{user}`](/docs/api/api-reference/end-users/update-a-registered-end-user)
        * [`POST /end-users`](/docs/api/api-reference/end-users/register-an-end-user)
      </Expandable>
  * `EndUserResponse`
    * Used by [`GET /end-users/{user}`](/docs/api/api-reference/end-users/get-a-registered-end-user), [`PATCH /end-users/{user}`](/docs/api/api-reference/end-users/update-a-registered-end-user), [`POST /end-users`](/docs/api/api-reference/end-users/register-an-end-user)
  * `ListEndUsersResponse`
    * Used by [`GET /end-users`](/docs/api/api-reference/end-users/list-registered-end-users)
  * `UpdateEndUserRequest`
    * Used by [`PATCH /end-users/{user}`](/docs/api/api-reference/end-users/update-a-registered-end-user)
  * `OrganizationSettings`
    * Used by [`GET /organization/settings`](/docs/api/api-reference/organization/get-organization-settings), [`PATCH /organization/settings`](/docs/api/api-reference/organization/update-organization-settings)
  * `UpdateOrganizationSettingsRequest`
    * Used by [`PATCH /organization/settings`](/docs/api/api-reference/organization/update-organization-settings)

  ## Modified schemas

  * `ChatRequest`: new union variant added
    * Used by [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion), [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
  * `MessagesRequest`: new union variant added
    * Used by [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message), [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
  * `ResponsesRequest`: new union variant added
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `SwitchyardRouterPlugin`: description updated

      <Expandable title="6 endpoints using this schema">
        * [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion)
        * [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
        * [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
        * [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
        * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body)
        * [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
      </Expandable>
</Update>

<Update label="September 29, 2026" tags={["BYOK","Batch","Breaking","Interns","STT","Schemas","Tools","Vault"]} rss="6 breaking changes, 3 new endpoints, 18 modified endpoints, 1 new response code, 17 new schemas, 19 modified schemas.">
  ## Breaking changes

  * `JevRouterPlugin`: additionalProperties `false` object added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

      <Expandable title="6 endpoints using this schema">
        * [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion)
        * [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
        * [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
        * [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
        * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body)
        * [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
      </Expandable>
  * `STTInputAudio`: properties `data` object removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
    * Used by [`POST /audio/transcriptions`](/docs/api/api-reference/stt/create-transcription)
  * `STTInputAudio`: properties `format` object removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
    * Used by [`POST /audio/transcriptions`](/docs/api/api-reference/stt/create-transcription)
  * `STTInputAudio`: required `data` property removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
    * Used by [`POST /audio/transcriptions`](/docs/api/api-reference/stt/create-transcription)
  * `STTInputAudio`: required `format` property removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
    * Used by [`POST /audio/transcriptions`](/docs/api/api-reference/stt/create-transcription)
  * [`POST /audio/transcriptions`](/docs/api/api-reference/stt/create-transcription): required `file` property removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

  ## New endpoints

  * [`GET /vault/interns/{internId}/effective-secrets`](/docs/api/api-reference/vault/list-the-secrets-an-intern-receives): List the secrets an intern receives
  * [`GET /tools`](/docs/api/api-reference/tools/list-server-tools): List server tools
  * [`GET /tools/{name}`](/docs/api/api-reference/tools/get-a-server-tool): Get a server tool

  ## Modified endpoints

  * [`GET /interns`](/docs/api/api-reference/interns/list-interns): description updated
  * [`POST /interns`](/docs/api/api-reference/interns/create-an-intern): description updated
  * [`DELETE /interns/{internId}`](/docs/api/api-reference/interns/delete-an-intern): description updated
  * [`GET /interns/{internId}`](/docs/api/api-reference/interns/get-an-intern): description updated
  * [`PATCH /interns/{internId}`](/docs/api/api-reference/interns/update-an-intern): description updated
  * [`GET /interns/{internId}/daemon`](/docs/api/api-reference/interns/get-an-interns-daemon-access): description updated
  * [`GET /interns/{internId}/daemon-access`](/docs/api/api-reference/interns/get-an-interns-daemon-access-deprecated-alias): description updated
  * [`POST /interns/{internId}/provision`](/docs/api/api-reference/interns/provision-an-intern): description updated
  * [`POST /interns/{internId}/suspend`](/docs/api/api-reference/interns/suspend-an-intern): description updated
  * [`GET /vault/interns/{internId}/secrets`](/docs/api/api-reference/vault/list-intern-secrets): description updated
  * [`POST /vault/interns/{internId}/secrets/copy`](/docs/api/api-reference/vault/copy-workspace-secrets-to-an-intern): description updated
  * [`DELETE /vault/interns/{internId}/secrets/{name}`](/docs/api/api-reference/vault/delete-an-intern-secret): description updated
  * [`PUT /vault/interns/{internId}/secrets/{name}`](/docs/api/api-reference/vault/store-an-intern-secret): description updated
  * [`GET /vault/secrets`](/docs/api/api-reference/vault/list-workspace-secrets): description updated
  * [`DELETE /vault/secrets/{name}`](/docs/api/api-reference/vault/delete-a-workspace-secret): description updated
  * [`PUT /vault/secrets/{name}`](/docs/api/api-reference/vault/store-a-workspace-secret): description updated
  * [`POST /audio/transcriptions`](/docs/api/api-reference/stt/create-transcription): description updated; request schema updated
  * [`GET /byok`](/docs/api/api-reference/byok/list-byok-provider-credentials): parameter `provider` updated

  ## New response codes

  * [`GET /batches/{id}`](/docs/api/api-reference/batch/get-a-batch): now returns `410`

  ## New schemas

  * `VaultEffectiveSecret`
    * Used by [`GET /vault/interns/{internId}/effective-secrets`](/docs/api/api-reference/vault/list-the-secrets-an-intern-receives)
  * `VaultEffectiveSecretListResponse`
    * Used by [`GET /vault/interns/{internId}/effective-secrets`](/docs/api/api-reference/vault/list-the-secrets-an-intern-receives)
  * `JevRouterPlugin`

      <Expandable title="6 endpoints using this schema">
        * [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion)
        * [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
        * [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
        * [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
        * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body)
        * [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
      </Expandable>
  * `STTEntity`
    * Used by [`POST /audio/transcriptions`](/docs/api/api-reference/stt/create-transcription)
  * `STTInlineInputAudio`
    * Used by [`POST /audio/transcriptions`](/docs/api/api-reference/stt/create-transcription)
  * `STTUrlInputAudio`
    * Used by [`POST /audio/transcriptions`](/docs/api/api-reference/stt/create-transcription)
  * `GetToolResponse`
    * Used by [`GET /tools/{name}`](/docs/api/api-reference/tools/get-a-server-tool)
  * `ListToolsResponse`
    * Used by [`GET /tools`](/docs/api/api-reference/tools/list-server-tools)
  * `ServerTool`
    * Used by [`GET /tools`](/docs/api/api-reference/tools/list-server-tools), [`GET /tools/{name}`](/docs/api/api-reference/tools/get-a-server-tool)
  * `ServerToolDetails`
    * Used by [`GET /tools/{name}`](/docs/api/api-reference/tools/get-a-server-tool)
  * `ServerToolEngine`
    * Used by [`GET /tools`](/docs/api/api-reference/tools/list-server-tools), [`GET /tools/{name}`](/docs/api/api-reference/tools/get-a-server-tool)
  * `ServerToolExecutedBy`
    * Used by [`GET /tools`](/docs/api/api-reference/tools/list-server-tools), [`GET /tools/{name}`](/docs/api/api-reference/tools/get-a-server-tool)
  * `ServerToolInputName`
    * Used by [`GET /tools`](/docs/api/api-reference/tools/list-server-tools), [`GET /tools/{name}`](/docs/api/api-reference/tools/get-a-server-tool)
  * `ServerToolNativeModel`
    * Used by [`GET /tools/{name}`](/docs/api/api-reference/tools/get-a-server-tool)
  * `ServerToolNativeSupport`
    * Used by [`GET /tools`](/docs/api/api-reference/tools/list-server-tools), [`GET /tools/{name}`](/docs/api/api-reference/tools/get-a-server-tool)
  * `ServerToolOutputName`
    * Used by [`GET /tools`](/docs/api/api-reference/tools/list-server-tools), [`GET /tools/{name}`](/docs/api/api-reference/tools/get-a-server-tool)
  * `ServerToolPrice`
    * Used by [`GET /tools`](/docs/api/api-reference/tools/list-server-tools), [`GET /tools/{name}`](/docs/api/api-reference/tools/get-a-server-tool)

  ## Modified schemas

  * `OutputFusionServerToolItem`: description updated

      <Expandable title="4 endpoints using this schema">
        * [`GET /batches/{id}`](/docs/api/api-reference/batch/get-a-batch)
        * [`POST /batches`](/docs/api/api-reference/batch/create-a-batch)
        * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body)
        * [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
      </Expandable>
  * `ChatRequest`: new union variant added
    * Used by [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion), [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
  * `MessagesRequest`: new union variant added
    * Used by [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message), [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
  * `ResponsesRequest`: new union variant added
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `JevRouterPlugin`: new property `allowed_models`; description updated

      <Expandable title="6 endpoints using this schema">
        * [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion)
        * [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
        * [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
        * [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
        * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body)
        * [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
      </Expandable>
  * `BYOKProviderSlug`: enum property\_added

      <Expandable title="4 endpoints using this schema">
        * [`GET /byok`](/docs/api/api-reference/byok/list-byok-provider-credentials)
        * [`GET /byok/{id}`](/docs/api/api-reference/byok/get-a-byok-provider-credential)
        * [`PATCH /byok/{id}`](/docs/api/api-reference/byok/update-a-byok-provider-credential)
        * [`POST /byok`](/docs/api/api-reference/byok/create-a-byok-provider-credential)
      </Expandable>
  * `MessagesStartEvent`: property `provider` updated
    * Used by [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
  * `ProviderName`: enum property\_added

      <Expandable title="14 endpoints using this schema">
        * [`GET /endpoints/zdr`](/docs/api/api-reference/endpoints/preview-the-impact-of-zdr-on-the-available-endpoints)
        * [`GET /models/{author}/{slug}/endpoints`](/docs/api/api-reference/endpoints/list-all-endpoints-for-a-model)
        * [`POST /api/alpha/decisions`](/docs/api/api-reference/alphadecisions/submit-a-decisions-request)
        * [`POST /batches`](/docs/api/api-reference/batch/create-a-batch)
        * [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion)
        * [`POST /embeddings`](/docs/api/api-reference/embeddings/submit-an-embedding-request)
        * [`POST /images`](/docs/api/api-reference/images/generate-an-image)
        * [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
        * [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
        * [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
        * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body)
        * [`POST /rerank`](/docs/api/api-reference/rerank/submit-a-rerank-request)
        * [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
        * [`POST /systemone`](/docs/api/api-reference/systemone/submit-a-system-one-request)
      </Expandable>
  * `ProviderOptions`: new property `elevenlabs`

      <Expandable title="14 endpoints using this schema">
        * [`POST /api/alpha/decisions`](/docs/api/api-reference/alphadecisions/submit-a-decisions-request)
        * [`POST /audio/speech`](/docs/api/api-reference/tts/create-speech)
        * [`POST /audio/transcriptions`](/docs/api/api-reference/stt/create-transcription)
        * [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion)
        * [`POST /embeddings`](/docs/api/api-reference/embeddings/submit-an-embedding-request)
        * [`POST /images`](/docs/api/api-reference/images/generate-an-image)
        * [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
        * [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
        * [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
        * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body)
        * [`POST /rerank`](/docs/api/api-reference/rerank/submit-a-rerank-request)
        * [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
        * [`POST /systemone`](/docs/api/api-reference/systemone/submit-a-system-one-request)
        * [`POST /videos`](/docs/api/api-reference/video-generation/submit-a-video-generation-request)
      </Expandable>
  * `ProviderResponse`: enum property\_added
    * Used by [`GET /generation`](/docs/api/api-reference/generations/get-request-&-usage-metadata-for-a-generation)
  * `STTInputAudio`:
    * new union variant added
    * description updated
    * example property\_removed
    * type property\_removed
    * Used by [`POST /audio/transcriptions`](/docs/api/api-reference/stt/create-transcription)
  * `STTRequest`: description updated; new property `diarize`; new property `keyterms`
    * Used by [`POST /audio/transcriptions`](/docs/api/api-reference/stt/create-transcription)
  * `STTResponse`: new property `entities`; new property `language_confidence`
    * Used by [`POST /audio/transcriptions`](/docs/api/api-reference/stt/create-transcription)
  * `STTSegment`: new property `channel`; new property `speaker_label`
    * Used by [`POST /audio/transcriptions`](/docs/api/api-reference/stt/create-transcription)
  * `STTWord`:
    * new property `channel`
    * new property `speaker_label`
    * new property `type`
    * description updated
    * Used by [`POST /audio/transcriptions`](/docs/api/api-reference/stt/create-transcription)
  * `ChatRequest`: description updated; enum property\_added
    * Used by [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion), [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
  * `ResponsesRequest`: description updated; enum property\_added
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `ServiceTier`: enum property\_added
    * Used by [`GET /batches/{id}`](/docs/api/api-reference/batch/get-a-batch), [`POST /batches`](/docs/api/api-reference/batch/create-a-batch), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `SpeechRequest`: description updated
    * Used by [`POST /audio/speech`](/docs/api/api-reference/tts/create-speech)
</Update>

<Update label="September 28, 2026" tags={["Breaking","Endpoints","Interns","Private Endpoints","Schemas"]} rss="1 breaking change, 11 new endpoints, 3 modified endpoints, 21 new schemas, 3 modified schemas.">
  ## Breaking changes

  * `PublicEndpoint`: required `native_tools` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
    * Used by [`GET /endpoints/zdr`](/docs/api/api-reference/endpoints/preview-the-impact-of-zdr-on-the-available-endpoints), [`GET /models/{author}/{slug}/endpoints`](/docs/api/api-reference/endpoints/list-all-endpoints-for-a-model)

  ## New endpoints

  * [`GET /interns/{internId}/daemon`](/docs/api/api-reference/interns/get-an-interns-daemon-access): Get an intern's daemon access
  * [`GET /private-endpoints`](/docs/api/api-reference/private-endpoints/list-private-endpoints): List private endpoints
  * [`POST /private-endpoints`](/docs/api/api-reference/private-endpoints/create-a-private-endpoint): Create a private endpoint
  * [`GET /private-endpoints/{id}`](/docs/api/api-reference/private-endpoints/get-a-private-endpoint): Get a private endpoint
  * [`PATCH /private-endpoints/{id}`](/docs/api/api-reference/private-endpoints/update-a-draft-private-endpoint): Update a draft private endpoint
  * [`DELETE /private-endpoints/{id}`](/docs/api/api-reference/private-endpoints/delete-a-private-endpoint): Delete a private endpoint
  * [`POST /private-endpoints/{id}/activate`](/docs/api/api-reference/private-endpoints/activate-a-validated-private-endpoint): Activate a validated private endpoint
  * [`POST /private-endpoints/{id}/disable`](/docs/api/api-reference/private-endpoints/disable-a-private-endpoint): Disable a private endpoint
  * [`POST /private-endpoints/{id}/enable`](/docs/api/api-reference/private-endpoints/enable-a-private-endpoint): Enable a private endpoint
  * [`PUT /private-endpoints/{id}/pricing`](/docs/api/api-reference/private-endpoints/set-private-endpoint-pricing): Set private endpoint pricing
  * [`POST /private-endpoints/{id}/validate`](/docs/api/api-reference/private-endpoints/validate-a-draft-private-endpoint): Validate a draft private endpoint

  ## Modified endpoints

  * [`GET /endpoints/zdr`](/docs/api/api-reference/endpoints/preview-the-impact-of-zdr-on-the-available-endpoints): response schema updated
  * [`GET /models/{author}/{slug}/endpoints`](/docs/api/api-reference/endpoints/list-all-endpoints-for-a-model): response schema updated
  * [`GET /interns/{internId}/daemon-access`](/docs/api/api-reference/interns/get-an-interns-daemon-access-deprecated-alias): deprecated property\_added; description updated

  ## New schemas

  * `CreatePrivateEndpointRequest`
    * Used by [`POST /private-endpoints`](/docs/api/api-reference/private-endpoints/create-a-private-endpoint)
  * `CreatePrivateEndpointValidationFailedResponse`
    * Used by [`POST /private-endpoints`](/docs/api/api-reference/private-endpoints/create-a-private-endpoint)
  * `DeletePrivateEndpointResponse`
    * Used by [`DELETE /private-endpoints/{id}`](/docs/api/api-reference/private-endpoints/delete-a-private-endpoint)
  * `ListPrivateEndpointsResponse`
    * Used by [`GET /private-endpoints`](/docs/api/api-reference/private-endpoints/list-private-endpoints)
  * `ManagedPrivateEndpoint`

      <Expandable title="4 endpoints using this schema">
        * [`POST /private-endpoints`](/docs/api/api-reference/private-endpoints/create-a-private-endpoint)
        * [`POST /private-endpoints/{id}/activate`](/docs/api/api-reference/private-endpoints/activate-a-validated-private-endpoint)
        * [`POST /private-endpoints/{id}/disable`](/docs/api/api-reference/private-endpoints/disable-a-private-endpoint)
        * [`POST /private-endpoints/{id}/enable`](/docs/api/api-reference/private-endpoints/enable-a-private-endpoint)
      </Expandable>
  * `ManagedPrivateEndpointResponse`

      <Expandable title="4 endpoints using this schema">
        * [`POST /private-endpoints`](/docs/api/api-reference/private-endpoints/create-a-private-endpoint)
        * [`POST /private-endpoints/{id}/activate`](/docs/api/api-reference/private-endpoints/activate-a-validated-private-endpoint)
        * [`POST /private-endpoints/{id}/disable`](/docs/api/api-reference/private-endpoints/disable-a-private-endpoint)
        * [`POST /private-endpoints/{id}/enable`](/docs/api/api-reference/private-endpoints/enable-a-private-endpoint)
      </Expandable>
  * `PrivateEndpoint`
    * Used by [`GET /private-endpoints/{id}`](/docs/api/api-reference/private-endpoints/get-a-private-endpoint), [`PATCH /private-endpoints/{id}`](/docs/api/api-reference/private-endpoints/update-a-draft-private-endpoint), [`PUT /private-endpoints/{id}/pricing`](/docs/api/api-reference/private-endpoints/set-private-endpoint-pricing)
  * `PrivateEndpointActivation`
    * Used by [`POST /private-endpoints`](/docs/api/api-reference/private-endpoints/create-a-private-endpoint)
  * `PrivateEndpointCheck`
    * Used by [`POST /private-endpoints`](/docs/api/api-reference/private-endpoints/create-a-private-endpoint), [`POST /private-endpoints/{id}/validate`](/docs/api/api-reference/private-endpoints/validate-a-draft-private-endpoint)
  * `PrivateEndpointCheckReason`
    * Used by [`POST /private-endpoints`](/docs/api/api-reference/private-endpoints/create-a-private-endpoint), [`POST /private-endpoints/{id}/validate`](/docs/api/api-reference/private-endpoints/validate-a-draft-private-endpoint)
  * `PrivateEndpointDeclaredRegion`

      <Expandable title="7 endpoints using this schema">
        * [`GET /private-endpoints/{id}`](/docs/api/api-reference/private-endpoints/get-a-private-endpoint)
        * [`PATCH /private-endpoints/{id}`](/docs/api/api-reference/private-endpoints/update-a-draft-private-endpoint)
        * [`POST /private-endpoints`](/docs/api/api-reference/private-endpoints/create-a-private-endpoint)
        * [`POST /private-endpoints/{id}/activate`](/docs/api/api-reference/private-endpoints/activate-a-validated-private-endpoint)
        * [`POST /private-endpoints/{id}/disable`](/docs/api/api-reference/private-endpoints/disable-a-private-endpoint)
        * [`POST /private-endpoints/{id}/enable`](/docs/api/api-reference/private-endpoints/enable-a-private-endpoint)
        * [`PUT /private-endpoints/{id}/pricing`](/docs/api/api-reference/private-endpoints/set-private-endpoint-pricing)
      </Expandable>
  * `PrivateEndpointPricing`

      <Expandable title="4 endpoints using this schema">
        * [`GET /private-endpoints/{id}`](/docs/api/api-reference/private-endpoints/get-a-private-endpoint)
        * [`PATCH /private-endpoints/{id}`](/docs/api/api-reference/private-endpoints/update-a-draft-private-endpoint)
        * [`POST /private-endpoints`](/docs/api/api-reference/private-endpoints/create-a-private-endpoint)
        * [`PUT /private-endpoints/{id}/pricing`](/docs/api/api-reference/private-endpoints/set-private-endpoint-pricing)
      </Expandable>
  * `PrivateEndpointResponse`
    * Used by [`GET /private-endpoints/{id}`](/docs/api/api-reference/private-endpoints/get-a-private-endpoint), [`PATCH /private-endpoints/{id}`](/docs/api/api-reference/private-endpoints/update-a-draft-private-endpoint), [`PUT /private-endpoints/{id}/pricing`](/docs/api/api-reference/private-endpoints/set-private-endpoint-pricing)
  * `PrivateEndpointStatus`

      <Expandable title="8 endpoints using this schema">
        * [`GET /private-endpoints`](/docs/api/api-reference/private-endpoints/list-private-endpoints)
        * [`GET /private-endpoints/{id}`](/docs/api/api-reference/private-endpoints/get-a-private-endpoint)
        * [`PATCH /private-endpoints/{id}`](/docs/api/api-reference/private-endpoints/update-a-draft-private-endpoint)
        * [`POST /private-endpoints`](/docs/api/api-reference/private-endpoints/create-a-private-endpoint)
        * [`POST /private-endpoints/{id}/activate`](/docs/api/api-reference/private-endpoints/activate-a-validated-private-endpoint)
        * [`POST /private-endpoints/{id}/disable`](/docs/api/api-reference/private-endpoints/disable-a-private-endpoint)
        * [`POST /private-endpoints/{id}/enable`](/docs/api/api-reference/private-endpoints/enable-a-private-endpoint)
        * [`PUT /private-endpoints/{id}/pricing`](/docs/api/api-reference/private-endpoints/set-private-endpoint-pricing)
      </Expandable>
  * `PrivateEndpointSummary`

      <Expandable title="5 endpoints using this schema">
        * [`GET /private-endpoints`](/docs/api/api-reference/private-endpoints/list-private-endpoints)
        * [`POST /private-endpoints`](/docs/api/api-reference/private-endpoints/create-a-private-endpoint)
        * [`POST /private-endpoints/{id}/activate`](/docs/api/api-reference/private-endpoints/activate-a-validated-private-endpoint)
        * [`POST /private-endpoints/{id}/disable`](/docs/api/api-reference/private-endpoints/disable-a-private-endpoint)
        * [`POST /private-endpoints/{id}/enable`](/docs/api/api-reference/private-endpoints/enable-a-private-endpoint)
      </Expandable>
  * `PrivateEndpointValidation`
    * Used by [`POST /private-endpoints/{id}/validate`](/docs/api/api-reference/private-endpoints/validate-a-draft-private-endpoint)
  * `PrivateEndpointValidationNullable`
    * Used by [`POST /private-endpoints`](/docs/api/api-reference/private-endpoints/create-a-private-endpoint)
  * `PrivateEndpointValidationResponse`
    * Used by [`POST /private-endpoints/{id}/validate`](/docs/api/api-reference/private-endpoints/validate-a-draft-private-endpoint)
  * `UpdatePrivateEndpointPricingRequest`
    * Used by [`PUT /private-endpoints/{id}/pricing`](/docs/api/api-reference/private-endpoints/set-private-endpoint-pricing)
  * `UpdatePrivateEndpointRequest`
    * Used by [`PATCH /private-endpoints/{id}`](/docs/api/api-reference/private-endpoints/update-a-draft-private-endpoint)
  * `ValidatePrivateEndpointRequest`
    * Used by [`POST /private-endpoints/{id}/validate`](/docs/api/api-reference/private-endpoints/validate-a-draft-private-endpoint)

  ## Modified schemas

  * `AnthropicWebFetchToolResultError`: enum property\_added
    * Used by [`GET /batches/{id}`](/docs/api/api-reference/batch/get-a-batch), [`POST /batches`](/docs/api/api-reference/batch/create-a-batch), [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
  * `PublicEndpoint`: example modified; new property `native_tools`
    * Used by [`GET /endpoints/zdr`](/docs/api/api-reference/endpoints/preview-the-impact-of-zdr-on-the-available-endpoints), [`GET /models/{author}/{slug}/endpoints`](/docs/api/api-reference/endpoints/list-all-endpoints-for-a-model)
  * `MessagesRequest`: new union variant added
    * Used by [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message), [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
</Update>

<Update label="September 27, 2026" tags={["Embeddings"]} rss="1 new response code.">
  ## New response codes

  * [`POST /embeddings`](/docs/api/api-reference/embeddings/submit-an-embedding-request): now returns `504`
</Update>

<Update label="September 25, 2026" tags={["BYOK","Batch","Breaking","Endpoints","Interns","Schemas","TTS"]} rss="2 breaking changes, 4 new endpoints, 4 modified endpoints, 15 new schemas, 12 modified schemas.">
  ## Breaking changes

  * [`GET /interns/{internId}/daemon-access`](/docs/api/api-reference/interns/get-an-interns-daemon-access): codes `429` object removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * `SpeechInputReferenceAudioInput`: required `data` property removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
    * Used by [`POST /audio/speech`](/docs/api/api-reference/tts/create-speech)

  ## New endpoints

  * [`GET /batches`](/docs/api/api-reference/batch/list-batches): List batches
  * [`POST /batches`](/docs/api/api-reference/batch/create-a-batch): Create a batch
  * [`GET /batches/{id}`](/docs/api/api-reference/batch/get-a-batch): Get a batch
  * [`DELETE /batches/{id}`](/docs/api/api-reference/batch/delete-a-batch): Delete a batch

  ## Modified endpoints

  * [`GET /interns/{internId}/daemon-access`](/docs/api/api-reference/interns/get-an-interns-daemon-access): description updated
  * [`POST /audio/speech`](/docs/api/api-reference/tts/create-speech): description updated
  * [`GET /endpoints/zdr`](/docs/api/api-reference/endpoints/preview-the-impact-of-zdr-on-the-available-endpoints): response schema updated
  * [`GET /byok`](/docs/api/api-reference/byok/list-byok-provider-credentials): parameter `provider` updated

  ## New schemas

  * `SpeechInputReferenceImage`
    * Used by [`POST /audio/speech`](/docs/api/api-reference/tts/create-speech)
  * `SpeechInputReferenceImageInput`
    * Used by [`POST /audio/speech`](/docs/api/api-reference/tts/create-speech)
  * `BatchDeletedObject`
    * Used by [`DELETE /batches/{id}`](/docs/api/api-reference/batch/delete-a-batch)
  * `BatchDeletionOutcome`
    * Used by [`DELETE /batches/{id}`](/docs/api/api-reference/batch/delete-a-batch)
  * `BatchDeletionTargets`
    * Used by [`DELETE /batches/{id}`](/docs/api/api-reference/batch/delete-a-batch)
  * `BatchErrorResponse`

      <Expandable title="4 endpoints using this schema">
        * [`DELETE /batches/{id}`](/docs/api/api-reference/batch/delete-a-batch)
        * [`GET /batches`](/docs/api/api-reference/batch/list-batches)
        * [`GET /batches/{id}`](/docs/api/api-reference/batch/get-a-batch)
        * [`POST /batches`](/docs/api/api-reference/batch/create-a-batch)
      </Expandable>
  * `BatchListItem`
    * Used by [`GET /batches`](/docs/api/api-reference/batch/list-batches)
  * `BatchListResponse`
    * Used by [`GET /batches`](/docs/api/api-reference/batch/list-batches)
  * `BatchListStatus`
    * Used by [`GET /batches`](/docs/api/api-reference/batch/list-batches)
  * `BatchListTimestamp`
    * Used by [`GET /batches`](/docs/api/api-reference/batch/list-batches)
  * `BatchObject`
    * Used by [`GET /batches/{id}`](/docs/api/api-reference/batch/get-a-batch), [`POST /batches`](/docs/api/api-reference/batch/create-a-batch)
  * `BatchPaymentRequiredResponse`
    * Used by [`GET /batches/{id}`](/docs/api/api-reference/batch/get-a-batch)
  * `BatchProviderPreferences`
    * Used by [`POST /batches`](/docs/api/api-reference/batch/create-a-batch)
  * `BatchSubmitBody`
    * Used by [`POST /batches`](/docs/api/api-reference/batch/create-a-batch)
  * `FinishReason`
    * Used by [`GET /batches/{id}`](/docs/api/api-reference/batch/get-a-batch), [`POST /batches`](/docs/api/api-reference/batch/create-a-batch)

  ## Modified schemas

  * `PublicEndpoint`: example modified; new property `supports_image_reference`; new property `supports_multiple_audio_references`
    * Used by [`GET /endpoints/zdr`](/docs/api/api-reference/endpoints/preview-the-impact-of-zdr-on-the-available-endpoints), [`GET /models/{author}/{slug}/endpoints`](/docs/api/api-reference/endpoints/list-all-endpoints-for-a-model)
  * `SpeechInputReference`: description updated; new union variant added
    * Used by [`POST /audio/speech`](/docs/api/api-reference/tts/create-speech)
  * `SpeechInputReferenceAudio`: description updated
    * Used by [`POST /audio/speech`](/docs/api/api-reference/tts/create-speech)
  * `SpeechInputReferenceAudioInput`: new property `url`; description updated
    * Used by [`POST /audio/speech`](/docs/api/api-reference/tts/create-speech)
  * `SpeechInputReferenceText`: description updated
    * Used by [`POST /audio/speech`](/docs/api/api-reference/tts/create-speech)
  * `SpeechRequest`: description updated
    * Used by [`POST /audio/speech`](/docs/api/api-reference/tts/create-speech)
  * `ImageGenerationRequest`: enum property\_added
    * Used by [`POST /images`](/docs/api/api-reference/images/generate-an-image)
  * `BYOKProviderSlug`: enum property\_added

      <Expandable title="4 endpoints using this schema">
        * [`GET /byok`](/docs/api/api-reference/byok/list-byok-provider-credentials)
        * [`GET /byok/{id}`](/docs/api/api-reference/byok/get-a-byok-provider-credential)
        * [`PATCH /byok/{id}`](/docs/api/api-reference/byok/update-a-byok-provider-credential)
        * [`POST /byok`](/docs/api/api-reference/byok/create-a-byok-provider-credential)
      </Expandable>
  * `MessagesStartEvent`: property `provider` updated
    * Used by [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
  * `ProviderName`: enum property\_added

      <Expandable title="14 endpoints using this schema">
        * [`GET /endpoints/zdr`](/docs/api/api-reference/endpoints/preview-the-impact-of-zdr-on-the-available-endpoints)
        * [`GET /models/{author}/{slug}/endpoints`](/docs/api/api-reference/endpoints/list-all-endpoints-for-a-model)
        * [`POST /api/alpha/decisions`](/docs/api/api-reference/alphadecisions/submit-a-decisions-request)
        * [`POST /batches`](/docs/api/api-reference/batch/create-a-batch)
        * [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion)
        * [`POST /embeddings`](/docs/api/api-reference/embeddings/submit-an-embedding-request)
        * [`POST /images`](/docs/api/api-reference/images/generate-an-image)
        * [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
        * [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
        * [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
        * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body)
        * [`POST /rerank`](/docs/api/api-reference/rerank/submit-a-rerank-request)
        * [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
        * [`POST /systemone`](/docs/api/api-reference/systemone/submit-a-system-one-request)
      </Expandable>
  * `ProviderOptions`: new property `respan`

      <Expandable title="14 endpoints using this schema">
        * [`POST /api/alpha/decisions`](/docs/api/api-reference/alphadecisions/submit-a-decisions-request)
        * [`POST /audio/speech`](/docs/api/api-reference/tts/create-speech)
        * [`POST /audio/transcriptions`](/docs/api/api-reference/stt/create-transcription)
        * [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion)
        * [`POST /embeddings`](/docs/api/api-reference/embeddings/submit-an-embedding-request)
        * [`POST /images`](/docs/api/api-reference/images/generate-an-image)
        * [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
        * [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
        * [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
        * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body)
        * [`POST /rerank`](/docs/api/api-reference/rerank/submit-a-rerank-request)
        * [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
        * [`POST /systemone`](/docs/api/api-reference/systemone/submit-a-system-one-request)
        * [`POST /videos`](/docs/api/api-reference/video-generation/submit-a-video-generation-request)
      </Expandable>
  * `ProviderResponse`: enum property\_added
    * Used by [`GET /generation`](/docs/api/api-reference/generations/get-request-&-usage-metadata-for-a-generation)
</Update>

<Update label="September 24, 2026" tags={["BYOK","Interns","SCIM","Schemas"]} rss="1 new endpoint, 2 modified endpoints, 1 new schema, 6 modified schemas.">
  ## New endpoints

  * [`GET /interns/{internId}/daemon-access`](/docs/api/api-reference/interns/get-an-interns-daemon-access): Get an intern's daemon access

  ## Modified endpoints

  * [`GET /scim/groups`](/docs/api/api-reference/scim/list-scim-groups): new parameter `display_name`; new parameter `external_id`
  * [`GET /byok`](/docs/api/api-reference/byok/list-byok-provider-credentials): parameter `provider` updated

  ## New schemas

  * `InternDaemonAccess`
    * Used by [`GET /interns/{internId}/daemon-access`](/docs/api/api-reference/interns/get-an-interns-daemon-access)

  ## Modified schemas

  * `ProviderPreferences`: new property `options`

      <Expandable title="10 endpoints using this schema">
        * [`POST /api/alpha/decisions`](/docs/api/api-reference/alphadecisions/submit-a-decisions-request)
        * [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion)
        * [`POST /embeddings`](/docs/api/api-reference/embeddings/submit-an-embedding-request)
        * [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
        * [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
        * [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
        * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body)
        * [`POST /rerank`](/docs/api/api-reference/rerank/submit-a-rerank-request)
        * [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
        * [`POST /systemone`](/docs/api/api-reference/systemone/submit-a-system-one-request)
      </Expandable>
  * `BYOKProviderSlug`: enum property\_added

      <Expandable title="4 endpoints using this schema">
        * [`GET /byok`](/docs/api/api-reference/byok/list-byok-provider-credentials)
        * [`GET /byok/{id}`](/docs/api/api-reference/byok/get-a-byok-provider-credential)
        * [`PATCH /byok/{id}`](/docs/api/api-reference/byok/update-a-byok-provider-credential)
        * [`POST /byok`](/docs/api/api-reference/byok/create-a-byok-provider-credential)
      </Expandable>
  * `MessagesStartEvent`: property `provider` updated
    * Used by [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
  * `ProviderName`: enum property\_added

      <Expandable title="13 endpoints using this schema">
        * [`GET /endpoints/zdr`](/docs/api/api-reference/endpoints/preview-the-impact-of-zdr-on-the-available-endpoints)
        * [`GET /models/{author}/{slug}/endpoints`](/docs/api/api-reference/endpoints/list-all-endpoints-for-a-model)
        * [`POST /api/alpha/decisions`](/docs/api/api-reference/alphadecisions/submit-a-decisions-request)
        * [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion)
        * [`POST /embeddings`](/docs/api/api-reference/embeddings/submit-an-embedding-request)
        * [`POST /images`](/docs/api/api-reference/images/generate-an-image)
        * [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
        * [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
        * [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
        * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body)
        * [`POST /rerank`](/docs/api/api-reference/rerank/submit-a-rerank-request)
        * [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
        * [`POST /systemone`](/docs/api/api-reference/systemone/submit-a-system-one-request)
      </Expandable>
  * `ProviderOptions`: new property `scaledown`

      <Expandable title="14 endpoints using this schema">
        * [`POST /api/alpha/decisions`](/docs/api/api-reference/alphadecisions/submit-a-decisions-request)
        * [`POST /audio/speech`](/docs/api/api-reference/tts/create-speech)
        * [`POST /audio/transcriptions`](/docs/api/api-reference/stt/create-transcription)
        * [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion)
        * [`POST /embeddings`](/docs/api/api-reference/embeddings/submit-an-embedding-request)
        * [`POST /images`](/docs/api/api-reference/images/generate-an-image)
        * [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
        * [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
        * [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
        * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body)
        * [`POST /rerank`](/docs/api/api-reference/rerank/submit-a-rerank-request)
        * [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
        * [`POST /systemone`](/docs/api/api-reference/systemone/submit-a-system-one-request)
        * [`POST /videos`](/docs/api/api-reference/video-generation/submit-a-video-generation-request)
      </Expandable>
  * `ProviderResponse`: enum property\_added
    * Used by [`GET /generation`](/docs/api/api-reference/generations/get-request-&-usage-metadata-for-a-generation)
</Update>

<Update label="September 23, 2026" tags={["Breaking","Interns","Schemas"]} rss="17 breaking changes, 1 new endpoint, 2 new schemas, 2 modified schemas.">
  ## Breaking changes

  * spec: arguments property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * spec: call\_id property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * spec: input property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * spec: name property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * spec: type property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * \$.components: allOf object removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * \$.components: anyOf object removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * `CustomToolCallItem`: allOf `allOf` object removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `CustomToolCallItem`: required `call_id` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `CustomToolCallItem`: required `input` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `CustomToolCallItem`: required `name` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `CustomToolCallItem`: required `type` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `FunctionCallItem`: allOf `allOf` object removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `FunctionCallItem`: required `arguments` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `FunctionCallItem`: required `call_id` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `FunctionCallItem`: required `name` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `FunctionCallItem`: required `type` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)

  ## New endpoints

  * [`POST /interns/{internId}/invoke`](/docs/api/api-reference/interns/start-an-intern-run-without-waiting-for-it): Start an intern run without waiting for it

  ## New schemas

  * `InternInvokeAcceptedResponse`
    * Used by [`POST /interns/{internId}/invoke`](/docs/api/api-reference/interns/start-an-intern-run-without-waiting-for-it)
  * `InternInvokeRequest`
    * Used by [`POST /interns/{internId}/invoke`](/docs/api/api-reference/interns/start-an-intern-run-without-waiting-for-it)

  ## Modified schemas

  * `CustomToolCallItem`:
    * new property `async`
    * new property `call_id`
    * new property `id`
    * new property `input`
    * new property `name`
    * new property `namespace`
    * new property `status`
    * new property `type`
    * type property\_added
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `FunctionCallItem`:
    * new property `arguments`
    * new property `async`
    * new property `call_id`
    * new property `id`
    * new property `name`
    * new property `namespace`
    * new property `status`
    * new property `subagent_id`
    * new property `subagent_items`
    * new property `type`
    * type property\_added
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
</Update>

<Update label="September 22, 2026" tags={["Interns","Schemas","Workspaces","alpha.decisions"]} rss="9 modified endpoints, 3 new schemas, 13 modified schemas.">
  ## Modified endpoints

  * [`GET /workspaces`](/docs/api/api-reference/workspaces/list-workspaces): response schema updated
  * [`POST /workspaces`](/docs/api/api-reference/workspaces/create-a-workspace): response schema updated
  * [`GET /workspaces/{id}`](/docs/api/api-reference/workspaces/get-a-workspace): response schema updated
  * [`PATCH /workspaces/{id}`](/docs/api/api-reference/workspaces/update-a-workspace): response schema updated
  * [`POST /api/alpha/decisions`](/docs/api/api-reference/alphadecisions/submit-a-decisions-request): description updated
  * [`POST /interns/{internId}/chat/completions`](/docs/api/api-reference/interns/stream-a-chat-completion-with-an-intern): description updated
  * [`DELETE /interns/{internId}`](/docs/api/api-reference/interns/delete-an-intern): description updated; response schema updated
  * [`POST /interns/{internId}/provision`](/docs/api/api-reference/interns/provision-an-intern): description updated; response schema updated
  * [`POST /interns/{internId}/suspend`](/docs/api/api-reference/interns/suspend-an-intern): description updated; response schema updated

  ## New schemas

  * `AnthropicSafeguard`
    * Used by [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message), [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
  * `AnthropicSafeguardResult`
    * Used by [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
  * `SwitchyardRouterPlugin`

      <Expandable title="6 endpoints using this schema">
        * [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion)
        * [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
        * [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
        * [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
        * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body)
        * [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
      </Expandable>

  ## Modified schemas

  * `CreateWorkspaceRequest`: new property `disabled_server_tools`
    * Used by [`POST /workspaces`](/docs/api/api-reference/workspaces/create-a-workspace)
  * `CreateWorkspaceResponse`: example modified
    * Used by [`POST /workspaces`](/docs/api/api-reference/workspaces/create-a-workspace)
  * `GetWorkspaceResponse`: example modified
    * Used by [`GET /workspaces/{id}`](/docs/api/api-reference/workspaces/get-a-workspace)
  * `ListWorkspacesResponse`: example modified
    * Used by [`GET /workspaces`](/docs/api/api-reference/workspaces/list-workspaces)
  * `MessagesDeltaEvent`: new property `safeguard_results`
    * Used by [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
  * `MessagesRequest`: new property `safeguards`
    * Used by [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message), [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
  * `UpdateWorkspaceRequest`: new property `disabled_server_tools`
    * Used by [`PATCH /workspaces/{id}`](/docs/api/api-reference/workspaces/update-a-workspace)
  * `UpdateWorkspaceResponse`: example modified
    * Used by [`PATCH /workspaces/{id}`](/docs/api/api-reference/workspaces/update-a-workspace)
  * `Workspace`: example modified; new property `disabled_server_tools`

      <Expandable title="4 endpoints using this schema">
        * [`GET /workspaces`](/docs/api/api-reference/workspaces/list-workspaces)
        * [`GET /workspaces/{id}`](/docs/api/api-reference/workspaces/get-a-workspace)
        * [`PATCH /workspaces/{id}`](/docs/api/api-reference/workspaces/update-a-workspace)
        * [`POST /workspaces`](/docs/api/api-reference/workspaces/create-a-workspace)
      </Expandable>
  * `ResponsesRequest`: description updated
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `ChatRequest`: new union variant added
    * Used by [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion), [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
  * `MessagesRequest`: new union variant added
    * Used by [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message), [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
  * `ResponsesRequest`: new union variant added
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
</Update>

<Update label="September 21, 2026" tags={["BYOK","Breaking","Interns","Schemas"]} rss="2 breaking changes, 16 modified endpoints, 12 new response codes, 2 new schemas, 22 modified schemas.">
  ## Breaking changes

  * `InternChatErrorMetadata`: required `retryable` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
    * Used by [`POST /interns/{internId}/chat/completions`](/docs/api/api-reference/interns/stream-a-chat-completion-with-an-intern)
  * `BYOKKey`: required `declared_zdr` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

      <Expandable title="4 endpoints using this schema">
        * [`GET /byok`](/docs/api/api-reference/byok/list-byok-provider-credentials)
        * [`GET /byok/{id}`](/docs/api/api-reference/byok/get-a-byok-provider-credential)
        * [`PATCH /byok/{id}`](/docs/api/api-reference/byok/update-a-byok-provider-credential)
        * [`POST /byok`](/docs/api/api-reference/byok/create-a-byok-provider-credential)
      </Expandable>

  ## Modified endpoints

  * [`GET /interns`](/docs/api/api-reference/interns/list-interns): description updated; parameter `status` updated; response schema updated
  * [`POST /interns`](/docs/api/api-reference/interns/create-an-intern): description updated; parameter `Idempotency-Key` updated; response schema updated
  * [`DELETE /interns/{internId}`](/docs/api/api-reference/interns/delete-an-intern): response schema updated; description updated
  * [`GET /interns/{internId}`](/docs/api/api-reference/interns/get-an-intern): response schema updated; description updated
  * [`PATCH /interns/{internId}`](/docs/api/api-reference/interns/update-an-intern): response schema updated; description updated
  * [`POST /interns/{internId}/chat/completions`](/docs/api/api-reference/interns/stream-a-chat-completion-with-an-intern): response schema updated; description updated
  * [`POST /interns/{internId}/provision`](/docs/api/api-reference/interns/provision-an-intern): description updated; response schema updated
  * [`POST /interns/{internId}/suspend`](/docs/api/api-reference/interns/suspend-an-intern): description updated; response schema updated
  * [`GET /byok`](/docs/api/api-reference/byok/list-byok-provider-credentials): response schema updated
  * [`POST /byok`](/docs/api/api-reference/byok/create-a-byok-provider-credential): response schema updated
  * [`GET /byok/{id}`](/docs/api/api-reference/byok/get-a-byok-provider-credential): response schema updated
  * [`PATCH /byok/{id}`](/docs/api/api-reference/byok/update-a-byok-provider-credential): response schema updated
  * [`POST /interns/{internId}/chat/completions`](/docs/api/api-reference/interns/stream-a-chat-completion-with-an-intern): description updated
  * [`POST /interns`](/docs/api/api-reference/interns/create-an-intern): description updated
  * [`DELETE /interns/{internId}`](/docs/api/api-reference/interns/delete-an-intern): description updated
  * [`PATCH /interns/{internId}`](/docs/api/api-reference/interns/update-an-intern): description updated

  ## New response codes

  * [`PATCH /interns/{internId}`](/docs/api/api-reference/interns/update-an-intern): now returns `409`
  * [`POST /interns/{internId}/chat/completions`](/docs/api/api-reference/interns/stream-a-chat-completion-with-an-intern): now returns `408`
  * [`POST /interns/{internId}/provision`](/docs/api/api-reference/interns/provision-an-intern): now returns `400`
  * [`POST /interns/{internId}/provision`](/docs/api/api-reference/interns/provision-an-intern): now returns `413`
  * [`POST /interns/{internId}/suspend`](/docs/api/api-reference/interns/suspend-an-intern): now returns `400`
  * [`POST /interns/{internId}/suspend`](/docs/api/api-reference/interns/suspend-an-intern): now returns `413`
  * [`POST /interns/{internId}/chat/completions`](/docs/api/api-reference/interns/stream-a-chat-completion-with-an-intern): now returns `202`
  * [`POST /interns`](/docs/api/api-reference/interns/create-an-intern): now returns `415`
  * [`DELETE /interns/{internId}`](/docs/api/api-reference/interns/delete-an-intern): now returns `415`
  * [`PATCH /interns/{internId}`](/docs/api/api-reference/interns/update-an-intern): now returns `415`
  * [`POST /interns/{internId}/provision`](/docs/api/api-reference/interns/provision-an-intern): now returns `415`
  * [`POST /interns/{internId}/suspend`](/docs/api/api-reference/interns/suspend-an-intern): now returns `415`

  ## New schemas

  * `XSearchOptions`

      <Expandable title="6 endpoints using this schema">
        * [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion)
        * [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
        * [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
        * [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
        * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body)
        * [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
      </Expandable>
  * `InternChatSteeredResponse`
    * Used by [`POST /interns/{internId}/chat/completions`](/docs/api/api-reference/interns/stream-a-chat-completion-with-an-intern)

  ## Modified schemas

  * `InternChatError`: example modified
    * Used by [`POST /interns/{internId}/chat/completions`](/docs/api/api-reference/interns/stream-a-chat-completion-with-an-intern)
  * `InternChatErrorMetadata`: example modified; new property `retryable`
    * Used by [`POST /interns/{internId}/chat/completions`](/docs/api/api-reference/interns/stream-a-chat-completion-with-an-intern)
  * `InternChatErrorResponse`: example modified
    * Used by [`POST /interns/{internId}/chat/completions`](/docs/api/api-reference/interns/stream-a-chat-completion-with-an-intern)
  * `InternChatStreamError`: example modified
    * Used by [`POST /interns/{internId}/chat/completions`](/docs/api/api-reference/interns/stream-a-chat-completion-with-an-intern)
  * `InternLifecycleError`: example modified; new property `metadata`

      <Expandable title="7 endpoints using this schema">
        * [`DELETE /interns/{internId}`](/docs/api/api-reference/interns/delete-an-intern)
        * [`GET /interns`](/docs/api/api-reference/interns/list-interns)
        * [`GET /interns/{internId}`](/docs/api/api-reference/interns/get-an-intern)
        * [`PATCH /interns/{internId}`](/docs/api/api-reference/interns/update-an-intern)
        * [`POST /interns`](/docs/api/api-reference/interns/create-an-intern)
        * [`POST /interns/{internId}/provision`](/docs/api/api-reference/interns/provision-an-intern)
        * [`POST /interns/{internId}/suspend`](/docs/api/api-reference/interns/suspend-an-intern)
      </Expandable>
  * `VideoGenerationRequest`: enum property\_added
    * Used by [`POST /videos`](/docs/api/api-reference/video-generation/submit-a-video-generation-request)
  * `VideoModel`: enum property\_added
    * Used by [`GET /videos/models`](/docs/api/api-reference/video-generation/list-all-video-generation-models)
  * `ChatWebSearchShorthand`: new property `x_search`; description updated
    * Used by [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion), [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
  * `Legacy_WebSearchServerTool`: new property `x_search`
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `Preview_20250311_WebSearchServerTool`: new property `x_search`
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `Preview_WebSearchServerTool`: new property `x_search`
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `WebSearchConfig`: new property `x_search`; description updated

      <Expandable title="4 endpoints using this schema">
        * [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion)
        * [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
        * [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
        * [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
      </Expandable>
  * `WebSearchPlugin`: new property `x_search`

      <Expandable title="6 endpoints using this schema">
        * [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion)
        * [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
        * [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
        * [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
        * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body)
        * [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
      </Expandable>
  * `WebSearchServerTool`: new property `x_search`
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `WebSearchServerToolConfig`: new property `x_search`; description updated
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `BYOKKey`: example modified; new property `declared_zdr`

      <Expandable title="4 endpoints using this schema">
        * [`GET /byok`](/docs/api/api-reference/byok/list-byok-provider-credentials)
        * [`GET /byok/{id}`](/docs/api/api-reference/byok/get-a-byok-provider-credential)
        * [`PATCH /byok/{id}`](/docs/api/api-reference/byok/update-a-byok-provider-credential)
        * [`POST /byok`](/docs/api/api-reference/byok/create-a-byok-provider-credential)
      </Expandable>
  * `CreateBYOKKeyRequest`: new property `declared_zdr`
    * Used by [`POST /byok`](/docs/api/api-reference/byok/create-a-byok-provider-credential)
  * `CreateBYOKKeyResponse`: example modified
    * Used by [`POST /byok`](/docs/api/api-reference/byok/create-a-byok-provider-credential)
  * `GetBYOKKeyResponse`: example modified
    * Used by [`GET /byok/{id}`](/docs/api/api-reference/byok/get-a-byok-provider-credential)
  * `ListBYOKKeysResponse`: example modified
    * Used by [`GET /byok`](/docs/api/api-reference/byok/list-byok-provider-credentials)
  * `UpdateBYOKKeyRequest`: new property `declared_zdr`
    * Used by [`PATCH /byok/{id}`](/docs/api/api-reference/byok/update-a-byok-provider-credential)
  * `UpdateBYOKKeyResponse`: example modified
    * Used by [`PATCH /byok/{id}`](/docs/api/api-reference/byok/update-a-byok-provider-credential)
</Update>

<Update label="September 20, 2026" tags={["Breaking","SystemOne","alpha.decisions"]} rss="2 breaking changes, 1 new endpoint, 1 modified endpoint.">
  ## Breaking changes

  * [`POST /systemone`](/docs/api/api-reference/systemone/submit-a-system-one-request): x-speakeasy-ignore `true` object removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * [`POST /systemone`](/docs/api/api-reference/systemone/submit-a-system-one-request): tags `alpha.decisions` property removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

  ## New endpoints

  * [`POST /systemone`](/docs/api/api-reference/alphadecisions/submit-a-system-one-request-typesafe-sdk-compatible-alias): Submit a System One request (TypeSafe SDK compatible alias)

  ## Modified endpoints

  * [`POST /systemone`](/docs/api/api-reference/systemone/submit-a-system-one-request): x-speakeasy-name-override object\_added; description updated; tags property\_added
</Update>

<Update label="September 19, 2026" tags={["API Keys","BYOK","Breaking","Interns","Observability","Schemas"]} rss="5 breaking changes, 6 modified endpoints, 3 new response codes, 1 new schema, 6 modified schemas.">
  ## Breaking changes

  * [`GET /key`](/docs/api/api-reference/api-keys/get-current-api-key): required `organization_id` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * [`GET /key`](/docs/api/api-reference/api-keys/get-current-api-key): required `workspace_id` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * `CreateInternRequest`: required `workspace_id` property removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
    * Used by [`POST /interns`](/docs/api/api-reference/interns/create-an-intern)
  * `InternChatAssistantMessage`: required `content` property removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
    * Used by [`POST /interns/{internId}/chat/completions`](/docs/api/api-reference/interns/stream-a-chat-completion-with-an-intern)
  * [`DELETE /interns/{internId}`](/docs/api/api-reference/interns/delete-an-intern): requestBody `requestBody` property added<Badge stroke color="red" icon="triangle-exclamation" className="changelog-status-badge">Action required</Badge>
    * Regenerated SDK clients: pass `{}` when no acknowledgement is needed, or `{ acknowledge_workspace_loss: true }` when deleting the intern also requires acknowledging workspace loss. Raw HTTP clients may continue to omit the body.

  ## Modified endpoints

  * [`GET /key`](/docs/api/api-reference/api-keys/get-current-api-key): response schema updated
  * [`POST /interns`](/docs/api/api-reference/interns/create-an-intern): description updated; response schema updated
  * [`POST /interns/{internId}/chat/completions`](/docs/api/api-reference/interns/stream-a-chat-completion-with-an-intern): description updated
  * [`DELETE /interns/{internId}`](/docs/api/api-reference/interns/delete-an-intern): description updated
  * [`GET /interns`](/docs/api/api-reference/interns/list-interns): new parameter `starting_after`
  * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination): description updated; response schema updated

  ## New response codes

  * [`DELETE /interns/{internId}`](/docs/api/api-reference/interns/delete-an-intern): now returns `400`
  * [`DELETE /interns/{internId}`](/docs/api/api-reference/interns/delete-an-intern): now returns `413`
  * [`PATCH /byok/{id}`](/docs/api/api-reference/byok/update-a-byok-provider-credential): now returns `403`

  ## New schemas

  * `DeleteInternRequest`
    * Used by [`DELETE /interns/{internId}`](/docs/api/api-reference/interns/delete-an-intern)

  ## Modified schemas

  * `InternChatCompletionRequest`: description updated
    * Used by [`POST /interns/{internId}/chat/completions`](/docs/api/api-reference/interns/stream-a-chat-completion-with-an-intern)
  * `CreateInternRequest`: description updated
    * Used by [`POST /interns`](/docs/api/api-reference/interns/create-an-intern)
  * `TokenExchangeRequest`: pattern property\_added
    * Used by [`POST /oauth/token`](/docs/api/api-reference/oauth/exchange-a-workload-identity-token)
  * `InternChatCompletionChunk`: description updated
    * Used by [`POST /interns/{internId}/chat/completions`](/docs/api/api-reference/interns/stream-a-chat-completion-with-an-intern)
  * `UpdateInternRequest`: description updated; minLength property\_added; pattern property\_added
    * Used by [`PATCH /interns/{internId}`](/docs/api/api-reference/interns/update-an-intern)
  * `InternListResponse`: new property `next_cursor`
    * Used by [`GET /interns`](/docs/api/api-reference/interns/list-interns)
</Update>

<Update label="September 18, 2026" tags={["Breaking","Interns","Schemas","alpha.decisions"]} rss="86 breaking changes, 6 modified endpoints, 9 modified schemas.">
  ## Breaking changes

  * [`POST /api/alpha/decisions`](/docs/api/api-reference/alphadecisions/submit-a-decisions-questions-and-answers-request): tags `Decisions` property removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * \$.tags: Decisions object removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * `Intern`: properties `createdAt` object removed<Badge stroke color="red" icon="triangle-exclamation" className="changelog-status-badge">Action required</Badge>

    * Update response parsing from `createdAt` to `created_at`.

      <Expandable title="4 endpoints using this schema">
        - [`GET /interns`](/docs/api/api-reference/interns/list-interns)
        - [`GET /interns/{internId}`](/docs/api/api-reference/interns/get-an-intern)
        - [`PATCH /interns/{internId}`](/docs/api/api-reference/interns/update-an-intern)
        - [`POST /interns`](/docs/api/api-reference/interns/create-an-intern)
      </Expandable>
  * `Intern`: properties `lastFailureMessage` object removed<Badge stroke color="red" icon="triangle-exclamation" className="changelog-status-badge">Action required</Badge>

    * Update response parsing from `lastFailureMessage` to `last_failure_message`.

      <Expandable title="4 endpoints using this schema">
        - [`GET /interns`](/docs/api/api-reference/interns/list-interns)
        - [`GET /interns/{internId}`](/docs/api/api-reference/interns/get-an-intern)
        - [`PATCH /interns/{internId}`](/docs/api/api-reference/interns/update-an-intern)
        - [`POST /interns`](/docs/api/api-reference/interns/create-an-intern)
      </Expandable>
  * `Intern`: properties `updatedAt` object removed<Badge stroke color="red" icon="triangle-exclamation" className="changelog-status-badge">Action required</Badge>

    * Update response parsing from `updatedAt` to `updated_at`.

      <Expandable title="4 endpoints using this schema">
        - [`GET /interns`](/docs/api/api-reference/interns/list-interns)
        - [`GET /interns/{internId}`](/docs/api/api-reference/interns/get-an-intern)
        - [`PATCH /interns/{internId}`](/docs/api/api-reference/interns/update-an-intern)
        - [`POST /interns`](/docs/api/api-reference/interns/create-an-intern)
      </Expandable>
  * `Intern`: properties `workspaceId` object removed<Badge stroke color="red" icon="triangle-exclamation" className="changelog-status-badge">Action required</Badge>

    * Update response parsing from `workspaceId` to `workspace_id`.

      <Expandable title="4 endpoints using this schema">
        - [`GET /interns`](/docs/api/api-reference/interns/list-interns)
        - [`GET /interns/{internId}`](/docs/api/api-reference/interns/get-an-intern)
        - [`PATCH /interns/{internId}`](/docs/api/api-reference/interns/update-an-intern)
        - [`POST /interns`](/docs/api/api-reference/interns/create-an-intern)
      </Expandable>
  * `Intern`: required `created_at` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

      <Expandable title="4 endpoints using this schema">
        * [`GET /interns`](/docs/api/api-reference/interns/list-interns)
        * [`GET /interns/{internId}`](/docs/api/api-reference/interns/get-an-intern)
        * [`PATCH /interns/{internId}`](/docs/api/api-reference/interns/update-an-intern)
        * [`POST /interns`](/docs/api/api-reference/interns/create-an-intern)
      </Expandable>
  * `Intern`: required `last_failure_message` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

      <Expandable title="4 endpoints using this schema">
        * [`GET /interns`](/docs/api/api-reference/interns/list-interns)
        * [`GET /interns/{internId}`](/docs/api/api-reference/interns/get-an-intern)
        * [`PATCH /interns/{internId}`](/docs/api/api-reference/interns/update-an-intern)
        * [`POST /interns`](/docs/api/api-reference/interns/create-an-intern)
      </Expandable>
  * `Intern`: required `updated_at` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

      <Expandable title="4 endpoints using this schema">
        * [`GET /interns`](/docs/api/api-reference/interns/list-interns)
        * [`GET /interns/{internId}`](/docs/api/api-reference/interns/get-an-intern)
        * [`PATCH /interns/{internId}`](/docs/api/api-reference/interns/update-an-intern)
        * [`POST /interns`](/docs/api/api-reference/interns/create-an-intern)
      </Expandable>
  * `Intern`: required `workspace_id` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

      <Expandable title="4 endpoints using this schema">
        * [`GET /interns`](/docs/api/api-reference/interns/list-interns)
        * [`GET /interns/{internId}`](/docs/api/api-reference/interns/get-an-intern)
        * [`PATCH /interns/{internId}`](/docs/api/api-reference/interns/update-an-intern)
        * [`POST /interns`](/docs/api/api-reference/interns/create-an-intern)
      </Expandable>
  * `Intern`: required `createdAt` property removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

      <Expandable title="4 endpoints using this schema">
        * [`GET /interns`](/docs/api/api-reference/interns/list-interns)
        * [`GET /interns/{internId}`](/docs/api/api-reference/interns/get-an-intern)
        * [`PATCH /interns/{internId}`](/docs/api/api-reference/interns/update-an-intern)
        * [`POST /interns`](/docs/api/api-reference/interns/create-an-intern)
      </Expandable>
  * `Intern`: required `lastFailureMessage` property removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

      <Expandable title="4 endpoints using this schema">
        * [`GET /interns`](/docs/api/api-reference/interns/list-interns)
        * [`GET /interns/{internId}`](/docs/api/api-reference/interns/get-an-intern)
        * [`PATCH /interns/{internId}`](/docs/api/api-reference/interns/update-an-intern)
        * [`POST /interns`](/docs/api/api-reference/interns/create-an-intern)
      </Expandable>
  * `Intern`: required `updatedAt` property removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

      <Expandable title="4 endpoints using this schema">
        * [`GET /interns`](/docs/api/api-reference/interns/list-interns)
        * [`GET /interns/{internId}`](/docs/api/api-reference/interns/get-an-intern)
        * [`PATCH /interns/{internId}`](/docs/api/api-reference/interns/update-an-intern)
        * [`POST /interns`](/docs/api/api-reference/interns/create-an-intern)
      </Expandable>
  * `Intern`: required `workspaceId` property removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

      <Expandable title="4 endpoints using this schema">
        * [`GET /interns`](/docs/api/api-reference/interns/list-interns)
        * [`GET /interns/{internId}`](/docs/api/api-reference/interns/get-an-intern)
        * [`PATCH /interns/{internId}`](/docs/api/api-reference/interns/update-an-intern)
        * [`POST /interns`](/docs/api/api-reference/interns/create-an-intern)
      </Expandable>
  * `Intern`: properties `stepLabel` object removed<Badge stroke color="red" icon="triangle-exclamation" className="changelog-status-badge">Action required</Badge>

    * Update response parsing from `stepLabel` to `step_label`.

      <Expandable title="4 endpoints using this schema">
        - [`GET /interns`](/docs/api/api-reference/interns/list-interns)
        - [`GET /interns/{internId}`](/docs/api/api-reference/interns/get-an-intern)
        - [`PATCH /interns/{internId}`](/docs/api/api-reference/interns/update-an-intern)
        - [`POST /interns`](/docs/api/api-reference/interns/create-an-intern)
      </Expandable>
  * `Intern`: properties `stepNumber` object removed<Badge stroke color="red" icon="triangle-exclamation" className="changelog-status-badge">Action required</Badge>

    * Update response parsing from `stepNumber` to `step_number`.

      <Expandable title="4 endpoints using this schema">
        - [`GET /interns`](/docs/api/api-reference/interns/list-interns)
        - [`GET /interns/{internId}`](/docs/api/api-reference/interns/get-an-intern)
        - [`PATCH /interns/{internId}`](/docs/api/api-reference/interns/update-an-intern)
        - [`POST /interns`](/docs/api/api-reference/interns/create-an-intern)
      </Expandable>
  * `Intern`: properties `totalSteps` object removed<Badge stroke color="red" icon="triangle-exclamation" className="changelog-status-badge">Action required</Badge>

    * Update response parsing from `totalSteps` to `total_steps`.

      <Expandable title="4 endpoints using this schema">
        - [`GET /interns`](/docs/api/api-reference/interns/list-interns)
        - [`GET /interns/{internId}`](/docs/api/api-reference/interns/get-an-intern)
        - [`PATCH /interns/{internId}`](/docs/api/api-reference/interns/update-an-intern)
        - [`POST /interns`](/docs/api/api-reference/interns/create-an-intern)
      </Expandable>
  * `Intern`: required `step_label` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

      <Expandable title="4 endpoints using this schema">
        * [`GET /interns`](/docs/api/api-reference/interns/list-interns)
        * [`GET /interns/{internId}`](/docs/api/api-reference/interns/get-an-intern)
        * [`PATCH /interns/{internId}`](/docs/api/api-reference/interns/update-an-intern)
        * [`POST /interns`](/docs/api/api-reference/interns/create-an-intern)
      </Expandable>
  * `Intern`: required `step_number` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

      <Expandable title="4 endpoints using this schema">
        * [`GET /interns`](/docs/api/api-reference/interns/list-interns)
        * [`GET /interns/{internId}`](/docs/api/api-reference/interns/get-an-intern)
        * [`PATCH /interns/{internId}`](/docs/api/api-reference/interns/update-an-intern)
        * [`POST /interns`](/docs/api/api-reference/interns/create-an-intern)
      </Expandable>
  * `Intern`: required `total_steps` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

      <Expandable title="4 endpoints using this schema">
        * [`GET /interns`](/docs/api/api-reference/interns/list-interns)
        * [`GET /interns/{internId}`](/docs/api/api-reference/interns/get-an-intern)
        * [`PATCH /interns/{internId}`](/docs/api/api-reference/interns/update-an-intern)
        * [`POST /interns`](/docs/api/api-reference/interns/create-an-intern)
      </Expandable>
  * `Intern`: required `stepLabel` property removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

      <Expandable title="4 endpoints using this schema">
        * [`GET /interns`](/docs/api/api-reference/interns/list-interns)
        * [`GET /interns/{internId}`](/docs/api/api-reference/interns/get-an-intern)
        * [`PATCH /interns/{internId}`](/docs/api/api-reference/interns/update-an-intern)
        * [`POST /interns`](/docs/api/api-reference/interns/create-an-intern)
      </Expandable>
  * `Intern`: required `stepNumber` property removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

      <Expandable title="4 endpoints using this schema">
        * [`GET /interns`](/docs/api/api-reference/interns/list-interns)
        * [`GET /interns/{internId}`](/docs/api/api-reference/interns/get-an-intern)
        * [`PATCH /interns/{internId}`](/docs/api/api-reference/interns/update-an-intern)
        * [`POST /interns`](/docs/api/api-reference/interns/create-an-intern)
      </Expandable>
  * `Intern`: required `totalSteps` property removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

      <Expandable title="4 endpoints using this schema">
        * [`GET /interns`](/docs/api/api-reference/interns/list-interns)
        * [`GET /interns/{internId}`](/docs/api/api-reference/interns/get-an-intern)
        * [`PATCH /interns/{internId}`](/docs/api/api-reference/interns/update-an-intern)
        * [`POST /interns`](/docs/api/api-reference/interns/create-an-intern)
      </Expandable>
  * [`POST /interns`](/docs/api/api-reference/interns/create-an-intern): properties `createdAt` object removed<Badge stroke color="red" icon="triangle-exclamation" className="changelog-status-badge">Action required</Badge>
    * Update response parsing from `createdAt` to `created_at`.
  * [`POST /interns`](/docs/api/api-reference/interns/create-an-intern): properties `lastFailureMessage` object removed<Badge stroke color="red" icon="triangle-exclamation" className="changelog-status-badge">Action required</Badge>
    * Update response parsing from `lastFailureMessage` to `last_failure_message`.
  * [`POST /interns`](/docs/api/api-reference/interns/create-an-intern): properties `updatedAt` object removed<Badge stroke color="red" icon="triangle-exclamation" className="changelog-status-badge">Action required</Badge>
    * Update response parsing from `updatedAt` to `updated_at`.
  * [`POST /interns`](/docs/api/api-reference/interns/create-an-intern): properties `workspaceId` object removed<Badge stroke color="red" icon="triangle-exclamation" className="changelog-status-badge">Action required</Badge>
    * Update response parsing from `workspaceId` to `workspace_id`.
  * [`POST /interns`](/docs/api/api-reference/interns/create-an-intern): required `created_at` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * [`POST /interns`](/docs/api/api-reference/interns/create-an-intern): required `last_failure_message` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * [`POST /interns`](/docs/api/api-reference/interns/create-an-intern): required `updated_at` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * [`POST /interns`](/docs/api/api-reference/interns/create-an-intern): required `workspace_id` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * [`POST /interns`](/docs/api/api-reference/interns/create-an-intern): required `createdAt` property removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * [`POST /interns`](/docs/api/api-reference/interns/create-an-intern): required `lastFailureMessage` property removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * [`POST /interns`](/docs/api/api-reference/interns/create-an-intern): required `updatedAt` property removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * [`POST /interns`](/docs/api/api-reference/interns/create-an-intern): required `workspaceId` property removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * [`POST /interns`](/docs/api/api-reference/interns/create-an-intern): properties `stepLabel` object removed<Badge stroke color="red" icon="triangle-exclamation" className="changelog-status-badge">Action required</Badge>
    * Update response parsing from `stepLabel` to `step_label`.
  * [`POST /interns`](/docs/api/api-reference/interns/create-an-intern): properties `stepNumber` object removed<Badge stroke color="red" icon="triangle-exclamation" className="changelog-status-badge">Action required</Badge>
    * Update response parsing from `stepNumber` to `step_number`.
  * [`POST /interns`](/docs/api/api-reference/interns/create-an-intern): properties `totalSteps` object removed<Badge stroke color="red" icon="triangle-exclamation" className="changelog-status-badge">Action required</Badge>
    * Update response parsing from `totalSteps` to `total_steps`.
  * [`POST /interns`](/docs/api/api-reference/interns/create-an-intern): required `step_label` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * [`POST /interns`](/docs/api/api-reference/interns/create-an-intern): required `step_number` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * [`POST /interns`](/docs/api/api-reference/interns/create-an-intern): required `total_steps` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * [`POST /interns`](/docs/api/api-reference/interns/create-an-intern): required `stepLabel` property removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * [`POST /interns`](/docs/api/api-reference/interns/create-an-intern): required `stepNumber` property removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * [`POST /interns`](/docs/api/api-reference/interns/create-an-intern): required `totalSteps` property removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * [`GET /interns/{internId}`](/docs/api/api-reference/interns/get-an-intern): properties `createdAt` object removed<Badge stroke color="red" icon="triangle-exclamation" className="changelog-status-badge">Action required</Badge>
    * Update response parsing from `createdAt` to `created_at`.
  * [`GET /interns/{internId}`](/docs/api/api-reference/interns/get-an-intern): properties `lastFailureMessage` object removed<Badge stroke color="red" icon="triangle-exclamation" className="changelog-status-badge">Action required</Badge>
    * Update response parsing from `lastFailureMessage` to `last_failure_message`.
  * [`GET /interns/{internId}`](/docs/api/api-reference/interns/get-an-intern): properties `updatedAt` object removed<Badge stroke color="red" icon="triangle-exclamation" className="changelog-status-badge">Action required</Badge>
    * Update response parsing from `updatedAt` to `updated_at`.
  * [`GET /interns/{internId}`](/docs/api/api-reference/interns/get-an-intern): properties `workspaceId` object removed<Badge stroke color="red" icon="triangle-exclamation" className="changelog-status-badge">Action required</Badge>
    * Update response parsing from `workspaceId` to `workspace_id`.
  * [`GET /interns/{internId}`](/docs/api/api-reference/interns/get-an-intern): required `created_at` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * [`GET /interns/{internId}`](/docs/api/api-reference/interns/get-an-intern): required `last_failure_message` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * [`GET /interns/{internId}`](/docs/api/api-reference/interns/get-an-intern): required `updated_at` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * [`GET /interns/{internId}`](/docs/api/api-reference/interns/get-an-intern): required `workspace_id` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * [`GET /interns/{internId}`](/docs/api/api-reference/interns/get-an-intern): required `createdAt` property removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * [`GET /interns/{internId}`](/docs/api/api-reference/interns/get-an-intern): required `lastFailureMessage` property removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * [`GET /interns/{internId}`](/docs/api/api-reference/interns/get-an-intern): required `updatedAt` property removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * [`GET /interns/{internId}`](/docs/api/api-reference/interns/get-an-intern): required `workspaceId` property removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * [`GET /interns/{internId}`](/docs/api/api-reference/interns/get-an-intern): properties `stepLabel` object removed<Badge stroke color="red" icon="triangle-exclamation" className="changelog-status-badge">Action required</Badge>
    * Update response parsing from `stepLabel` to `step_label`.
  * [`GET /interns/{internId}`](/docs/api/api-reference/interns/get-an-intern): properties `stepNumber` object removed<Badge stroke color="red" icon="triangle-exclamation" className="changelog-status-badge">Action required</Badge>
    * Update response parsing from `stepNumber` to `step_number`.
  * [`GET /interns/{internId}`](/docs/api/api-reference/interns/get-an-intern): properties `totalSteps` object removed<Badge stroke color="red" icon="triangle-exclamation" className="changelog-status-badge">Action required</Badge>
    * Update response parsing from `totalSteps` to `total_steps`.
  * [`GET /interns/{internId}`](/docs/api/api-reference/interns/get-an-intern): required `step_label` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * [`GET /interns/{internId}`](/docs/api/api-reference/interns/get-an-intern): required `step_number` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * [`GET /interns/{internId}`](/docs/api/api-reference/interns/get-an-intern): required `total_steps` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * [`GET /interns/{internId}`](/docs/api/api-reference/interns/get-an-intern): required `stepLabel` property removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * [`GET /interns/{internId}`](/docs/api/api-reference/interns/get-an-intern): required `stepNumber` property removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * [`GET /interns/{internId}`](/docs/api/api-reference/interns/get-an-intern): required `totalSteps` property removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * [`PATCH /interns/{internId}`](/docs/api/api-reference/interns/update-an-intern): properties `createdAt` object removed<Badge stroke color="red" icon="triangle-exclamation" className="changelog-status-badge">Action required</Badge>
    * Update response parsing from `createdAt` to `created_at`.
  * [`PATCH /interns/{internId}`](/docs/api/api-reference/interns/update-an-intern): properties `lastFailureMessage` object removed<Badge stroke color="red" icon="triangle-exclamation" className="changelog-status-badge">Action required</Badge>
    * Update response parsing from `lastFailureMessage` to `last_failure_message`.
  * [`PATCH /interns/{internId}`](/docs/api/api-reference/interns/update-an-intern): properties `updatedAt` object removed<Badge stroke color="red" icon="triangle-exclamation" className="changelog-status-badge">Action required</Badge>
    * Update response parsing from `updatedAt` to `updated_at`.
  * [`PATCH /interns/{internId}`](/docs/api/api-reference/interns/update-an-intern): properties `workspaceId` object removed<Badge stroke color="red" icon="triangle-exclamation" className="changelog-status-badge">Action required</Badge>
    * Update response parsing from `workspaceId` to `workspace_id`.
  * [`PATCH /interns/{internId}`](/docs/api/api-reference/interns/update-an-intern): required `created_at` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * [`PATCH /interns/{internId}`](/docs/api/api-reference/interns/update-an-intern): required `last_failure_message` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * [`PATCH /interns/{internId}`](/docs/api/api-reference/interns/update-an-intern): required `updated_at` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * [`PATCH /interns/{internId}`](/docs/api/api-reference/interns/update-an-intern): required `workspace_id` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * [`PATCH /interns/{internId}`](/docs/api/api-reference/interns/update-an-intern): required `createdAt` property removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * [`PATCH /interns/{internId}`](/docs/api/api-reference/interns/update-an-intern): required `lastFailureMessage` property removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * [`PATCH /interns/{internId}`](/docs/api/api-reference/interns/update-an-intern): required `updatedAt` property removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * [`PATCH /interns/{internId}`](/docs/api/api-reference/interns/update-an-intern): required `workspaceId` property removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * [`PATCH /interns/{internId}`](/docs/api/api-reference/interns/update-an-intern): properties `stepLabel` object removed<Badge stroke color="red" icon="triangle-exclamation" className="changelog-status-badge">Action required</Badge>
    * Update response parsing from `stepLabel` to `step_label`.
  * [`PATCH /interns/{internId}`](/docs/api/api-reference/interns/update-an-intern): properties `stepNumber` object removed<Badge stroke color="red" icon="triangle-exclamation" className="changelog-status-badge">Action required</Badge>
    * Update response parsing from `stepNumber` to `step_number`.
  * [`PATCH /interns/{internId}`](/docs/api/api-reference/interns/update-an-intern): properties `totalSteps` object removed<Badge stroke color="red" icon="triangle-exclamation" className="changelog-status-badge">Action required</Badge>
    * Update response parsing from `totalSteps` to `total_steps`.
  * [`PATCH /interns/{internId}`](/docs/api/api-reference/interns/update-an-intern): required `step_label` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * [`PATCH /interns/{internId}`](/docs/api/api-reference/interns/update-an-intern): required `step_number` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * [`PATCH /interns/{internId}`](/docs/api/api-reference/interns/update-an-intern): required `total_steps` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * [`PATCH /interns/{internId}`](/docs/api/api-reference/interns/update-an-intern): required `stepLabel` property removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * [`PATCH /interns/{internId}`](/docs/api/api-reference/interns/update-an-intern): required `stepNumber` property removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * [`PATCH /interns/{internId}`](/docs/api/api-reference/interns/update-an-intern): required `totalSteps` property removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

  ## Modified endpoints

  * [`POST /api/alpha/decisions`](/docs/api/api-reference/alphadecisions/submit-a-decisions-questions-and-answers-request): tags property\_added
  * [`POST /api/alpha/decisions`](/docs/api/api-reference/alphadecisions/submit-a-decisions-questions-and-answers-request): request schema updated; response schema updated
  * [`GET /interns`](/docs/api/api-reference/interns/list-interns): response schema updated
  * [`POST /interns`](/docs/api/api-reference/interns/create-an-intern): response schema updated
  * [`GET /interns/{internId}`](/docs/api/api-reference/interns/get-an-intern): response schema updated
  * [`PATCH /interns/{internId}`](/docs/api/api-reference/interns/update-an-intern): response schema updated

  ## Modified schemas

  * `DecisionsScoreQuestion`: minItems property\_added
    * Used by [`POST /api/alpha/decisions`](/docs/api/api-reference/decisions/submit-a-decisions-questions-and-answers-request)
  * `DecisionsChoiceQuestion`: new union variant added; description updated; type property\_removed
    * Used by [`POST /api/alpha/decisions`](/docs/api/api-reference/alphadecisions/submit-a-decisions-questions-and-answers-request)
  * `DecisionsNoulQuestion`:
    * new union variant added
    * property `false` updated
    * property `true` updated
    * description updated
    * type property\_removed
    * Used by [`POST /api/alpha/decisions`](/docs/api/api-reference/alphadecisions/submit-a-decisions-questions-and-answers-request)
  * `DecisionsScoreAnswer`: new union variant added; description updated; type property\_removed
    * Used by [`POST /api/alpha/decisions`](/docs/api/api-reference/alphadecisions/submit-a-decisions-questions-and-answers-request)
  * `DecisionsScoreQuestion`: new union variant added; description updated; type property\_removed
    * Used by [`POST /api/alpha/decisions`](/docs/api/api-reference/alphadecisions/submit-a-decisions-questions-and-answers-request)
  * `PublicEndpoint`: new property `decisions`
    * Used by [`GET /endpoints/zdr`](/docs/api/api-reference/endpoints/preview-the-impact-of-zdr-on-the-available-endpoints), [`GET /models/{author}/{slug}/endpoints`](/docs/api/api-reference/endpoints/list-all-endpoints-for-a-model)
  * `Intern`:

    * example modified
    * new property `created_at`
    * new property `last_failure_message`
    * new property `updated_at`
    * new property `workspace_id`
    * new property `step_label`
    * new property `step_number`
    * new property `total_steps`

      <Expandable title="4 endpoints using this schema">
        - [`GET /interns`](/docs/api/api-reference/interns/list-interns)
        - [`GET /interns/{internId}`](/docs/api/api-reference/interns/get-an-intern)
        - [`PATCH /interns/{internId}`](/docs/api/api-reference/interns/update-an-intern)
        - [`POST /interns`](/docs/api/api-reference/interns/create-an-intern)
      </Expandable>
  * `InternListResponse`: example modified
    * Used by [`GET /interns`](/docs/api/api-reference/interns/list-interns)
  * `VaultSecret`: description updated

      <Expandable title="5 endpoints using this schema">
        * [`GET /vault/interns/{internId}/secrets`](/docs/api/api-reference/vault/list-intern-secrets)
        * [`GET /vault/secrets`](/docs/api/api-reference/vault/list-workspace-secrets)
        * [`POST /vault/interns/{internId}/secrets/copy`](/docs/api/api-reference/vault/copy-workspace-secrets-to-an-intern)
        * [`PUT /vault/interns/{internId}/secrets/{name}`](/docs/api/api-reference/vault/store-an-intern-secret)
        * [`PUT /vault/secrets/{name}`](/docs/api/api-reference/vault/store-a-workspace-secret)
      </Expandable>
</Update>

<Update label="September 17, 2026" tags={["BYOK","Containers","Decisions","Interns","Models","Presets","Responses","Schemas"]} rss="2 new endpoints, 8 modified endpoints, 32 new schemas, 17 modified schemas.">
  ## New endpoints

  * [`POST /interns/{internId}/chat/completions`](/docs/api/api-reference/interns/stream-a-chat-completion-with-an-intern): Stream a chat completion with an intern
  * [`POST /api/alpha/decisions`](/docs/api/api-reference/decisions/submit-a-decisions-questions-and-answers-request): Submit a Decisions (questions and answers) request

  ## Modified endpoints

  * [`GET /containers/{container_id}/files`](/docs/api/api-reference/containers/list-container-files): description updated
  * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body): description updated
  * [`POST /responses`](/docs/api/api-reference/responses/create-a-response): description updated; response schema updated
  * [`GET /byok`](/docs/api/api-reference/byok/list-byok-provider-credentials): parameter `provider` updated
  * [`GET /models`](/docs/api/api-reference/models/list-all-models-and-their-properties): description updated
  * [`GET /models/count`](/docs/api/api-reference/models/get-total-count-of-available-models): description updated
  * [`GET /models/user`](/docs/api/api-reference/models/list-models-filtered-by-user-provider-preferences-privacy-settings-and-guardrails): description updated
  * [`POST /api/alpha/decisions`](/docs/api/api-reference/decisions/submit-a-decisions-questions-and-answers-request): x-speakeasy-name-override modified

  ## New schemas

  * `InternApprovalMode`
    * Used by [`POST /interns/{internId}/chat/completions`](/docs/api/api-reference/interns/stream-a-chat-completion-with-an-intern)
  * `InternChatAssistantMessage`
    * Used by [`POST /interns/{internId}/chat/completions`](/docs/api/api-reference/interns/stream-a-chat-completion-with-an-intern)
  * `InternChatChoice`
    * Used by [`POST /interns/{internId}/chat/completions`](/docs/api/api-reference/interns/stream-a-chat-completion-with-an-intern)
  * `InternChatCompletionChunk`
    * Used by [`POST /interns/{internId}/chat/completions`](/docs/api/api-reference/interns/stream-a-chat-completion-with-an-intern)
  * `InternChatCompletionRequest`
    * Used by [`POST /interns/{internId}/chat/completions`](/docs/api/api-reference/interns/stream-a-chat-completion-with-an-intern)
  * `InternChatDelta`
    * Used by [`POST /interns/{internId}/chat/completions`](/docs/api/api-reference/interns/stream-a-chat-completion-with-an-intern)
  * `InternChatDeveloperMessage`
    * Used by [`POST /interns/{internId}/chat/completions`](/docs/api/api-reference/interns/stream-a-chat-completion-with-an-intern)
  * `InternChatEchoedToolCall`
    * Used by [`POST /interns/{internId}/chat/completions`](/docs/api/api-reference/interns/stream-a-chat-completion-with-an-intern)
  * `InternChatEchoedToolCallFunction`
    * Used by [`POST /interns/{internId}/chat/completions`](/docs/api/api-reference/interns/stream-a-chat-completion-with-an-intern)
  * `InternChatError`
    * Used by [`POST /interns/{internId}/chat/completions`](/docs/api/api-reference/interns/stream-a-chat-completion-with-an-intern)
  * `InternChatErrorMetadata`
    * Used by [`POST /interns/{internId}/chat/completions`](/docs/api/api-reference/interns/stream-a-chat-completion-with-an-intern)
  * `InternChatErrorResponse`
    * Used by [`POST /interns/{internId}/chat/completions`](/docs/api/api-reference/interns/stream-a-chat-completion-with-an-intern)
  * `InternChatMessage`
    * Used by [`POST /interns/{internId}/chat/completions`](/docs/api/api-reference/interns/stream-a-chat-completion-with-an-intern)
  * `InternChatMessageContent`
    * Used by [`POST /interns/{internId}/chat/completions`](/docs/api/api-reference/interns/stream-a-chat-completion-with-an-intern)
  * `InternChatPromptTokensDetails`
    * Used by [`POST /interns/{internId}/chat/completions`](/docs/api/api-reference/interns/stream-a-chat-completion-with-an-intern)
  * `InternChatStreamError`
    * Used by [`POST /interns/{internId}/chat/completions`](/docs/api/api-reference/interns/stream-a-chat-completion-with-an-intern)
  * `InternChatStreamingResponse`
    * Used by [`POST /interns/{internId}/chat/completions`](/docs/api/api-reference/interns/stream-a-chat-completion-with-an-intern)
  * `InternChatSystemMessage`
    * Used by [`POST /interns/{internId}/chat/completions`](/docs/api/api-reference/interns/stream-a-chat-completion-with-an-intern)
  * `InternChatTextPart`
    * Used by [`POST /interns/{internId}/chat/completions`](/docs/api/api-reference/interns/stream-a-chat-completion-with-an-intern)
  * `InternChatToolCall`
    * Used by [`POST /interns/{internId}/chat/completions`](/docs/api/api-reference/interns/stream-a-chat-completion-with-an-intern)
  * `InternChatToolCallFunction`
    * Used by [`POST /interns/{internId}/chat/completions`](/docs/api/api-reference/interns/stream-a-chat-completion-with-an-intern)
  * `InternChatToolMessage`
    * Used by [`POST /interns/{internId}/chat/completions`](/docs/api/api-reference/interns/stream-a-chat-completion-with-an-intern)
  * `InternChatUsage`
    * Used by [`POST /interns/{internId}/chat/completions`](/docs/api/api-reference/interns/stream-a-chat-completion-with-an-intern)
  * `InternChatUserMessage`
    * Used by [`POST /interns/{internId}/chat/completions`](/docs/api/api-reference/interns/stream-a-chat-completion-with-an-intern)
  * `DecisionsChoiceAnswer`
    * Used by [`POST /api/alpha/decisions`](/docs/api/api-reference/decisions/submit-a-decisions-questions-and-answers-request)
  * `DecisionsChoiceQuestion`
    * Used by [`POST /api/alpha/decisions`](/docs/api/api-reference/decisions/submit-a-decisions-questions-and-answers-request)
  * `DecisionsNoulAnswer`
    * Used by [`POST /api/alpha/decisions`](/docs/api/api-reference/decisions/submit-a-decisions-questions-and-answers-request)
  * `DecisionsNoulQuestion`
    * Used by [`POST /api/alpha/decisions`](/docs/api/api-reference/decisions/submit-a-decisions-questions-and-answers-request)
  * `DecisionsRequest`
    * Used by [`POST /api/alpha/decisions`](/docs/api/api-reference/decisions/submit-a-decisions-questions-and-answers-request)
  * `DecisionsResponse`
    * Used by [`POST /api/alpha/decisions`](/docs/api/api-reference/decisions/submit-a-decisions-questions-and-answers-request)
  * `DecisionsScoreAnswer`
    * Used by [`POST /api/alpha/decisions`](/docs/api/api-reference/decisions/submit-a-decisions-questions-and-answers-request)
  * `DecisionsScoreQuestion`
    * Used by [`POST /api/alpha/decisions`](/docs/api/api-reference/decisions/submit-a-decisions-questions-and-answers-request)

  ## Modified schemas

  * `AnthropicImageBlockParam`: new union variant added
    * Used by [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message), [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
  * `ContainerFileListResponse`: description updated
    * Used by [`GET /containers/{container_id}/files`](/docs/api/api-reference/containers/list-container-files)
  * `InputImage`: description updated; new property `file_id`
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `STTResponse`: new property `confidence`
    * Used by [`POST /audio/transcriptions`](/docs/api/api-reference/stt/create-transcription)
  * `STTWord`: example modified; new property `confidence`
    * Used by [`POST /audio/transcriptions`](/docs/api/api-reference/stt/create-transcription)
  * `BYOKProviderSlug`: enum property\_added

      <Expandable title="4 endpoints using this schema">
        * [`GET /byok`](/docs/api/api-reference/byok/list-byok-provider-credentials)
        * [`GET /byok/{id}`](/docs/api/api-reference/byok/get-a-byok-provider-credential)
        * [`PATCH /byok/{id}`](/docs/api/api-reference/byok/update-a-byok-provider-credential)
        * [`POST /byok`](/docs/api/api-reference/byok/create-a-byok-provider-credential)
      </Expandable>
  * `GenerationResponse`: property `api_type` updated
    * Used by [`GET /generation`](/docs/api/api-reference/generations/get-request-&-usage-metadata-for-a-generation)
  * `ImageOutputModality`: enum property\_added
    * Used by [`GET /images/models`](/docs/api/api-reference/images/list-image-generation-models)
  * `MessagesStartEvent`: property `provider` updated
    * Used by [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
  * `OutputModality`: enum property\_added

      <Expandable title="5 endpoints using this schema">
        * [`GET /embeddings/models`](/docs/api/api-reference/embeddings/list-all-embeddings-models)
        * [`GET /model/{author}/{slug}`](/docs/api/api-reference/models/get-a-model-by-its-slug)
        * [`GET /models`](/docs/api/api-reference/models/list-all-models-and-their-properties)
        * [`GET /models/user`](/docs/api/api-reference/models/list-models-filtered-by-user-provider-preferences-privacy-settings-and-guardrails)
        * [`GET /models/{author}/{slug}/endpoints`](/docs/api/api-reference/endpoints/list-all-endpoints-for-a-model)
      </Expandable>
  * `ProviderName`: enum property\_added

      <Expandable title="12 endpoints using this schema">
        * [`GET /endpoints/zdr`](/docs/api/api-reference/endpoints/preview-the-impact-of-zdr-on-the-available-endpoints)
        * [`GET /models/{author}/{slug}/endpoints`](/docs/api/api-reference/endpoints/list-all-endpoints-for-a-model)
        * [`POST /api/alpha/decisions`](/docs/api/api-reference/decisions/submit-a-decisions-questions-and-answers-request)
        * [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion)
        * [`POST /embeddings`](/docs/api/api-reference/embeddings/submit-an-embedding-request)
        * [`POST /images`](/docs/api/api-reference/images/generate-an-image)
        * [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
        * [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
        * [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
        * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body)
        * [`POST /rerank`](/docs/api/api-reference/rerank/submit-a-rerank-request)
        * [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
      </Expandable>
  * `ProviderOptions`: new property `typesafe`

      <Expandable title="4 endpoints using this schema">
        * [`POST /audio/speech`](/docs/api/api-reference/tts/create-speech)
        * [`POST /audio/transcriptions`](/docs/api/api-reference/stt/create-transcription)
        * [`POST /images`](/docs/api/api-reference/images/generate-an-image)
        * [`POST /videos`](/docs/api/api-reference/video-generation/submit-a-video-generation-request)
      </Expandable>
  * `ProviderResponse`: enum property\_added
    * Used by [`GET /generation`](/docs/api/api-reference/generations/get-request-&-usage-metadata-for-a-generation)
  * `DecisionsRequest`: new union variant added; description updated
    * Used by [`POST /api/alpha/decisions`](/docs/api/api-reference/decisions/submit-a-decisions-questions-and-answers-request)
  * `VideoGenerationRequest`: new property `previous_job_id`
    * Used by [`POST /videos`](/docs/api/api-reference/video-generation/submit-a-video-generation-request)
  * `VideoGenerationResponse`: example modified; description updated
    * Used by [`GET /videos/{jobId}`](/docs/api/api-reference/video-generation/poll-video-generation-status), [`POST /videos`](/docs/api/api-reference/video-generation/submit-a-video-generation-request)
  * `ProviderOptions`: new property `unbiased`

      <Expandable title="4 endpoints using this schema">
        * [`POST /audio/speech`](/docs/api/api-reference/tts/create-speech)
        * [`POST /audio/transcriptions`](/docs/api/api-reference/stt/create-transcription)
        * [`POST /images`](/docs/api/api-reference/images/generate-an-image)
        * [`POST /videos`](/docs/api/api-reference/video-generation/submit-a-video-generation-request)
      </Expandable>
</Update>

<Update label="September 16, 2026" tags={["API Keys","Breaking","Embeddings","Rerank","STT","Schemas","Vault"]} rss="2 breaking changes, 7 new endpoints, 4 modified endpoints, 1 new response code, 9 new schemas, 8 modified schemas.">
  ## Breaking changes

  * [`GET /key`](/docs/api/api-reference/api-keys/get-current-api-key): required `free_model_daily_requests` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * [`GET /key`](/docs/api/api-reference/api-keys/get-current-api-key): required `allowed_data_regions` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

  ## New endpoints

  * [`GET /vault/interns/{internId}/secrets`](/docs/api/api-reference/vault/list-intern-secrets): List intern secrets
  * [`POST /vault/interns/{internId}/secrets/copy`](/docs/api/api-reference/vault/copy-workspace-secrets-to-an-intern): Copy workspace secrets to an intern
  * [`PUT /vault/interns/{internId}/secrets/{name}`](/docs/api/api-reference/vault/store-an-intern-secret): Store an intern secret
  * [`DELETE /vault/interns/{internId}/secrets/{name}`](/docs/api/api-reference/vault/delete-an-intern-secret): Delete an intern secret
  * [`GET /vault/secrets`](/docs/api/api-reference/vault/list-workspace-secrets): List workspace secrets
  * [`PUT /vault/secrets/{name}`](/docs/api/api-reference/vault/store-a-workspace-secret): Store a workspace secret
  * [`DELETE /vault/secrets/{name}`](/docs/api/api-reference/vault/delete-a-workspace-secret): Delete a workspace secret

  ## Modified endpoints

  * [`GET /key`](/docs/api/api-reference/api-keys/get-current-api-key): response schema updated
  * [`POST /embeddings`](/docs/api/api-reference/embeddings/submit-an-embedding-request): request schema updated
  * [`POST /rerank`](/docs/api/api-reference/rerank/submit-a-rerank-request): request schema updated
  * [`POST /audio/transcriptions`](/docs/api/api-reference/stt/create-transcription): request schema updated

  ## New response codes

  * [`POST /audio/transcriptions`](/docs/api/api-reference/stt/create-transcription): now returns `504`

  ## New schemas

  * `FreeModelDailyRequests`
    * Used by [`GET /key`](/docs/api/api-reference/api-keys/get-current-api-key)
  * `GatewayTimeoutResponse`
    * Used by [`POST /audio/transcriptions`](/docs/api/api-reference/stt/create-transcription)
  * `GatewayTimeoutResponseErrorData`
    * Used by [`POST /audio/transcriptions`](/docs/api/api-reference/stt/create-transcription)
  * `VaultSecret`

      <Expandable title="5 endpoints using this schema">
        * [`GET /vault/interns/{internId}/secrets`](/docs/api/api-reference/vault/list-intern-secrets)
        * [`GET /vault/secrets`](/docs/api/api-reference/vault/list-workspace-secrets)
        * [`POST /vault/interns/{internId}/secrets/copy`](/docs/api/api-reference/vault/copy-workspace-secrets-to-an-intern)
        * [`PUT /vault/interns/{internId}/secrets/{name}`](/docs/api/api-reference/vault/store-an-intern-secret)
        * [`PUT /vault/secrets/{name}`](/docs/api/api-reference/vault/store-a-workspace-secret)
      </Expandable>
  * `VaultSecretCopyRequest`
    * Used by [`POST /vault/interns/{internId}/secrets/copy`](/docs/api/api-reference/vault/copy-workspace-secrets-to-an-intern)
  * `VaultSecretCopyResponse`
    * Used by [`POST /vault/interns/{internId}/secrets/copy`](/docs/api/api-reference/vault/copy-workspace-secrets-to-an-intern)
  * `VaultSecretListResponse`
    * Used by [`GET /vault/interns/{internId}/secrets`](/docs/api/api-reference/vault/list-intern-secrets), [`GET /vault/secrets`](/docs/api/api-reference/vault/list-workspace-secrets)
  * `VaultSecretResponse`
    * Used by [`PUT /vault/interns/{internId}/secrets/{name}`](/docs/api/api-reference/vault/store-an-intern-secret), [`PUT /vault/secrets/{name}`](/docs/api/api-reference/vault/store-a-workspace-secret)
  * `VaultSecretWriteRequest`
    * Used by [`PUT /vault/interns/{internId}/secrets/{name}`](/docs/api/api-reference/vault/store-an-intern-secret), [`PUT /vault/secrets/{name}`](/docs/api/api-reference/vault/store-a-workspace-secret)

  ## Modified schemas

  * `OutputBashServerToolItem`: new property `error`; \$ref modified
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `OutputShellCallOutputItem`: description updated; new property `error`
    * Used by [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `OutputShellServerToolItem`: new property `error`; \$ref modified
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `ShellCallOutputItem`: new property `error`
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `ImageGenerationRequest`: new property `session_id`
    * Used by [`POST /images`](/docs/api/api-reference/images/generate-an-image)
  * `STTRequest`: new property `session_id`
    * Used by [`POST /audio/transcriptions`](/docs/api/api-reference/stt/create-transcription)
  * `SpeechRequest`: new property `session_id`
    * Used by [`POST /audio/speech`](/docs/api/api-reference/tts/create-speech)
  * `VideoGenerationRequest`: new property `session_id`
    * Used by [`POST /videos`](/docs/api/api-reference/video-generation/submit-a-video-generation-request)
</Update>

<Update label="September 15, 2026" tags={["Embeddings","Guardrails","Rerank","Schemas"]} rss="3 modified endpoints, 2 new response codes, 9 modified schemas.">
  ## Modified endpoints

  * [`POST /guardrails`](/docs/api/api-reference/guardrails/create-a-guardrail): description updated
  * [`POST /rerank`](/docs/api/api-reference/rerank/submit-a-rerank-request): request schema updated
  * [`POST /embeddings`](/docs/api/api-reference/embeddings/submit-an-embedding-request): request schema updated

  ## New response codes

  * [`PATCH /guardrails/{id}`](/docs/api/api-reference/guardrails/update-a-guardrail): now returns `403`
  * [`POST /guardrails/{id}/assignments/keys`](/docs/api/api-reference/guardrails/bulk-assign-keys-to-a-guardrail): now returns `403`

  ## Modified schemas

  * `ImageGenerationRequest`: enum property\_added
    * Used by [`POST /images`](/docs/api/api-reference/images/generate-an-image)
  * `ImageGenerationRequest`: maxLength property\_added
    * Used by [`POST /images`](/docs/api/api-reference/images/generate-an-image)
  * `STTRequest`: new property `user`
    * Used by [`POST /audio/transcriptions`](/docs/api/api-reference/stt/create-transcription)
  * `SpeechRequest`: new property `user`
    * Used by [`POST /audio/speech`](/docs/api/api-reference/tts/create-speech)
  * `VideoGenerationRequest`: new property `user`
    * Used by [`POST /videos`](/docs/api/api-reference/video-generation/submit-a-video-generation-request)
  * `ImageGenerationRequest`: new property `trace`
    * Used by [`POST /images`](/docs/api/api-reference/images/generate-an-image)
  * `STTRequest`: new property `trace`
    * Used by [`POST /audio/transcriptions`](/docs/api/api-reference/stt/create-transcription)
  * `SpeechRequest`: new property `trace`
    * Used by [`POST /audio/speech`](/docs/api/api-reference/tts/create-speech)
  * `VideoGenerationRequest`: new property `trace`
    * Used by [`POST /videos`](/docs/api/api-reference/video-generation/submit-a-video-generation-request)
</Update>

<Update label="September 14, 2026" tags={["BYOK","Video Generation"]} rss="1 modified endpoint, 2 new response codes, 5 modified schemas.">
  ## Modified endpoints

  * [`GET /byok`](/docs/api/api-reference/byok/list-byok-provider-credentials): parameter `provider` updated

  ## New response codes

  * [`GET /videos/{jobId}/content`](/docs/api/api-reference/video-generation/download-generated-video-content): now returns `409`
  * [`GET /videos/{jobId}/content`](/docs/api/api-reference/video-generation/download-generated-video-content): now returns `410`

  ## Modified schemas

  * `BYOKProviderSlug`: enum property\_added

      <Expandable title="4 endpoints using this schema">
        * [`GET /byok`](/docs/api/api-reference/byok/list-byok-provider-credentials)
        * [`GET /byok/{id}`](/docs/api/api-reference/byok/get-a-byok-provider-credential)
        * [`PATCH /byok/{id}`](/docs/api/api-reference/byok/update-a-byok-provider-credential)
        * [`POST /byok`](/docs/api/api-reference/byok/create-a-byok-provider-credential)
      </Expandable>
  * `MessagesStartEvent`: property `provider` updated
    * Used by [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
  * `ProviderName`: enum property\_added

      <Expandable title="11 endpoints using this schema">
        * [`GET /endpoints/zdr`](/docs/api/api-reference/endpoints/preview-the-impact-of-zdr-on-the-available-endpoints)
        * [`GET /models/{author}/{slug}/endpoints`](/docs/api/api-reference/endpoints/list-all-endpoints-for-a-model)
        * [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion)
        * [`POST /embeddings`](/docs/api/api-reference/embeddings/submit-an-embedding-request)
        * [`POST /images`](/docs/api/api-reference/images/generate-an-image)
        * [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
        * [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
        * [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
        * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body)
        * [`POST /rerank`](/docs/api/api-reference/rerank/submit-a-rerank-request)
        * [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
      </Expandable>
  * `ProviderOptions`: new property `assemblyai`

      <Expandable title="4 endpoints using this schema">
        * [`POST /audio/speech`](/docs/api/api-reference/tts/create-speech)
        * [`POST /audio/transcriptions`](/docs/api/api-reference/stt/create-transcription)
        * [`POST /images`](/docs/api/api-reference/images/generate-an-image)
        * [`POST /videos`](/docs/api/api-reference/video-generation/submit-a-video-generation-request)
      </Expandable>
  * `ProviderResponse`: enum property\_added
    * Used by [`GET /generation`](/docs/api/api-reference/generations/get-request-&-usage-metadata-for-a-generation)
</Update>

<Update label="September 11, 2026" tags={["BYOK","Presets"]} rss="2 modified endpoints, 12 modified schemas.">
  ## Modified endpoints

  * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body): request schema updated
  * [`GET /byok`](/docs/api/api-reference/byok/list-byok-provider-credentials): parameter `provider` updated

  ## Modified schemas

  * `CustomTool`: new property `async`
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `FusionPlugin`: example modified; description updated

      <Expandable title="6 endpoints using this schema">
        * [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion)
        * [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
        * [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
        * [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
        * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body)
        * [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
      </Expandable>
  * `FusionServerToolConfig`: example modified

      <Expandable title="4 endpoints using this schema">
        * [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion)
        * [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
        * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body)
        * [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
      </Expandable>
  * `FusionServerTool_OpenRouter`: example modified

      <Expandable title="4 endpoints using this schema">
        * [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion)
        * [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
        * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body)
        * [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
      </Expandable>
  * `NamespaceFunctionTool`: new property `async`
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `OpenAIResponseCustomToolCall`: new property `async`
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `OpenAIResponseFunctionToolCall`: new property `async`
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `OutputCustomToolCallItem`: new property `async`
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `OutputItemCustomToolCall`: new property `async`
    * Used by [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `OutputItemFunctionCall`: new property `async`
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `ResponsesErrorField`: enum property\_added
    * Used by [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `BYOKProviderSlug`: enum property\_added

      <Expandable title="4 endpoints using this schema">
        * [`GET /byok`](/docs/api/api-reference/byok/list-byok-provider-credentials)
        * [`GET /byok/{id}`](/docs/api/api-reference/byok/get-a-byok-provider-credential)
        * [`PATCH /byok/{id}`](/docs/api/api-reference/byok/update-a-byok-provider-credential)
        * [`POST /byok`](/docs/api/api-reference/byok/create-a-byok-provider-credential)
      </Expandable>
</Update>

<Update label="September 10, 2026" tags={["Breaking","Workspaces"]} rss="2 breaking changes, 4 new endpoints.">
  ## Breaking changes

  * `/workspaces/{id}/budgets`: endpoint object removed<Badge stroke color="red" icon="triangle-exclamation" className="changelog-status-badge">Action required</Badge>
    * SDK and Terraform callers: rename the path argument from `id` to `workspace_ref` (`workspaceRef` in camelCase clients). The URL value itself is unchanged.
  * `/workspaces/{id}/budgets/{interval}`: endpoint object removed<Badge stroke color="red" icon="triangle-exclamation" className="changelog-status-badge">Action required</Badge>
    * SDK and Terraform callers: rename the path argument from `id` to `workspace_ref` (`workspaceRef` in camelCase clients). The URL value itself is unchanged.

  ## New endpoints

  * [`GET /workspaces/{workspace_ref}/budgets`](/docs/api/api-reference/workspaces/list-workspace-budgets): List workspace budgets
  * [`GET /workspaces/{workspace_ref}/budgets/{interval}`](/docs/api/api-reference/workspaces/get-a-workspace-budget): Get a workspace budget
  * [`PUT /workspaces/{workspace_ref}/budgets/{interval}`](/docs/api/api-reference/workspaces/create-or-update-a-workspace-budget): Create or update a workspace budget
  * [`DELETE /workspaces/{workspace_ref}/budgets/{interval}`](/docs/api/api-reference/workspaces/delete-a-workspace-budget): Delete a workspace budget
</Update>

<Update label="September 9, 2026" tags={["BYOK","Breaking","Schemas"]} rss="2 breaking changes, 4 modified endpoints, 13 modified schemas.">
  ## Breaking changes

  * `BYOKKey`: required `is_byok_only` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

      <Expandable title="4 endpoints using this schema">
        * [`GET /byok`](/docs/api/api-reference/byok/list-byok-provider-credentials)
        * [`GET /byok/{id}`](/docs/api/api-reference/byok/get-a-byok-provider-credential)
        * [`PATCH /byok/{id}`](/docs/api/api-reference/byok/update-a-byok-provider-credential)
        * [`POST /byok`](/docs/api/api-reference/byok/create-a-byok-provider-credential)
      </Expandable>
  * `BYOKKey`: required `is_required` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

      <Expandable title="4 endpoints using this schema">
        * [`GET /byok`](/docs/api/api-reference/byok/list-byok-provider-credentials)
        * [`GET /byok/{id}`](/docs/api/api-reference/byok/get-a-byok-provider-credential)
        * [`PATCH /byok/{id}`](/docs/api/api-reference/byok/update-a-byok-provider-credential)
        * [`POST /byok`](/docs/api/api-reference/byok/create-a-byok-provider-credential)
      </Expandable>

  ## Modified endpoints

  * [`GET /byok`](/docs/api/api-reference/byok/list-byok-provider-credentials): parameter `provider` updated; response schema updated
  * [`POST /byok`](/docs/api/api-reference/byok/create-a-byok-provider-credential): response schema updated
  * [`GET /byok/{id}`](/docs/api/api-reference/byok/get-a-byok-provider-credential): response schema updated
  * [`PATCH /byok/{id}`](/docs/api/api-reference/byok/update-a-byok-provider-credential): response schema updated

  ## Modified schemas

  * `BYOKKey`:

    * example modified
    * new property `is_byok_only`
    * new property `is_required`
    * description updated

      <Expandable title="4 endpoints using this schema">
        - [`GET /byok`](/docs/api/api-reference/byok/list-byok-provider-credentials)
        - [`GET /byok/{id}`](/docs/api/api-reference/byok/get-a-byok-provider-credential)
        - [`PATCH /byok/{id}`](/docs/api/api-reference/byok/update-a-byok-provider-credential)
        - [`POST /byok`](/docs/api/api-reference/byok/create-a-byok-provider-credential)
      </Expandable>
  * `BYOKProviderSlug`: enum property\_added

      <Expandable title="4 endpoints using this schema">
        * [`GET /byok`](/docs/api/api-reference/byok/list-byok-provider-credentials)
        * [`GET /byok/{id}`](/docs/api/api-reference/byok/get-a-byok-provider-credential)
        * [`PATCH /byok/{id}`](/docs/api/api-reference/byok/update-a-byok-provider-credential)
        * [`POST /byok`](/docs/api/api-reference/byok/create-a-byok-provider-credential)
      </Expandable>
  * `CreateBYOKKeyRequest`: new property `is_byok_only`; new property `is_required`; description updated
    * Used by [`POST /byok`](/docs/api/api-reference/byok/create-a-byok-provider-credential)
  * `CreateBYOKKeyResponse`: example modified
    * Used by [`POST /byok`](/docs/api/api-reference/byok/create-a-byok-provider-credential)
  * `GetBYOKKeyResponse`: example modified
    * Used by [`GET /byok/{id}`](/docs/api/api-reference/byok/get-a-byok-provider-credential)
  * `ListBYOKKeysResponse`: example modified
    * Used by [`GET /byok`](/docs/api/api-reference/byok/list-byok-provider-credentials)
  * `MessagesStartEvent`: property `provider` updated
    * Used by [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
  * `ProviderName`: enum property\_added

      <Expandable title="11 endpoints using this schema">
        * [`GET /endpoints/zdr`](/docs/api/api-reference/endpoints/preview-the-impact-of-zdr-on-the-available-endpoints)
        * [`GET /models/{author}/{slug}/endpoints`](/docs/api/api-reference/endpoints/list-all-endpoints-for-a-model)
        * [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion)
        * [`POST /embeddings`](/docs/api/api-reference/embeddings/submit-an-embedding-request)
        * [`POST /images`](/docs/api/api-reference/images/generate-an-image)
        * [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
        * [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
        * [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
        * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body)
        * [`POST /rerank`](/docs/api/api-reference/rerank/submit-a-rerank-request)
        * [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
      </Expandable>
  * `ProviderOptions`: new property `near-ai`

      <Expandable title="4 endpoints using this schema">
        * [`POST /audio/speech`](/docs/api/api-reference/tts/create-speech)
        * [`POST /audio/transcriptions`](/docs/api/api-reference/stt/create-transcription)
        * [`POST /images`](/docs/api/api-reference/images/generate-an-image)
        * [`POST /videos`](/docs/api/api-reference/video-generation/submit-a-video-generation-request)
      </Expandable>
  * `ProviderResponse`: enum property\_added
    * Used by [`GET /generation`](/docs/api/api-reference/generations/get-request-&-usage-metadata-for-a-generation)
  * `UpdateBYOKKeyRequest`: new property `is_byok_only`; new property `is_required`; description updated
    * Used by [`PATCH /byok/{id}`](/docs/api/api-reference/byok/update-a-byok-provider-credential)
  * `UpdateBYOKKeyResponse`: example modified
    * Used by [`PATCH /byok/{id}`](/docs/api/api-reference/byok/update-a-byok-provider-credential)
  * `AnthropicThinkingBlockBinding`: new property `mismatch_behavior`
    * Used by [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message), [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
</Update>

<Update label="September 8, 2026" tags={["BYOK","Breaking","Schemas"]} rss="9 breaking changes, 1 modified endpoint, 4 modified schemas.">
  ## Breaking changes

  * `SandboxSleepAfterSeconds`: schema object removed<Badge stroke color="red" icon="triangle-exclamation" className="changelog-status-badge">Action required</Badge>
    * Remove `sleep_after_seconds` from bash and shell tool configuration. There is no replacement; container lifecycle now uses the service-managed behavior.
  * `BashServerToolConfig`: properties `sleep_after_seconds` object removed<Badge stroke color="red" icon="triangle-exclamation" className="changelog-status-badge">Action required</Badge>

    * Remove `sleep_after_seconds` from bash and shell tool configuration. There is no replacement; container lifecycle now uses the service-managed behavior.

      <Expandable title="6 endpoints using this schema">
        - [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion)
        - [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
        - [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
        - [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
        - [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body)
        - [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
      </Expandable>
  * `ShellServerToolConfig`: properties `sleep_after_seconds` object removed<Badge stroke color="red" icon="triangle-exclamation" className="changelog-status-badge">Action required</Badge>

    * Remove `sleep_after_seconds` from bash and shell tool configuration. There is no replacement; container lifecycle now uses the service-managed behavior.

      <Expandable title="4 endpoints using this schema">
        - [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
        - [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
        - [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body)
        - [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
      </Expandable>
  * `BYOKProviderSlug`: enum `ncompass` property removed<Badge stroke color="red" icon="triangle-exclamation" className="changelog-status-badge">Action required</Badge>

    * Remove `ncompass` from BYOK and provider configuration. The provider has been retired and has no replacement slug.

      <Expandable title="4 endpoints using this schema">
        - [`GET /byok`](/docs/api/api-reference/byok/list-byok-provider-credentials)
        - [`GET /byok/{id}`](/docs/api/api-reference/byok/get-a-byok-provider-credential)
        - [`PATCH /byok/{id}`](/docs/api/api-reference/byok/update-a-byok-provider-credential)
        - [`POST /byok`](/docs/api/api-reference/byok/create-a-byok-provider-credential)
      </Expandable>
  * `ProviderName`: enum `NCompass` property removed<Badge stroke color="red" icon="triangle-exclamation" className="changelog-status-badge">Action required</Badge>

    * Remove `ncompass` from BYOK and provider configuration. The provider has been retired and has no replacement slug.

      <Expandable title="11 endpoints using this schema">
        - [`GET /endpoints/zdr`](/docs/api/api-reference/endpoints/preview-the-impact-of-zdr-on-the-available-endpoints)
        - [`GET /models/{author}/{slug}/endpoints`](/docs/api/api-reference/endpoints/list-all-endpoints-for-a-model)
        - [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion)
        - [`POST /embeddings`](/docs/api/api-reference/embeddings/submit-an-embedding-request)
        - [`POST /images`](/docs/api/api-reference/images/generate-an-image)
        - [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
        - [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
        - [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
        - [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body)
        - [`POST /rerank`](/docs/api/api-reference/rerank/submit-a-rerank-request)
        - [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
      </Expandable>
  * [`GET /byok`](/docs/api/api-reference/byok/list-byok-provider-credentials): enum `ncompass` property removed<Badge stroke color="red" icon="triangle-exclamation" className="changelog-status-badge">Action required</Badge>
    * Remove `ncompass` from BYOK and provider configuration. The provider has been retired and has no replacement slug.
  * `BYOKProviderSlug`: enum `prime-intellect` property removed<Badge stroke color="red" icon="triangle-exclamation" className="changelog-status-badge">Action required</Badge>

    * Replace the provider slug and configuration key `prime-intellect` with `primeintellect`.

      <Expandable title="4 endpoints using this schema">
        - [`GET /byok`](/docs/api/api-reference/byok/list-byok-provider-credentials)
        - [`GET /byok/{id}`](/docs/api/api-reference/byok/get-a-byok-provider-credential)
        - [`PATCH /byok/{id}`](/docs/api/api-reference/byok/update-a-byok-provider-credential)
        - [`POST /byok`](/docs/api/api-reference/byok/create-a-byok-provider-credential)
      </Expandable>
  * `ProviderOptions`: properties `prime-intellect` object removed<Badge stroke color="red" icon="triangle-exclamation" className="changelog-status-badge">Action required</Badge>

    * Replace the provider slug and configuration key `prime-intellect` with `primeintellect`.

      <Expandable title="4 endpoints using this schema">
        - [`POST /audio/speech`](/docs/api/api-reference/tts/create-speech)
        - [`POST /audio/transcriptions`](/docs/api/api-reference/stt/create-transcription)
        - [`POST /images`](/docs/api/api-reference/images/generate-an-image)
        - [`POST /videos`](/docs/api/api-reference/video-generation/submit-a-video-generation-request)
      </Expandable>
  * [`GET /byok`](/docs/api/api-reference/byok/list-byok-provider-credentials): enum `prime-intellect` property removed<Badge stroke color="red" icon="triangle-exclamation" className="changelog-status-badge">Action required</Badge>
    * Replace the provider slug and configuration key `prime-intellect` with `primeintellect`.

  ## Modified endpoints

  * [`GET /byok`](/docs/api/api-reference/byok/list-byok-provider-credentials): parameter `provider` updated

  ## Modified schemas

  * `ChatDeveloperMessage`: new property `configuration_update`
    * Used by [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion), [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
  * `BYOKProviderSlug`: enum property\_added

      <Expandable title="4 endpoints using this schema">
        * [`GET /byok`](/docs/api/api-reference/byok/list-byok-provider-credentials)
        * [`GET /byok/{id}`](/docs/api/api-reference/byok/get-a-byok-provider-credential)
        * [`PATCH /byok/{id}`](/docs/api/api-reference/byok/update-a-byok-provider-credential)
        * [`POST /byok`](/docs/api/api-reference/byok/create-a-byok-provider-credential)
      </Expandable>
  * `ProviderOptions`: new property `primeintellect`

      <Expandable title="4 endpoints using this schema">
        * [`POST /audio/speech`](/docs/api/api-reference/tts/create-speech)
        * [`POST /audio/transcriptions`](/docs/api/api-reference/stt/create-transcription)
        * [`POST /images`](/docs/api/api-reference/images/generate-an-image)
        * [`POST /videos`](/docs/api/api-reference/video-generation/submit-a-video-generation-request)
      </Expandable>
  * `ImageGenerationRequest`: enum property\_added
    * Used by [`POST /images`](/docs/api/api-reference/images/generate-an-image)
</Update>

<Update label="September 7, 2026" tags={["Schemas"]} rss="1 modified schema.">
  ## Modified schemas

  * `STTInputAudio`: pattern property\_added
    * Used by [`POST /audio/transcriptions`](/docs/api/api-reference/stt/create-transcription)
</Update>

<Update label="September 5, 2026" tags={["Breaking","Observability"]} rss="18 breaking changes, 4 modified endpoints, 2 new schemas, 24 modified schemas.">
  ## Breaking changes

  * `ObservabilityArizeDestination`: required `regions` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityBraintrustDestination`: required `regions` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityClickhouseDestination`: required `regions` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityDatadogDestination`: required `regions` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityGrafanaDestination`: required `regions` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityLangfuseDestination`: required `regions` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityLangsmithDestination`: required `regions` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityNewrelicDestination`: required `regions` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityOpikDestination`: required `regions` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityOtelCollectorDestination`: required `regions` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityPosthogDestination`: required `regions` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityRampDestination`: required `regions` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityS3Destination`: required `regions` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilitySentryDestination`: required `regions` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilitySnowflakeDestination`: required `regions` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityWeaveDestination`: required `regions` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityWebhookDestination`: required `regions` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations): required `regions` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

  ## Modified endpoints

  * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations): response schema updated
  * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination): response schema updated
  * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination): response schema updated
  * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination): response schema updated

  ## New schemas

  * `ObservabilityDataRegion`

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityDataRegionInput`
    * Used by [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination), [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)

  ## Modified schemas

  * `CreateObservabilityDestinationRequest`: new property `regions`
    * Used by [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
  * `CreateObservabilityDestinationResponse`: example modified
    * Used by [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
  * `GetObservabilityDestinationResponse`: example modified
    * Used by [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
  * `ListObservabilityDestinationsResponse`: example modified
    * Used by [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
  * `ObservabilityArizeDestination`: example modified; new property `regions`

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityBraintrustDestination`: example modified; new property `regions`

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityClickhouseDestination`: example modified; new property `regions`

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityDatadogDestination`: example modified; new property `regions`

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityDestination`: example modified

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityGrafanaDestination`: example modified; new property `regions`

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityLangfuseDestination`: example modified; new property `regions`

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityLangsmithDestination`: example modified; new property `regions`

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityNewrelicDestination`: example modified; new property `regions`

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityOpikDestination`: example modified; new property `regions`

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityOtelCollectorDestination`: example modified; new property `regions`

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityPosthogDestination`: example modified; new property `regions`

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityRampDestination`: example modified; new property `regions`

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityS3Destination`: example modified; new property `regions`

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilitySentryDestination`: example modified; new property `regions`

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilitySnowflakeDestination`: example modified; new property `regions`

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityWeaveDestination`: example modified; new property `regions`

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityWebhookDestination`: example modified; new property `regions`

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `UpdateObservabilityDestinationRequest`: new property `regions`
    * Used by [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
  * `UpdateObservabilityDestinationResponse`: example modified
    * Used by [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
</Update>

<Update label="September 4, 2026" tags={["MCP","SCIM","Schemas"]} rss="2 new endpoints, 9 new schemas, 4 modified schemas.">
  ## New endpoints

  * [`POST /scim/sync-jobs`](/docs/api/api-reference/scim/start-a-scim-directory-sync): Start a SCIM directory sync
  * [`GET /scim/sync-jobs/{id}`](/docs/api/api-reference/scim/get-scim-directory-sync-status): Get SCIM directory sync status

  ## New schemas

  * `CreateScimSyncJobResponse`
    * Used by [`POST /scim/sync-jobs`](/docs/api/api-reference/scim/start-a-scim-directory-sync)
  * `GetScimSyncJobResponse`
    * Used by [`GET /scim/sync-jobs/{id}`](/docs/api/api-reference/scim/get-scim-directory-sync-status)
  * `ScimSyncJob`
    * Used by [`GET /scim/sync-jobs/{id}`](/docs/api/api-reference/scim/get-scim-directory-sync-status), [`POST /scim/sync-jobs`](/docs/api/api-reference/scim/start-a-scim-directory-sync)
  * `ConfigurationUpdateItem`
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `ConfigurationUpdateReasoning`

      <Expandable title="4 endpoints using this schema">
        * [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion)
        * [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
        * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body)
        * [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
      </Expandable>
  * `McpHttpError`
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `McpProtocolError`
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `McpToolCallError`
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `McpToolExecutionError`
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)

  ## Modified schemas

  * `ChatSystemMessage`: new property `configuration_update`
    * Used by [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion), [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
  * `McpCallItem`: \$ref modified
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `ResponsesErrorField`: enum property\_added
    * Used by [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `SandboxSleepAfterSeconds`: description updated; example modified

      <Expandable title="6 endpoints using this schema">
        * [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion)
        * [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
        * [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
        * [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
        * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body)
        * [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
      </Expandable>
</Update>

<Update label="September 3, 2026" tags={["API Keys","BYOK","Guardrails","OAuth"]} rss="2 new endpoints, 6 modified endpoints, 1 new response code, 4 new schemas, 5 modified schemas.">
  ## New endpoints

  * [`GET /oauth/jwks`](/docs/api/api-reference/oauth/openrouter-access-token-signing-keys): OpenRouter access token signing keys
  * [`POST /oauth/token`](/docs/api/api-reference/oauth/exchange-a-workload-identity-token): Exchange a workload identity token

  ## Modified endpoints

  * [`POST /keys`](/docs/api/api-reference/api-keys/create-a-new-api-key): description updated; request schema updated
  * [`DELETE /keys/{hash}`](/docs/api/api-reference/api-keys/delete-an-api-key): description updated
  * [`PATCH /keys/{hash}`](/docs/api/api-reference/api-keys/update-an-api-key): description updated
  * [`POST /guardrails`](/docs/api/api-reference/guardrails/create-a-guardrail): description updated; request schema updated
  * [`PATCH /guardrails/{id}`](/docs/api/api-reference/guardrails/update-a-guardrail): description updated
  * [`GET /byok`](/docs/api/api-reference/byok/list-byok-provider-credentials): parameter `provider` updated

  ## New response codes

  * [`PATCH /guardrails/{id}`](/docs/api/api-reference/guardrails/update-a-guardrail): now returns `409`

  ## New schemas

  * `OAuthErrorResponse`
    * Used by [`POST /oauth/token`](/docs/api/api-reference/oauth/exchange-a-workload-identity-token)
  * `OAuthJwks`
    * Used by [`GET /oauth/jwks`](/docs/api/api-reference/oauth/openrouter-access-token-signing-keys)
  * `TokenExchangeRequest`
    * Used by [`POST /oauth/token`](/docs/api/api-reference/oauth/exchange-a-workload-identity-token)
  * `TokenExchangeResponse`
    * Used by [`POST /oauth/token`](/docs/api/api-reference/oauth/exchange-a-workload-identity-token)

  ## Modified schemas

  * `BYOKProviderSlug`: enum property\_added

      <Expandable title="4 endpoints using this schema">
        * [`GET /byok`](/docs/api/api-reference/byok/list-byok-provider-credentials)
        * [`GET /byok/{id}`](/docs/api/api-reference/byok/get-a-byok-provider-credential)
        * [`PATCH /byok/{id}`](/docs/api/api-reference/byok/update-a-byok-provider-credential)
        * [`POST /byok`](/docs/api/api-reference/byok/create-a-byok-provider-credential)
      </Expandable>
  * `MessagesStartEvent`: property `provider` updated
    * Used by [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
  * `ProviderName`: enum property\_added

      <Expandable title="11 endpoints using this schema">
        * [`GET /endpoints/zdr`](/docs/api/api-reference/endpoints/preview-the-impact-of-zdr-on-the-available-endpoints)
        * [`GET /models/{author}/{slug}/endpoints`](/docs/api/api-reference/endpoints/list-all-endpoints-for-a-model)
        * [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion)
        * [`POST /embeddings`](/docs/api/api-reference/embeddings/submit-an-embedding-request)
        * [`POST /images`](/docs/api/api-reference/images/generate-an-image)
        * [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
        * [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
        * [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
        * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body)
        * [`POST /rerank`](/docs/api/api-reference/rerank/submit-a-rerank-request)
        * [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
      </Expandable>
  * `ProviderOptions`: new property `prime-intellect`

      <Expandable title="4 endpoints using this schema">
        * [`POST /audio/speech`](/docs/api/api-reference/tts/create-speech)
        * [`POST /audio/transcriptions`](/docs/api/api-reference/stt/create-transcription)
        * [`POST /images`](/docs/api/api-reference/images/generate-an-image)
        * [`POST /videos`](/docs/api/api-reference/video-generation/submit-a-video-generation-request)
      </Expandable>
  * `ProviderResponse`: enum property\_added
    * Used by [`GET /generation`](/docs/api/api-reference/generations/get-request-&-usage-metadata-for-a-generation)
</Update>

<Update label="September 2, 2026" tags={["API Keys","Breaking","Embeddings","Rerank","SCIM","STT","Schemas","TTS","Video Generation"]} rss="2 breaking changes, 2 modified endpoints, 7 new response codes, 1 new schema, 9 modified schemas.">
  ## Breaking changes

  * [`POST /keys`](/docs/api/api-reference/api-keys/create-a-new-api-key): properties `external_api_key` object removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * [`POST /keys`](/docs/api/api-reference/api-keys/create-a-new-api-key): properties `external_user` object removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

  ## Modified endpoints

  * [`POST /scim/group-mappings`](/docs/api/api-reference/scim/create-a-scim-group-mapping): description updated
  * [`POST /keys`](/docs/api/api-reference/api-keys/create-a-new-api-key): description updated

  ## New response codes

  * [`POST /audio/speech`](/docs/api/api-reference/tts/create-speech): now returns `403`
  * [`POST /audio/transcriptions`](/docs/api/api-reference/stt/create-transcription): now returns `403`
  * [`POST /embeddings`](/docs/api/api-reference/embeddings/submit-an-embedding-request): now returns `403`
  * [`POST /rerank`](/docs/api/api-reference/rerank/submit-a-rerank-request): now returns `403`
  * [`POST /videos`](/docs/api/api-reference/video-generation/submit-a-video-generation-request): now returns `403`
  * [`GET /videos/{jobId}`](/docs/api/api-reference/video-generation/poll-video-generation-status): now returns `403`
  * [`GET /videos/{jobId}/content`](/docs/api/api-reference/video-generation/download-generated-video-content): now returns `403`

  ## New schemas

  * `GuardrailDataRegion`

      <Expandable title="4 endpoints using this schema">
        * [`GET /guardrails`](/docs/api/api-reference/guardrails/list-guardrails)
        * [`GET /guardrails/{id}`](/docs/api/api-reference/guardrails/get-a-guardrail)
        * [`PATCH /guardrails/{id}`](/docs/api/api-reference/guardrails/update-a-guardrail)
        * [`POST /guardrails`](/docs/api/api-reference/guardrails/create-a-guardrail)
      </Expandable>

  ## Modified schemas

  * `CostDetails`: example modified; description updated

      <Expandable title="4 endpoints using this schema">
        * [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion)
        * [`POST /embeddings`](/docs/api/api-reference/embeddings/submit-an-embedding-request)
        * [`POST /images`](/docs/api/api-reference/images/generate-an-image)
        * [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
      </Expandable>
  * `Usage`: example modified
    * Used by [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `ChatContentVideoInput`: new property `processing`
    * Used by [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion), [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
  * `InputVideo`: new property `processing`
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `Legacy_ChatContentVideoInput`: new property `processing`
    * Used by [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion), [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
  * `OpenRouterMetadata`: example modified; new property `generation_time`
    * Used by [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion), [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `CreateGuardrailRequest`: new property `allowed_data_regions`
    * Used by [`POST /guardrails`](/docs/api/api-reference/guardrails/create-a-guardrail)
  * `Guardrail`: example modified; new property `allowed_data_regions`

      <Expandable title="4 endpoints using this schema">
        * [`GET /guardrails`](/docs/api/api-reference/guardrails/list-guardrails)
        * [`GET /guardrails/{id}`](/docs/api/api-reference/guardrails/get-a-guardrail)
        * [`PATCH /guardrails/{id}`](/docs/api/api-reference/guardrails/update-a-guardrail)
        * [`POST /guardrails`](/docs/api/api-reference/guardrails/create-a-guardrail)
      </Expandable>
  * `UpdateGuardrailRequest`: new property `allowed_data_regions`
    * Used by [`PATCH /guardrails/{id}`](/docs/api/api-reference/guardrails/update-a-guardrail)
</Update>

<Update label="September 1, 2026" tags={["BYOK","Breaking","Models","Schemas"]} rss="2 breaking changes, 4 modified endpoints, 7 new schemas, 9 modified schemas.">
  ## Breaking changes

  * `AnthropicThinkingBlockBinding`: required `prefix_mismatch_behavior` property removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
    * Used by [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message), [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
  * `AnthropicThinkingBlockBinding`: type `string` modified<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
    * Used by [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message), [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)

  ## Modified endpoints

  * [`GET /models`](/docs/api/api-reference/models/list-all-models-and-their-properties): description updated
  * [`GET /models/count`](/docs/api/api-reference/models/get-total-count-of-available-models): description updated
  * [`GET /models/user`](/docs/api/api-reference/models/list-models-filtered-by-user-provider-preferences-privacy-settings-and-guardrails): description updated
  * [`GET /byok`](/docs/api/api-reference/byok/list-byok-provider-credentials): parameter `provider` updated

  ## New schemas

  * `AnthropicInputTransformation`
    * Used by [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
  * `AnthropicMessageOutputConfig`
    * Used by [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message), [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
  * `AnthropicOutputEffort`
    * Used by [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message), [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
  * `AnthropicSystemClearAt`
    * Used by [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message), [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
  * `AnthropicThinkingBlockBinding`
    * Used by [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message), [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
  * `ORAnthropicServerToolUsage`
    * Used by [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
  * `AnthropicContainerSkill`
    * Used by [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)

  ## Modified schemas

  * `BYOKProviderSlug`: enum property\_added

      <Expandable title="4 endpoints using this schema">
        * [`GET /byok`](/docs/api/api-reference/byok/list-byok-provider-credentials)
        * [`GET /byok/{id}`](/docs/api/api-reference/byok/get-a-byok-provider-credential)
        * [`PATCH /byok/{id}`](/docs/api/api-reference/byok/update-a-byok-provider-credential)
        * [`POST /byok`](/docs/api/api-reference/byok/create-a-byok-provider-credential)
      </Expandable>
  * `AnthropicThinkingDisplay`: enum property\_added
    * Used by [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message), [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
  * `BaseMessagesResult`: new property `input_transformations`
    * Used by [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
  * `MessagesMessageParam`: new property `clear_at`; new property `output_config`
    * Used by [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message), [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
  * `MessagesStartEvent`: new property `input_transformations`
    * Used by [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
  * `MessagesDeltaEvent`: property `server_tool_use` updated
    * Used by [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
  * `AnthropicContainer`: example modified; new property `skills`
    * Used by [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
  * `AnthropicSystemClearAt`: enum property\_added
    * Used by [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message), [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
  * `AnthropicThinkingBlockBinding`: enum property\_added
    * Used by [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message), [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
</Update>

<Update label="August 31, 2026" tags={["Schemas"]} rss="4 modified schemas.">
  ## Modified schemas

  * `CostDetails`: example modified; new property `server_tool_cost`

      <Expandable title="4 endpoints using this schema">
        * [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion)
        * [`POST /embeddings`](/docs/api/api-reference/embeddings/submit-an-embedding-request)
        * [`POST /images`](/docs/api/api-reference/images/generate-an-image)
        * [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
      </Expandable>
  * `Usage`: example modified
    * Used by [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `OutputCustomToolCallItem`: example modified; new property `status`
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `OutputItemCustomToolCall`: example modified; new property `status`
    * Used by [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
</Update>

<Update label="August 30, 2026" tags={["API Keys","Analytics","OAuth"]} rss="3 modified endpoints.">
  ## Modified endpoints

  * [`POST /analytics/query`](/docs/api/api-reference/analytics/query-analytics-data): description updated; request schema updated
  * [`POST /auth/keys/code`](/docs/api/api-reference/oauth/create-authorization-code): description updated
  * [`POST /keys`](/docs/api/api-reference/api-keys/create-a-new-api-key): description updated
</Update>

<Update label="August 28, 2026" tags={["BYOK","Breaking","Containers","Models"]} rss="1 breaking change, 3 modified endpoints, 1 new schema, 7 modified schemas.">
  ## Breaking changes

  * `PublicEndpoint`: required `supports_tool_choice` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
    * Used by [`GET /endpoints/zdr`](/docs/api/api-reference/endpoints/preview-the-impact-of-zdr-on-the-available-endpoints), [`GET /models/{author}/{slug}/endpoints`](/docs/api/api-reference/endpoints/list-all-endpoints-for-a-model)

  ## Modified endpoints

  * [`POST /containers/{container_id}/files/{file_id}/promote`](/docs/api/api-reference/containers/promote-a-container-file-into-workspace-documents): description updated; response schema updated
  * [`GET /byok`](/docs/api/api-reference/byok/list-byok-provider-credentials): parameter `provider` updated
  * [`GET /models/user`](/docs/api/api-reference/models/list-models-filtered-by-user-provider-preferences-privacy-settings-and-guardrails): description updated; new parameter `output_modalities`

  ## New schemas

  * `ToolChoiceSupport`
    * Used by [`GET /endpoints/zdr`](/docs/api/api-reference/endpoints/preview-the-impact-of-zdr-on-the-available-endpoints), [`GET /models/{author}/{slug}/endpoints`](/docs/api/api-reference/endpoints/list-all-endpoints-for-a-model)

  ## Modified schemas

  * `PublicEndpoint`: example modified; new property `supports_tool_choice`
    * Used by [`GET /endpoints/zdr`](/docs/api/api-reference/endpoints/preview-the-impact-of-zdr-on-the-available-endpoints), [`GET /models/{author}/{slug}/endpoints`](/docs/api/api-reference/endpoints/list-all-endpoints-for-a-model)
  * `BYOKProviderSlug`: enum property\_added

      <Expandable title="4 endpoints using this schema">
        * [`GET /byok`](/docs/api/api-reference/byok/list-byok-provider-credentials)
        * [`GET /byok/{id}`](/docs/api/api-reference/byok/get-a-byok-provider-credential)
        * [`PATCH /byok/{id}`](/docs/api/api-reference/byok/update-a-byok-provider-credential)
        * [`POST /byok`](/docs/api/api-reference/byok/create-a-byok-provider-credential)
      </Expandable>
  * `MessagesStartEvent`: property `provider` updated
    * Used by [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
  * `ProviderName`: enum property\_added

      <Expandable title="11 endpoints using this schema">
        * [`GET /endpoints/zdr`](/docs/api/api-reference/endpoints/preview-the-impact-of-zdr-on-the-available-endpoints)
        * [`GET /models/{author}/{slug}/endpoints`](/docs/api/api-reference/endpoints/list-all-endpoints-for-a-model)
        * [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion)
        * [`POST /embeddings`](/docs/api/api-reference/embeddings/submit-an-embedding-request)
        * [`POST /images`](/docs/api/api-reference/images/generate-an-image)
        * [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
        * [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
        * [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
        * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body)
        * [`POST /rerank`](/docs/api/api-reference/rerank/submit-a-rerank-request)
        * [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
      </Expandable>
  * `ProviderOptions`: new property `ollama`

      <Expandable title="4 endpoints using this schema">
        * [`POST /audio/speech`](/docs/api/api-reference/tts/create-speech)
        * [`POST /audio/transcriptions`](/docs/api/api-reference/stt/create-transcription)
        * [`POST /images`](/docs/api/api-reference/images/generate-an-image)
        * [`POST /videos`](/docs/api/api-reference/video-generation/submit-a-video-generation-request)
      </Expandable>
  * `ProviderResponse`: enum property\_added
    * Used by [`GET /generation`](/docs/api/api-reference/generations/get-request-&-usage-metadata-for-a-generation)
  * `ProviderOptions`: new property `cosine`

      <Expandable title="4 endpoints using this schema">
        * [`POST /audio/speech`](/docs/api/api-reference/tts/create-speech)
        * [`POST /audio/transcriptions`](/docs/api/api-reference/stt/create-transcription)
        * [`POST /images`](/docs/api/api-reference/images/generate-an-image)
        * [`POST /videos`](/docs/api/api-reference/video-generation/submit-a-video-generation-request)
      </Expandable>
</Update>

<Update label="August 27, 2026" tags={["Schemas"]} rss="4 modified schemas.">
  ## Modified schemas

  * `CreateGuardrailResponse`: example modified
    * Used by [`POST /guardrails`](/docs/api/api-reference/guardrails/create-a-guardrail)
  * `GetGuardrailResponse`: example modified
    * Used by [`GET /guardrails/{id}`](/docs/api/api-reference/guardrails/get-a-guardrail)
  * `ListGuardrailsResponse`: example modified
    * Used by [`GET /guardrails`](/docs/api/api-reference/guardrails/list-guardrails)
  * `UpdateGuardrailResponse`: example modified
    * Used by [`PATCH /guardrails/{id}`](/docs/api/api-reference/guardrails/update-a-guardrail)
</Update>

<Update label="August 26, 2026" tags={["Breaking","Containers","Files","Schemas","Workspaces"]} rss="9 breaking changes, 5 modified endpoints, 4 modified schemas.">
  ## Breaking changes

  * [`GET /containers/{container_id}/files`](/docs/api/api-reference/containers/list-container-files): x-hidden `true` object removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * [`GET /containers/{container_id}/files/{file_id}`](/docs/api/api-reference/containers/retrieve-a-container-file): x-hidden `true` object removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * [`GET /containers/{container_id}/files/{file_id}/content`](/docs/api/api-reference/containers/download-container-file-content): x-hidden `true` object removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * [`POST /containers/{container_id}/files/{file_id}/promote`](/docs/api/api-reference/containers/promote-a-container-file-into-workspace-documents): x-hidden `true` object removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * [`GET /files`](/docs/api/api-reference/files/list-files): x-hidden `true` object removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * [`POST /files`](/docs/api/api-reference/files/upload-a-file): x-hidden `true` object removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * [`DELETE /files/{file_id}`](/docs/api/api-reference/files/delete-a-file): x-hidden `true` object removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * [`GET /files/{file_id}`](/docs/api/api-reference/files/get-file-metadata): x-hidden `true` object removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * [`GET /files/{file_id}/content`](/docs/api/api-reference/files/download-file-content): x-hidden `true` object removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

  ## Modified endpoints

  * [`DELETE /workspaces/{id}`](/docs/api/api-reference/workspaces/delete-a-workspace): description updated
  * [`DELETE /workspaces/{id}`](/docs/api/api-reference/workspaces/delete-a-workspace): new parameter `confirm_default_workspace_deletion`
  * [`DELETE /files/{file_id}`](/docs/api/api-reference/files/delete-a-file): parameter `file_id` updated
  * [`GET /files/{file_id}`](/docs/api/api-reference/files/get-file-metadata): parameter `file_id` updated
  * [`GET /files/{file_id}/content`](/docs/api/api-reference/files/download-file-content): parameter `file_id` updated

  ## Modified schemas

  * `ImageGenerationRequest`: new property `user`
    * Used by [`POST /images`](/docs/api/api-reference/images/generate-an-image)
  * `ShellCallOutputItem`: new property `container_id`; new property `files`
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `ContentFilterBuiltinEntry`: description updated

      <Expandable title="4 endpoints using this schema">
        * [`GET /guardrails`](/docs/api/api-reference/guardrails/list-guardrails)
        * [`GET /guardrails/{id}`](/docs/api/api-reference/guardrails/get-a-guardrail)
        * [`PATCH /guardrails/{id}`](/docs/api/api-reference/guardrails/update-a-guardrail)
        * [`POST /guardrails`](/docs/api/api-reference/guardrails/create-a-guardrail)
      </Expandable>
  * `ContentFilterBuiltinSlug`: enum property\_added

      <Expandable title="4 endpoints using this schema">
        * [`GET /guardrails`](/docs/api/api-reference/guardrails/list-guardrails)
        * [`GET /guardrails/{id}`](/docs/api/api-reference/guardrails/get-a-guardrail)
        * [`PATCH /guardrails/{id}`](/docs/api/api-reference/guardrails/update-a-guardrail)
        * [`POST /guardrails`](/docs/api/api-reference/guardrails/create-a-guardrail)
      </Expandable>
</Update>

<Update label="August 25, 2026" tags={["Containers","Rerank","STT","Schemas","TTS","Video Generation"]} rss="1 new endpoint, 4 new response codes, 2 new schemas, 10 modified schemas.">
  ## New endpoints

  * [`POST /containers/{container_id}/files/{file_id}/promote`](/docs/api/api-reference/containers/promote-a-container-file-into-workspace-documents): Promote a container file into workspace documents

  ## New response codes

  * [`POST /audio/speech`](/docs/api/api-reference/tts/create-speech): now returns `413`
  * [`POST /audio/transcriptions`](/docs/api/api-reference/stt/create-transcription): now returns `413`
  * [`POST /rerank`](/docs/api/api-reference/rerank/submit-a-rerank-request): now returns `413`
  * [`POST /videos`](/docs/api/api-reference/video-generation/submit-a-video-generation-request): now returns `413`

  ## New schemas

  * `ContainerNetworkPolicy`

      <Expandable title="6 endpoints using this schema">
        * [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion)
        * [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
        * [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
        * [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
        * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body)
        * [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
      </Expandable>
  * `ContainerFileIds`

      <Expandable title="6 endpoints using this schema">
        * [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion)
        * [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
        * [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
        * [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
        * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body)
        * [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
      </Expandable>

  ## Modified schemas

  * `ContainerAutoEnvironment`: new property `network_policy`

      <Expandable title="6 endpoints using this schema">
        * [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion)
        * [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
        * [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
        * [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
        * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body)
        * [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
      </Expandable>
  * `ContainerReferenceEnvironment`: new property `network_policy`

      <Expandable title="6 endpoints using this schema">
        * [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion)
        * [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
        * [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
        * [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
        * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body)
        * [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
      </Expandable>
  * `SandboxSleepAfterSeconds`: description updated

      <Expandable title="6 endpoints using this schema">
        * [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion)
        * [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
        * [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
        * [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
        * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body)
        * [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
      </Expandable>
  * `ContainerAutoEnvironment`: new property `file_ids`

      <Expandable title="6 endpoints using this schema">
        * [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion)
        * [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
        * [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
        * [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
        * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body)
        * [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
      </Expandable>
  * `ContainerReferenceEnvironment`: new property `file_ids`

      <Expandable title="6 endpoints using this schema">
        * [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion)
        * [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
        * [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
        * [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
        * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body)
        * [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
      </Expandable>
  * `PublicEndpoint`: description updated
    * Used by [`GET /endpoints/zdr`](/docs/api/api-reference/endpoints/preview-the-impact-of-zdr-on-the-available-endpoints), [`GET /models/{author}/{slug}/endpoints`](/docs/api/api-reference/endpoints/list-all-endpoints-for-a-model)
  * `TopProviderInfo`: description updated

      <Expandable title="4 endpoints using this schema">
        * [`GET /embeddings/models`](/docs/api/api-reference/embeddings/list-all-embeddings-models)
        * [`GET /model/{author}/{slug}`](/docs/api/api-reference/models/get-a-model-by-its-slug)
        * [`GET /models`](/docs/api/api-reference/models/list-all-models-and-their-properties)
        * [`GET /models/user`](/docs/api/api-reference/models/list-models-filtered-by-user-provider-preferences-privacy-settings-and-guardrails)
      </Expandable>
  * `CreateGuardrailRequest`: description updated
    * Used by [`POST /guardrails`](/docs/api/api-reference/guardrails/create-a-guardrail)
  * `ImagePricingEntry`: enum property\_added
    * Used by [`GET /images/models/{author}/{slug}/endpoints`](/docs/api/api-reference/images/list-endpoints-for-an-image-model)
  * `FusionPlugin`: description updated

      <Expandable title="6 endpoints using this schema">
        * [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion)
        * [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
        * [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
        * [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
        * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body)
        * [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
      </Expandable>
</Update>

<Update label="August 24, 2026" tags={["API Keys","Breaking","Containers","Schemas"]} rss="9 breaking changes, 6 new endpoints, 7 modified endpoints, 2 new schemas, 11 modified schemas.">
  ## Breaking changes

  * `ContainerReferenceEnvironment`: maxLength `20` modified<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

    * No action required for existing consumers. The maximum container reference length increased from 20 to 40 characters.

      <Expandable title="6 endpoints using this schema">
        - [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion)
        - [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
        - [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
        - [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
        - [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body)
        - [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
      </Expandable>
  * `/containers/{session_id}/files`: endpoint object removed<Badge stroke color="red" icon="triangle-exclamation" className="changelog-status-badge">Action required</Badge>
    * Use the corresponding `/containers/{container_id}/...` endpoint and pass the canonical `container_id` returned by a bash or shell tool result instead of the original session ID.
  * `/containers/{session_id}/files/{file_id}`: endpoint object removed<Badge stroke color="red" icon="triangle-exclamation" className="changelog-status-badge">Action required</Badge>
    * Use the corresponding `/containers/{container_id}/...` endpoint and pass the canonical `container_id` returned by a bash or shell tool result instead of the original session ID.
  * `/containers/{session_id}/files/{file_id}/content`: endpoint object removed<Badge stroke color="red" icon="triangle-exclamation" className="changelog-status-badge">Action required</Badge>
    * Use the corresponding `/containers/{container_id}/...` endpoint and pass the canonical `container_id` returned by a bash or shell tool result instead of the original session ID.
  * `ObservabilityDatadogDestination`: default `https://api.us5.datadoghq.com` modified<Badge stroke color="red" icon="triangle-exclamation" className="changelog-status-badge">Action required</Badge>

    * If your Datadog site is US5 and you relied on the omitted URL default, explicitly set `url` to `https://api.us5.datadoghq.com`. The new default is the US1 endpoint, `https://api.datadoghq.com`.

      <Expandable title="4 endpoints using this schema">
        - [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        - [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        - [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        - [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * [`GET /keys`](/docs/api/api-reference/api-keys/list-api-keys): required `external_user` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * [`POST /keys`](/docs/api/api-reference/api-keys/create-a-new-api-key): required `external_user` property added<Badge stroke color="red" icon="triangle-exclamation" className="changelog-status-badge">Action required</Badge>
    * Connect client-secret callers must include a non-empty `external_user` when creating a key. Management-key callers should continue to omit this Connect-only field.
  * [`GET /keys/{hash}`](/docs/api/api-reference/api-keys/get-a-single-api-key): required `external_user` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * [`PATCH /keys/{hash}`](/docs/api/api-reference/api-keys/update-an-api-key): required `external_user` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

  ## New endpoints

  * [`GET /containers/{session_id}/files`](/docs/api/api-reference/containers/list-container-files): List container files
  * [`GET /containers/{session_id}/files/{file_id}`](/docs/api/api-reference/containers/retrieve-a-container-file): Retrieve a container file
  * [`GET /containers/{session_id}/files/{file_id}/content`](/docs/api/api-reference/containers/download-container-file-content): Download container file content
  * [`GET /containers/{container_id}/files`](/docs/api/api-reference/containers/list-container-files): List container files
  * [`GET /containers/{container_id}/files/{file_id}`](/docs/api/api-reference/containers/retrieve-a-container-file): Retrieve a container file
  * [`GET /containers/{container_id}/files/{file_id}/content`](/docs/api/api-reference/containers/download-container-file-content): Download container file content

  ## Modified endpoints

  * [`POST /keys`](/docs/api/api-reference/api-keys/create-a-new-api-key): request schema updated
  * [`GET /keys`](/docs/api/api-reference/api-keys/list-api-keys): response schema updated
  * [`POST /keys`](/docs/api/api-reference/api-keys/create-a-new-api-key): description updated; request schema updated; response schema updated
  * [`GET /keys/{hash}`](/docs/api/api-reference/api-keys/get-a-single-api-key): response schema updated
  * [`PATCH /keys/{hash}`](/docs/api/api-reference/api-keys/update-an-api-key): response schema updated
  * [`DELETE /keys/{hash}`](/docs/api/api-reference/api-keys/delete-an-api-key): description updated
  * [`PATCH /keys/{hash}`](/docs/api/api-reference/api-keys/update-an-api-key): description updated

  ## New schemas

  * `ContainerFile`
    * Used by [`GET /containers/{session_id}/files`](/docs/api/api-reference/containers/list-container-files), [`GET /containers/{session_id}/files/{file_id}`](/docs/api/api-reference/containers/retrieve-a-container-file)
  * `ContainerFileListResponse`
    * Used by [`GET /containers/{session_id}/files`](/docs/api/api-reference/containers/list-container-files)

  ## Modified schemas

  * `ContainerFile`: description updated; example modified
    * Used by [`GET /containers/{container_id}/files`](/docs/api/api-reference/containers/list-container-files), [`GET /containers/{container_id}/files/{file_id}`](/docs/api/api-reference/containers/retrieve-a-container-file)
  * `ContainerReferenceEnvironment`: description updated; example modified

      <Expandable title="6 endpoints using this schema">
        * [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion)
        * [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
        * [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
        * [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
        * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body)
        * [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
      </Expandable>
  * `MessagesBashToolResultBlock`: new property `container_id`; new property `files`
    * Used by [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message), [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
  * `MessagesShellToolResultBlock`: new property `container_id`; new property `files`
    * Used by [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message), [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
  * `ORAnthropicBashToolResult`: new property `container_id`; new property `files`
    * Used by [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
  * `ORAnthropicShellToolResult`: new property `container_id`; new property `files`
    * Used by [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
  * `OutputBashServerToolItem`: new property `container_id`; new property `files`
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `OutputShellCallOutputItem`: new property `container_id`; new property `files`
    * Used by [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `OutputShellServerToolItem`: new property `container_id`; new property `files`
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `ObservabilityDatadogDestination`: example modified; property `url` updated

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `PricingOverride`: new property `utc_days`

      <Expandable title="6 endpoints using this schema">
        * [`GET /embeddings/models`](/docs/api/api-reference/embeddings/list-all-embeddings-models)
        * [`GET /endpoints/zdr`](/docs/api/api-reference/endpoints/preview-the-impact-of-zdr-on-the-available-endpoints)
        * [`GET /model/{author}/{slug}`](/docs/api/api-reference/models/get-a-model-by-its-slug)
        * [`GET /models`](/docs/api/api-reference/models/list-all-models-and-their-properties)
        * [`GET /models/user`](/docs/api/api-reference/models/list-models-filtered-by-user-provider-preferences-privacy-settings-and-guardrails)
        * [`GET /models/{author}/{slug}/endpoints`](/docs/api/api-reference/endpoints/list-all-endpoints-for-a-model)
      </Expandable>
</Update>

<Update label="August 22, 2026" tags={["Schemas"]} rss="2 new schemas, 3 modified schemas.">
  ## New schemas

  * `ToolSearchServerTool`

      <Expandable title="4 endpoints using this schema">
        * [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
        * [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
        * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body)
        * [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
      </Expandable>
  * `ToolSearchServerToolConfig`

      <Expandable title="4 endpoints using this schema">
        * [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
        * [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
        * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body)
        * [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
      </Expandable>

  ## Modified schemas

  * `AdditionalToolsItem`: new union variant added
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `MessagesRequest`: new union variant added
    * Used by [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message), [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
  * `ResponsesRequest`: new union variant added
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
</Update>

<Update label="August 21, 2026" tags={["BYOK","Embeddings"]} rss="3 modified endpoints, 2 new response codes, 7 modified schemas.">
  ## Modified endpoints

  * [`POST /byok`](/docs/api/api-reference/byok/create-a-byok-provider-credential): description updated
  * [`PATCH /byok/{id}`](/docs/api/api-reference/byok/update-a-byok-provider-credential): description updated
  * [`GET /byok`](/docs/api/api-reference/byok/list-byok-provider-credentials): parameter `provider` updated

  ## New response codes

  * [`POST /embeddings`](/docs/api/api-reference/embeddings/submit-an-embedding-request): now returns `408`
  * [`POST /embeddings`](/docs/api/api-reference/embeddings/submit-an-embedding-request): now returns `413`

  ## Modified schemas

  * `CreateBYOKKeyRequest`: new property `allowed_api_key_hashes`
    * Used by [`POST /byok`](/docs/api/api-reference/byok/create-a-byok-provider-credential)
  * `UpdateBYOKKeyRequest`: new property `allowed_api_key_hashes`
    * Used by [`PATCH /byok/{id}`](/docs/api/api-reference/byok/update-a-byok-provider-credential)
  * `BYOKProviderSlug`: enum property\_added

      <Expandable title="4 endpoints using this schema">
        * [`GET /byok`](/docs/api/api-reference/byok/list-byok-provider-credentials)
        * [`GET /byok/{id}`](/docs/api/api-reference/byok/get-a-byok-provider-credential)
        * [`PATCH /byok/{id}`](/docs/api/api-reference/byok/update-a-byok-provider-credential)
        * [`POST /byok`](/docs/api/api-reference/byok/create-a-byok-provider-credential)
      </Expandable>
  * `MessagesStartEvent`: property `provider` updated
    * Used by [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
  * `ProviderName`: enum property\_added

      <Expandable title="11 endpoints using this schema">
        * [`GET /endpoints/zdr`](/docs/api/api-reference/endpoints/preview-the-impact-of-zdr-on-the-available-endpoints)
        * [`GET /models/{author}/{slug}/endpoints`](/docs/api/api-reference/endpoints/list-all-endpoints-for-a-model)
        * [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion)
        * [`POST /embeddings`](/docs/api/api-reference/embeddings/submit-an-embedding-request)
        * [`POST /images`](/docs/api/api-reference/images/generate-an-image)
        * [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
        * [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
        * [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
        * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body)
        * [`POST /rerank`](/docs/api/api-reference/rerank/submit-a-rerank-request)
        * [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
      </Expandable>
  * `ProviderOptions`: new property `makora`

      <Expandable title="4 endpoints using this schema">
        * [`POST /audio/speech`](/docs/api/api-reference/tts/create-speech)
        * [`POST /audio/transcriptions`](/docs/api/api-reference/stt/create-transcription)
        * [`POST /images`](/docs/api/api-reference/images/generate-an-image)
        * [`POST /videos`](/docs/api/api-reference/video-generation/submit-a-video-generation-request)
      </Expandable>
  * `ProviderResponse`: enum property\_added
    * Used by [`GET /generation`](/docs/api/api-reference/generations/get-request-&-usage-metadata-for-a-generation)
</Update>

<Update label="August 20, 2026" tags={["Analytics","Breaking","Guardrails","Schemas"]} rss="3 breaking changes, 3 modified endpoints, 3 modified schemas.">
  ## Breaking changes

  * [`GET /analytics/meta`](/docs/api/api-reference/analytics/get-available-analytics-metrics-and-dimensions): tags `beta.Analytics` property removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * [`POST /analytics/query`](/docs/api/api-reference/analytics/query-analytics-data): tags `beta.Analytics` property removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * \$.tags: beta.Analytics object removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

  ## Modified endpoints

  * [`GET /analytics/meta`](/docs/api/api-reference/analytics/get-available-analytics-metrics-and-dimensions): tags property\_added
  * [`POST /analytics/query`](/docs/api/api-reference/analytics/query-analytics-data): tags property\_added
  * [`POST /guardrails`](/docs/api/api-reference/guardrails/create-a-guardrail): description updated

  ## Modified schemas

  * `ReasoningFormat`: enum property\_added

      <Expandable title="4 endpoints using this schema">
        * [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion)
        * [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
        * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body)
        * [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
      </Expandable>
  * `CreateGuardrailRequest`: description updated
    * Used by [`POST /guardrails`](/docs/api/api-reference/guardrails/create-a-guardrail)
  * `Guardrail`: description updated

      <Expandable title="4 endpoints using this schema">
        * [`GET /guardrails`](/docs/api/api-reference/guardrails/list-guardrails)
        * [`GET /guardrails/{id}`](/docs/api/api-reference/guardrails/get-a-guardrail)
        * [`PATCH /guardrails/{id}`](/docs/api/api-reference/guardrails/update-a-guardrail)
        * [`POST /guardrails`](/docs/api/api-reference/guardrails/create-a-guardrail)
      </Expandable>
</Update>

<Update label="August 19, 2026" tags={["BYOK","Breaking","Schemas"]} rss="New: manage BYOK credential restrictions via create/update. 15 breaking changes, 1 new schema, 7 modified schemas.">
  ## Breaking changes

  * `AdvisorNestedTool`: schema object removed<Badge stroke color="red" icon="triangle-exclamation" className="changelog-status-badge">Action required</Badge>
    * Remove `tools` and `max_tool_calls` from advisor tool configuration. Advisors no longer run nested tool-calling loops.
  * `AdvisorServerToolConfig`: properties `max_tool_calls` object removed<Badge stroke color="red" icon="triangle-exclamation" className="changelog-status-badge">Action required</Badge>

    * Remove `tools` and `max_tool_calls` from advisor tool configuration. Advisors no longer run nested tool-calling loops.

      <Expandable title="4 endpoints using this schema">
        - [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion)
        - [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
        - [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body)
        - [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
      </Expandable>
  * `AdvisorServerToolConfig`: properties `tools` object removed<Badge stroke color="red" icon="triangle-exclamation" className="changelog-status-badge">Action required</Badge>

    * Remove `tools` and `max_tool_calls` from advisor tool configuration. Advisors no longer run nested tool-calling loops.

      <Expandable title="4 endpoints using this schema">
        - [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion)
        - [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
        - [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body)
        - [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
      </Expandable>
  * `VideoModel`: required `creativity` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
    * Used by [`GET /videos/models`](/docs/api/api-reference/video-generation/list-all-video-generation-models)
  * `VideoModel`: required `upscale_factor` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
    * Used by [`GET /videos/models`](/docs/api/api-reference/video-generation/list-all-video-generation-models)
  * `CustomToolCallItem`: properties `call_id` object removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `CustomToolCallItem`: properties `id` object removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `CustomToolCallItem`: properties `input` object removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `CustomToolCallItem`: properties `name` object removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `CustomToolCallItem`: properties `namespace` object removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `CustomToolCallItem`: properties `type` object removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `CustomToolCallItem`: required `call_id` property removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `CustomToolCallItem`: required `input` property removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `CustomToolCallItem`: required `name` property removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `CustomToolCallItem`: required `type` property removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)

  ## New capabilities

  * BYOK API: manage credential restrictions (`allowed_models`, `allowed_user_ids`, `allowed_api_key_hashes`) via create/update. See the [BYOK guide](/docs/guides/overview/auth/byok#managing-filters-via-the-management-api) for examples and validation rules.

  ## New schemas

  * `FailableToolCallStatus`
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)

  ## Modified schemas

  * `AdvisorServerToolConfig`: description updated

      <Expandable title="4 endpoints using this schema">
        * [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion)
        * [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
        * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body)
        * [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
      </Expandable>
  * `AdvisorServerTool_OpenRouter`: description updated

      <Expandable title="4 endpoints using this schema">
        * [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion)
        * [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
        * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body)
        * [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
      </Expandable>
  * `VideoGenerationRequest`: new property `creativity`; new property `upscale_factor`
    * Used by [`POST /videos`](/docs/api/api-reference/video-generation/submit-a-video-generation-request)
  * `VideoModel`: new property `creativity`; new property `upscale_factor`
    * Used by [`GET /videos/models`](/docs/api/api-reference/video-generation/list-all-video-generation-models)
  * `OutputAdvisorServerToolItem`: description updated; \$ref modified
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `OutputSubagentServerToolItem`: description updated; \$ref modified
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `CustomToolCallItem`: allOf object\_added; type property\_removed
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
</Update>

<Update label="August 18, 2026" tags={["Breaking","Schemas","beta.Analytics"]} rss="1 breaking change, 1 modified endpoint, 1 modified schema.">
  ## Breaking changes

  * [`POST /analytics/query`](/docs/api/api-reference/betaanalytics/query-analytics-data): maxItems `10` modified<Badge stroke color="red" icon="triangle-exclamation" className="changelog-status-badge">Action required</Badge>
    * Limit `classifier_dimensions.dimension_names` to at most two entries. Split requests that previously queried three or more classifier dimensions.

  ## Modified endpoints

  * [`POST /analytics/query`](/docs/api/api-reference/betaanalytics/query-analytics-data): description updated

  ## Modified schemas

  * `ProviderOptions`: new property `anthropic/2`

      <Expandable title="4 endpoints using this schema">
        * [`POST /audio/speech`](/docs/api/api-reference/tts/create-speech)
        * [`POST /audio/transcriptions`](/docs/api/api-reference/stt/create-transcription)
        * [`POST /images`](/docs/api/api-reference/images/generate-an-image)
        * [`POST /videos`](/docs/api/api-reference/video-generation/submit-a-video-generation-request)
      </Expandable>
</Update>

<Update label="August 17, 2026" tags={["Breaking","Presets","Schemas","Workspaces"]} rss="3 breaking changes, 1 modified endpoint, 2 new schemas, 11 modified schemas.">
  ## Breaking changes

  * spec: string modified<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * `OutputBashServerToolItem`: type `string` modified<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body): type `string` modified<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

  ## Modified endpoints

  * [`DELETE /workspaces/{id}`](/docs/api/api-reference/workspaces/delete-a-workspace): description updated

  ## New schemas

  * `OutputShellServerToolItem`
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `ShellCallOutputContent`
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)

  ## Modified schemas

  * `OpenAIResponseFunctionToolCall`: new property `subagent_id`; new property `subagent_items`
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `OutputSubagentServerToolItem`: new property `call_id`
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `SubagentReasoning`: description updated

      <Expandable title="4 endpoints using this schema">
        * [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion)
        * [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
        * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body)
        * [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
      </Expandable>
  * `SubagentServerToolConfig`: new property `inherit_functions`; new property `inherited_function_names`; description updated

      <Expandable title="4 endpoints using this schema">
        * [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion)
        * [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
        * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body)
        * [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
      </Expandable>
  * `OutputFilesServerToolItem`: new property `arguments`; new property `call_id`
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `OutputItems`: new union variant added
    * Used by [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `OutputShellCallItem`: new property `arguments`
    * Used by [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `OutputShellCallOutputItem`: \$ref modified
    * Used by [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `ShellCallItem`: new property `arguments`
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `ShellCallOutputItem`: example modified; \$ref modified
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `ProviderOptions`: new property `amazon-bedrock/claude-on-aws`

      <Expandable title="4 endpoints using this schema">
        * [`POST /audio/speech`](/docs/api/api-reference/tts/create-speech)
        * [`POST /audio/transcriptions`](/docs/api/api-reference/stt/create-transcription)
        * [`POST /images`](/docs/api/api-reference/images/generate-an-image)
        * [`POST /videos`](/docs/api/api-reference/video-generation/submit-a-video-generation-request)
      </Expandable>
</Update>

<Update label="August 14, 2026" tags={["Datasets","Schemas"]} rss="3 modified endpoints, 2 modified schemas.">
  ## Modified endpoints

  * [`GET /datasets/app-rankings`](/docs/api/api-reference/datasets/top-apps-by-token-usage): description updated
  * [`GET /datasets/rankings-daily`](/docs/api/api-reference/datasets/daily-token-totals-for-top-50-models): description updated
  * [`GET /datasets/session-cost`](/docs/api/api-reference/datasets/cost-per-session-by-harness-and-model): description updated

  ## Modified schemas

  * `AnthropicRefusalStopDetails`: enum property\_added
    * Used by [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
  * `OutputFusionServerToolItem`: description updated
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
</Update>

<Update label="August 13, 2026" tags={["Anthropic Messages","Breaking","Generations","Schemas","Workspaces"]} rss="2 breaking changes, 3 modified endpoints, 1 new schema, 2 modified schemas.">
  ## Breaking changes

  * `MessagesErrorDetail`: schema object removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * `MessagesErrorResponse`: schema object removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

  ## Modified endpoints

  * [`GET /generation/content`](/docs/api/api-reference/generations/get-stored-prompt-completion-and-error-content-for-a-generation): response schema updated
  * [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message): response schema updated; description updated
  * [`DELETE /workspaces/{id}`](/docs/api/api-reference/workspaces/delete-a-workspace): description updated

  ## New schemas

  * `AnthropicMessagesErrorResponse`
    * Used by [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)

  ## Modified schemas

  * `ImageGenerationRequest`: description updated
    * Used by [`POST /images`](/docs/api/api-reference/images/generate-an-image)
  * `WebSearchMode`: description updated

      <Expandable title="6 endpoints using this schema">
        * [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion)
        * [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
        * [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
        * [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
        * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body)
        * [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
      </Expandable>
</Update>

<Update label="August 12, 2026" tags={["Datasets","Models","Workspaces"]} rss="1 new endpoint, 3 modified endpoints, 3 new schemas, 2 modified schemas.">
  ## New endpoints

  * [`GET /datasets/session-cost`](/docs/api/api-reference/datasets/cost-per-session-by-harness-and-model): Cost per session by harness and model

  ## Modified endpoints

  * [`GET /models`](/docs/api/api-reference/models/list-all-models-and-their-properties): description updated; parameter `region` updated
  * [`GET /models/user`](/docs/api/api-reference/models/list-models-filtered-by-user-provider-preferences-privacy-settings-and-guardrails): description updated
  * [`DELETE /workspaces/{id}`](/docs/api/api-reference/workspaces/delete-a-workspace): description updated; new parameter `confirm_default_settings_deletion`

  ## New schemas

  * `SessionCostItem`
    * Used by [`GET /datasets/session-cost`](/docs/api/api-reference/datasets/cost-per-session-by-harness-and-model)
  * `SessionCostMeta`
    * Used by [`GET /datasets/session-cost`](/docs/api/api-reference/datasets/cost-per-session-by-harness-and-model)
  * `SessionCostResponse`
    * Used by [`GET /datasets/session-cost`](/docs/api/api-reference/datasets/cost-per-session-by-harness-and-model)

  ## Modified schemas

  * `AutoBetaRouterPlugin`: description updated; maxItems property\_added; maxLength property\_added

      <Expandable title="6 endpoints using this schema">
        * [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion)
        * [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
        * [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
        * [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
        * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body)
        * [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
      </Expandable>
  * `AutoRouterPlugin`: description updated; maxItems property\_added; maxLength property\_added

      <Expandable title="6 endpoints using this schema">
        * [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion)
        * [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
        * [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
        * [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
        * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body)
        * [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
      </Expandable>
</Update>

<Update label="August 11, 2026" tags={["BYOK","Benchmarks","Breaking","Generations","Schemas"]} rss="2 breaking changes, 3 modified endpoints, 4 new schemas, 14 modified schemas.">
  ## Breaking changes

  * `UnifiedBenchmarksResponse`: discriminator `discriminator` object removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
    * Used by [`GET /benchmarks`](/docs/api/api-reference/benchmarks/list-benchmarks)
  * `GenerationContentData`: required `error` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
    * Used by [`GET /generation/content`](/docs/api/api-reference/generations/get-stored-prompt-completion-and-error-content-for-a-generation)

  ## Modified endpoints

  * [`GET /benchmarks`](/docs/api/api-reference/benchmarks/list-benchmarks):
    * description updated
    * new parameter `benchmark_type`
    * new parameter `include_run_config`
    * new parameter `search_engine`
    * new parameter `search_surface`
    * parameter `task_type` updated
  * [`GET /generation/content`](/docs/api/api-reference/generations/get-stored-prompt-completion-and-error-content-for-a-generation): description updated; response schema updated
  * [`GET /byok`](/docs/api/api-reference/byok/list-byok-provider-credentials): parameter `provider` updated

  ## New schemas

  * `UnifiedBenchmarksSearchItem`
    * Used by [`GET /benchmarks`](/docs/api/api-reference/benchmarks/list-benchmarks)
  * `UnifiedBenchmarksSearchRunConfig`
    * Used by [`GET /benchmarks`](/docs/api/api-reference/benchmarks/list-benchmarks)
  * `GenerationContentError`
    * Used by [`GET /generation/content`](/docs/api/api-reference/generations/get-stored-prompt-completion-and-error-content-for-a-generation)
  * `GenerationContentErrorAttempt`
    * Used by [`GET /generation/content`](/docs/api/api-reference/generations/get-stored-prompt-completion-and-error-content-for-a-generation)

  ## Modified schemas

  * `OutputFusionServerToolItem`: description updated
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `WebSearchMode`: description updated

      <Expandable title="6 endpoints using this schema">
        * [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion)
        * [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
        * [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
        * [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
        * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body)
        * [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
      </Expandable>
  * `MessagesStartEvent`: property `usage` updated
    * Used by [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
  * `UnifiedBenchmarksResponse`: new union variant added
    * Used by [`GET /benchmarks`](/docs/api/api-reference/benchmarks/list-benchmarks)
  * `GenerationContentData`: description updated; example modified; new property `error`
    * Used by [`GET /generation/content`](/docs/api/api-reference/generations/get-stored-prompt-completion-and-error-content-for-a-generation)
  * `GenerationContentResponse`: example modified
    * Used by [`GET /generation/content`](/docs/api/api-reference/generations/get-stored-prompt-completion-and-error-content-for-a-generation)
  * `AppRankingsResponse`: example modified
    * Used by [`GET /datasets/app-rankings`](/docs/api/api-reference/datasets/top-apps-by-token-usage)
  * `RankingsDailyMeta`: example modified
    * Used by [`GET /datasets/app-rankings`](/docs/api/api-reference/datasets/top-apps-by-token-usage), [`GET /datasets/rankings-daily`](/docs/api/api-reference/datasets/daily-token-totals-for-top-50-models)
  * `RankingsDailyResponse`: example modified
    * Used by [`GET /datasets/rankings-daily`](/docs/api/api-reference/datasets/daily-token-totals-for-top-50-models)
  * `BYOKProviderSlug`: enum property\_added

      <Expandable title="4 endpoints using this schema">
        * [`GET /byok`](/docs/api/api-reference/byok/list-byok-provider-credentials)
        * [`GET /byok/{id}`](/docs/api/api-reference/byok/get-a-byok-provider-credential)
        * [`PATCH /byok/{id}`](/docs/api/api-reference/byok/update-a-byok-provider-credential)
        * [`POST /byok`](/docs/api/api-reference/byok/create-a-byok-provider-credential)
      </Expandable>
  * `MessagesStartEvent`: property `provider` updated
    * Used by [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
  * `ProviderName`: enum property\_added

      <Expandable title="11 endpoints using this schema">
        * [`GET /endpoints/zdr`](/docs/api/api-reference/endpoints/preview-the-impact-of-zdr-on-the-available-endpoints)
        * [`GET /models/{author}/{slug}/endpoints`](/docs/api/api-reference/endpoints/list-all-endpoints-for-a-model)
        * [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion)
        * [`POST /embeddings`](/docs/api/api-reference/embeddings/submit-an-embedding-request)
        * [`POST /images`](/docs/api/api-reference/images/generate-an-image)
        * [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
        * [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
        * [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
        * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body)
        * [`POST /rerank`](/docs/api/api-reference/rerank/submit-a-rerank-request)
        * [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
      </Expandable>
  * `ProviderOptions`: new property `databricks`

      <Expandable title="4 endpoints using this schema">
        * [`POST /audio/speech`](/docs/api/api-reference/tts/create-speech)
        * [`POST /audio/transcriptions`](/docs/api/api-reference/stt/create-transcription)
        * [`POST /images`](/docs/api/api-reference/images/generate-an-image)
        * [`POST /videos`](/docs/api/api-reference/video-generation/submit-a-video-generation-request)
      </Expandable>
  * `ProviderResponse`: enum property\_added
    * Used by [`GET /generation`](/docs/api/api-reference/generations/get-request-&-usage-metadata-for-a-generation)
</Update>

<Update label="August 10, 2026" tags={["Breaking","Presets","Schemas"]} rss="26 breaking changes, 1 modified endpoint, 14 new schemas, 7 modified schemas.">
  ## Breaking changes

  * spec: additionalProperties object added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * `CodeInterpreterCallItem`: properties `code` object removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `CodeInterpreterCallItem`: properties `container_id` object removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `CodeInterpreterCallItem`: properties `id` object removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `CodeInterpreterCallItem`: properties `outputs` object removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `CodeInterpreterCallItem`: properties `status` object removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `CodeInterpreterCallItem`: properties `type` object removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `CodeInterpreterCallItem`: required `code` property removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `CodeInterpreterCallItem`: required `container_id` property removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `CodeInterpreterCallItem`: required `id` property removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `CodeInterpreterCallItem`: required `outputs` property removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `CodeInterpreterCallItem`: required `status` property removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `CodeInterpreterCallItem`: required `type` property removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `OutputItemWebSearchCall`: additionalProperties `additionalProperties` object added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body): properties `code` object removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body): properties `container_id` object removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body): properties `id` object removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body): properties `outputs` object removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body): properties `status` object removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body): properties `type` object removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body): required `code` property removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body): required `container_id` property removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body): required `id` property removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body): required `outputs` property removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body): required `status` property removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body): required `type` property removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

  ## Modified endpoints

  * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body): request schema updated

  ## New schemas

  * `CodeInterpreterCallCodeDeltaEvent`
    * Used by [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `CodeInterpreterCallCodeDoneEvent`
    * Used by [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `CodeInterpreterCallCompletedEvent`
    * Used by [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `CodeInterpreterCallInProgressEvent`
    * Used by [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `CodeInterpreterCallInterpretingEvent`
    * Used by [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `CodeInterpreterFileOutput`
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `CodeInterpreterImageOutput`
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `CodeInterpreterLogsOutput`
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `OpenAIResponsesCodeInterpreterCallCodeDelta`
    * Used by [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `OpenAIResponsesCodeInterpreterCallCodeDone`
    * Used by [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `OpenAIResponsesCodeInterpreterCallCompleted`
    * Used by [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `OpenAIResponsesCodeInterpreterCallInProgress`
    * Used by [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `OpenAIResponsesCodeInterpreterCallInterpreting`
    * Used by [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `OutputItemCodeInterpreterCall`
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)

  ## Modified schemas

  * `AutoBetaRouterPlugin`: description updated

      <Expandable title="6 endpoints using this schema">
        * [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion)
        * [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
        * [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
        * [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
        * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body)
        * [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
      </Expandable>
  * `AutoRouterPlugin`: example modified; description updated

      <Expandable title="6 endpoints using this schema">
        * [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion)
        * [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
        * [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
        * [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
        * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body)
        * [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
      </Expandable>
  * `BaseResponsesResult`: new union variant added
    * Used by [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `CodeInterpreterCallItem`: allOf object\_added; type property\_removed
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `OutputItemAddedEvent`: new union variant added
    * Used by [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `OutputItemDoneEvent`: new union variant added
    * Used by [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `StreamEvents`: new union variant added
    * Used by [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
</Update>

<Update label="August 9, 2026" tags={["Schemas"]} rss="1 modified schema.">
  ## Modified schemas

  * `FusionServerToolConfig`: description updated

      <Expandable title="4 endpoints using this schema">
        * [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion)
        * [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
        * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body)
        * [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
      </Expandable>
</Update>

<Update label="August 8, 2026" tags={["Schemas"]} rss="2 modified schemas.">
  ## Modified schemas

  * `VideoModel`: enum property\_added
    * Used by [`GET /videos/models`](/docs/api/api-reference/video-generation/list-all-video-generation-models)
  * `FusionServerToolConfig`: description updated

      <Expandable title="4 endpoints using this schema">
        * [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion)
        * [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
        * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body)
        * [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
      </Expandable>
</Update>

<Update label="August 7, 2026" tags={["BYOK","Breaking","Observability","Schemas"]} rss="56 breaking changes, 6 modified endpoints, 1 new response code, 1 new schema, 40 modified schemas.">
  ## Breaking changes

  * `BYOKKey`: type `string` modified<Badge stroke color="red" icon="triangle-exclamation" className="changelog-status-badge">Action required</Badge>

    * Allow `workspace_id` to be `null` in BYOK responses. A null value identifies a global credential that is usable across every workspace; do not substitute the default workspace.

      <Expandable title="4 endpoints using this schema">
        - [`GET /byok`](/docs/api/api-reference/byok/list-byok-provider-credentials)
        - [`GET /byok/{id}`](/docs/api/api-reference/byok/get-a-byok-provider-credential)
        - [`PATCH /byok/{id}`](/docs/api/api-reference/byok/update-a-byok-provider-credential)
        - [`POST /byok`](/docs/api/api-reference/byok/create-a-byok-provider-credential)
      </Expandable>
  * `Guardrail`: type `string` modified<Badge stroke color="red" icon="triangle-exclamation" className="changelog-status-badge">Action required</Badge>

    * Allow `workspace_id` to be `null` in guardrail responses. A null value identifies an unscoped legacy guardrail; it does not mean the default workspace or every workspace.

      <Expandable title="4 endpoints using this schema">
        - [`GET /guardrails`](/docs/api/api-reference/guardrails/list-guardrails)
        - [`GET /guardrails/{id}`](/docs/api/api-reference/guardrails/get-a-guardrail)
        - [`PATCH /guardrails/{id}`](/docs/api/api-reference/guardrails/update-a-guardrail)
        - [`POST /guardrails`](/docs/api/api-reference/guardrails/create-a-guardrail)
      </Expandable>
  * `ObservabilityArizeDestination`: required `broadcast_generation_cost` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityArizeDestination`: required `broadcast_generation_identity` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityArizeDestination`: required `broadcast_generation_request_context` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityBraintrustDestination`: required `broadcast_generation_cost` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityBraintrustDestination`: required `broadcast_generation_identity` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityBraintrustDestination`: required `broadcast_generation_request_context` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityClickhouseDestination`: required `broadcast_generation_cost` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityClickhouseDestination`: required `broadcast_generation_identity` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityClickhouseDestination`: required `broadcast_generation_request_context` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityDatadogDestination`: required `broadcast_generation_cost` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityDatadogDestination`: required `broadcast_generation_identity` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityDatadogDestination`: required `broadcast_generation_request_context` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityGrafanaDestination`: required `broadcast_generation_cost` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityGrafanaDestination`: required `broadcast_generation_identity` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityGrafanaDestination`: required `broadcast_generation_request_context` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityLangfuseDestination`: required `broadcast_generation_cost` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityLangfuseDestination`: required `broadcast_generation_identity` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityLangfuseDestination`: required `broadcast_generation_request_context` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityLangsmithDestination`: required `broadcast_generation_cost` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityLangsmithDestination`: required `broadcast_generation_identity` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityLangsmithDestination`: required `broadcast_generation_request_context` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityNewrelicDestination`: required `broadcast_generation_cost` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityNewrelicDestination`: required `broadcast_generation_identity` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityNewrelicDestination`: required `broadcast_generation_request_context` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityOpikDestination`: required `broadcast_generation_cost` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityOpikDestination`: required `broadcast_generation_identity` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityOpikDestination`: required `broadcast_generation_request_context` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityOtelCollectorDestination`: required `broadcast_generation_cost` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityOtelCollectorDestination`: required `broadcast_generation_identity` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityOtelCollectorDestination`: required `broadcast_generation_request_context` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityPosthogDestination`: required `broadcast_generation_cost` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityPosthogDestination`: required `broadcast_generation_identity` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityPosthogDestination`: required `broadcast_generation_request_context` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityRampDestination`: required `broadcast_generation_cost` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityRampDestination`: required `broadcast_generation_identity` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityRampDestination`: required `broadcast_generation_request_context` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityS3Destination`: required `broadcast_generation_cost` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityS3Destination`: required `broadcast_generation_identity` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityS3Destination`: required `broadcast_generation_request_context` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilitySentryDestination`: required `broadcast_generation_cost` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilitySentryDestination`: required `broadcast_generation_identity` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilitySentryDestination`: required `broadcast_generation_request_context` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilitySnowflakeDestination`: required `broadcast_generation_cost` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilitySnowflakeDestination`: required `broadcast_generation_identity` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilitySnowflakeDestination`: required `broadcast_generation_request_context` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityWeaveDestination`: required `broadcast_generation_cost` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityWeaveDestination`: required `broadcast_generation_identity` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityWeaveDestination`: required `broadcast_generation_request_context` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityWebhookDestination`: required `broadcast_generation_cost` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityWebhookDestination`: required `broadcast_generation_identity` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityWebhookDestination`: required `broadcast_generation_request_context` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations): required `broadcast_generation_cost` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations): required `broadcast_generation_identity` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations): required `broadcast_generation_request_context` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>

  ## Modified endpoints

  * [`GET /byok`](/docs/api/api-reference/byok/list-byok-provider-credentials): description updated
  * [`POST /byok`](/docs/api/api-reference/byok/create-a-byok-provider-credential): description updated
  * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations): response schema updated
  * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination): response schema updated
  * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination): response schema updated
  * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination): response schema updated

  ## New response codes

  * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination): now returns `403`

  ## New schemas

  * `WebSearchMode`

      <Expandable title="6 endpoints using this schema">
        * [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion)
        * [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
        * [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
        * [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
        * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body)
        * [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
      </Expandable>

  ## Modified schemas

  * `BYOKKey`: description updated

      <Expandable title="4 endpoints using this schema">
        * [`GET /byok`](/docs/api/api-reference/byok/list-byok-provider-credentials)
        * [`GET /byok/{id}`](/docs/api/api-reference/byok/get-a-byok-provider-credential)
        * [`PATCH /byok/{id}`](/docs/api/api-reference/byok/update-a-byok-provider-credential)
        * [`POST /byok`](/docs/api/api-reference/byok/create-a-byok-provider-credential)
      </Expandable>
  * `CreateBYOKKeyRequest`: description updated
    * Used by [`POST /byok`](/docs/api/api-reference/byok/create-a-byok-provider-credential)
  * `CreateGuardrailRequest`: description updated
    * Used by [`POST /guardrails`](/docs/api/api-reference/guardrails/create-a-guardrail)
  * `CreateObservabilityDestinationRequest`: new property `broadcast_generation_cost`; new property `broadcast_generation_identity`; new property `broadcast_generation_request_context`
    * Used by [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
  * `CreateObservabilityDestinationResponse`: example modified
    * Used by [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
  * `FusionPlugin`: description updated

      <Expandable title="6 endpoints using this schema">
        * [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion)
        * [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
        * [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
        * [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
        * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body)
        * [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
      </Expandable>
  * `FusionServerToolConfig`: description updated

      <Expandable title="4 endpoints using this schema">
        * [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion)
        * [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
        * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body)
        * [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
      </Expandable>
  * `GetObservabilityDestinationResponse`: example modified
    * Used by [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
  * `Guardrail`: description updated

      <Expandable title="4 endpoints using this schema">
        * [`GET /guardrails`](/docs/api/api-reference/guardrails/list-guardrails)
        * [`GET /guardrails/{id}`](/docs/api/api-reference/guardrails/get-a-guardrail)
        * [`PATCH /guardrails/{id}`](/docs/api/api-reference/guardrails/update-a-guardrail)
        * [`POST /guardrails`](/docs/api/api-reference/guardrails/create-a-guardrail)
      </Expandable>
  * `ListObservabilityDestinationsResponse`: example modified
    * Used by [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
  * `ObservabilityArizeDestination`:

    * example modified
    * new property `broadcast_generation_cost`
    * new property `broadcast_generation_identity`
    * new property `broadcast_generation_request_context`

      <Expandable title="4 endpoints using this schema">
        - [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        - [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        - [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        - [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityBraintrustDestination`:

    * example modified
    * new property `broadcast_generation_cost`
    * new property `broadcast_generation_identity`
    * new property `broadcast_generation_request_context`

      <Expandable title="4 endpoints using this schema">
        - [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        - [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        - [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        - [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityClickhouseDestination`:

    * example modified
    * new property `broadcast_generation_cost`
    * new property `broadcast_generation_identity`
    * new property `broadcast_generation_request_context`

      <Expandable title="4 endpoints using this schema">
        - [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        - [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        - [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        - [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityDatadogDestination`:

    * example modified
    * new property `broadcast_generation_cost`
    * new property `broadcast_generation_identity`
    * new property `broadcast_generation_request_context`

      <Expandable title="4 endpoints using this schema">
        - [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        - [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        - [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        - [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityDestination`: example modified

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityGrafanaDestination`:

    * example modified
    * new property `broadcast_generation_cost`
    * new property `broadcast_generation_identity`
    * new property `broadcast_generation_request_context`

      <Expandable title="4 endpoints using this schema">
        - [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        - [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        - [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        - [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityLangfuseDestination`:

    * example modified
    * new property `broadcast_generation_cost`
    * new property `broadcast_generation_identity`
    * new property `broadcast_generation_request_context`

      <Expandable title="4 endpoints using this schema">
        - [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        - [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        - [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        - [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityLangsmithDestination`:

    * example modified
    * new property `broadcast_generation_cost`
    * new property `broadcast_generation_identity`
    * new property `broadcast_generation_request_context`

      <Expandable title="4 endpoints using this schema">
        - [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        - [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        - [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        - [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityNewrelicDestination`:

    * example modified
    * new property `broadcast_generation_cost`
    * new property `broadcast_generation_identity`
    * new property `broadcast_generation_request_context`

      <Expandable title="4 endpoints using this schema">
        - [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        - [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        - [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        - [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityOpikDestination`:

    * example modified
    * new property `broadcast_generation_cost`
    * new property `broadcast_generation_identity`
    * new property `broadcast_generation_request_context`

      <Expandable title="4 endpoints using this schema">
        - [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        - [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        - [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        - [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityOtelCollectorDestination`:

    * example modified
    * new property `broadcast_generation_cost`
    * new property `broadcast_generation_identity`
    * new property `broadcast_generation_request_context`

      <Expandable title="4 endpoints using this schema">
        - [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        - [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        - [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        - [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityPosthogDestination`:

    * example modified
    * new property `broadcast_generation_cost`
    * new property `broadcast_generation_identity`
    * new property `broadcast_generation_request_context`

      <Expandable title="4 endpoints using this schema">
        - [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        - [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        - [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        - [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityRampDestination`:

    * example modified
    * new property `broadcast_generation_cost`
    * new property `broadcast_generation_identity`
    * new property `broadcast_generation_request_context`

      <Expandable title="4 endpoints using this schema">
        - [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        - [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        - [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        - [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityS3Destination`:

    * example modified
    * new property `broadcast_generation_cost`
    * new property `broadcast_generation_identity`
    * new property `broadcast_generation_request_context`

      <Expandable title="4 endpoints using this schema">
        - [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        - [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        - [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        - [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilitySentryDestination`:

    * example modified
    * new property `broadcast_generation_cost`
    * new property `broadcast_generation_identity`
    * new property `broadcast_generation_request_context`

      <Expandable title="4 endpoints using this schema">
        - [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        - [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        - [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        - [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilitySnowflakeDestination`:

    * example modified
    * new property `broadcast_generation_cost`
    * new property `broadcast_generation_identity`
    * new property `broadcast_generation_request_context`

      <Expandable title="4 endpoints using this schema">
        - [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        - [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        - [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        - [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityWeaveDestination`:

    * example modified
    * new property `broadcast_generation_cost`
    * new property `broadcast_generation_identity`
    * new property `broadcast_generation_request_context`

      <Expandable title="4 endpoints using this schema">
        - [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        - [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        - [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        - [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `ObservabilityWebhookDestination`:

    * example modified
    * new property `broadcast_generation_cost`
    * new property `broadcast_generation_identity`
    * new property `broadcast_generation_request_context`

      <Expandable title="4 endpoints using this schema">
        - [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        - [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        - [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        - [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `UpdateObservabilityDestinationRequest`: new property `broadcast_generation_cost`; new property `broadcast_generation_identity`; new property `broadcast_generation_request_context`
    * Used by [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
  * `UpdateObservabilityDestinationResponse`: example modified
    * Used by [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
  * `ChatWebSearchShorthand`: new property `mode`
    * Used by [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion), [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
  * `InputReference`: description updated
    * Used by [`POST /videos`](/docs/api/api-reference/video-generation/submit-a-video-generation-request)
  * `Legacy_WebSearchServerTool`: new property `mode`
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `Preview_20250311_WebSearchServerTool`: new property `mode`
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `Preview_WebSearchServerTool`: new property `mode`
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `VideoGenerationRequest`: description updated
    * Used by [`POST /videos`](/docs/api/api-reference/video-generation/submit-a-video-generation-request)
  * `WebSearchConfig`: new property `mode`

      <Expandable title="4 endpoints using this schema">
        * [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion)
        * [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
        * [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
        * [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
      </Expandable>
  * `WebSearchPlugin`: new property `mode`

      <Expandable title="6 endpoints using this schema">
        * [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion)
        * [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
        * [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
        * [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
        * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body)
        * [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
      </Expandable>
  * `WebSearchServerTool`: new property `mode`
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `WebSearchServerToolConfig`: new property `mode`
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
</Update>

<Update label="August 5, 2026" tags={["Files","Schemas"]} rss="1 modified endpoint, 1 modified schema.">
  ## Modified endpoints

  * [`POST /files`](/docs/api/api-reference/files/upload-a-file): description updated

  ## Modified schemas

  * `FilesServerTool`: description updated

      <Expandable title="4 endpoints using this schema">
        * [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion)
        * [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
        * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body)
        * [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
      </Expandable>
</Update>

<Update label="August 4, 2026" tags={["Schemas","Workspaces","beta.Analytics"]} rss="1 modified endpoint, 1 new response code, 5 new schemas, 4 modified schemas.">
  ## Modified endpoints

  * [`POST /analytics/query`](/docs/api/api-reference/betaanalytics/query-analytics-data): request schema updated

  ## New response codes

  * [`DELETE /workspaces/{id}/budgets/{interval}`](/docs/api/api-reference/workspaces/delete-a-workspace-budget): now returns `400`

  ## New schemas

  * `GetWorkspaceBudgetResponse`
    * Used by [`GET /workspaces/{id}/budgets/{interval}`](/docs/api/api-reference/workspaces/get-a-workspace-budget)
  * `MessagesBashToolResultBlock`
    * Used by [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message), [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
  * `MessagesShellToolResultBlock`
    * Used by [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message), [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
  * `ORAnthropicBashToolResult`
    * Used by [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
  * `ORAnthropicShellToolResult`
    * Used by [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)

  ## Modified schemas

  * `ObservabilitySnowflakeDestination`: property `account` updated

      <Expandable title="4 endpoints using this schema">
        * [`GET /observability/destinations`](/docs/api/api-reference/observability/list-observability-destinations)
        * [`GET /observability/destinations/{id}`](/docs/api/api-reference/observability/get-an-observability-destination)
        * [`PATCH /observability/destinations/{id}`](/docs/api/api-reference/observability/update-an-observability-destination)
        * [`POST /observability/destinations`](/docs/api/api-reference/observability/create-an-observability-destination)
      </Expandable>
  * `MessagesContentBlockStartEvent`: new union variant added
    * Used by [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
  * `MessagesRequest`: new union variant added
    * Used by [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message), [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
  * `ORAnthropicContentBlock`: new union variant added
    * Used by [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
</Update>

<Update label="August 3, 2026" tags={["Analytics","Breaking","Endpoints","beta.Analytics"]} rss="1 breaking change, 3 modified endpoints, 4 new schemas, 4 modified schemas.">
  ## Breaking changes

  * `GenerationResponse`: required `workspace_id` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
    * No action required for existing consumers. Generation responses now include `workspace_id`, the ID of the workspace the generation belongs to.
    * Used by [`GET /generation`](/docs/api/api-reference/generations/get-request-&-usage-metadata-for-a-generation)

  ## Modified endpoints

  * [`GET /activity`](/docs/api/api-reference/analytics/get-user-activity-grouped-by-endpoint):
    * x-speakeasy-max-method-params object\_added
    * description updated
    * new parameter `group_by`
    * new parameter `workspace_id`
  * [`POST /analytics/query`](/docs/api/api-reference/betaanalytics/query-analytics-data): description updated
  * [`GET /endpoints/zdr`](/docs/api/api-reference/endpoints/preview-the-impact-of-zdr-on-the-available-endpoints): response schema updated

  ## New schemas

  * `SpeechInputReference`
    * Used by [`POST /audio/speech`](/docs/api/api-reference/tts/create-speech)
  * `SpeechInputReferenceAudio`
    * Used by [`POST /audio/speech`](/docs/api/api-reference/tts/create-speech)
  * `SpeechInputReferenceAudioInput`
    * Used by [`POST /audio/speech`](/docs/api/api-reference/tts/create-speech)
  * `SpeechInputReferenceText`
    * Used by [`POST /audio/speech`](/docs/api/api-reference/tts/create-speech)

  ## Modified schemas

  * `ActivityItem`: new property `workspace_id`
    * Used by [`GET /activity`](/docs/api/api-reference/analytics/get-user-activity-grouped-by-endpoint)
  * `GenerationResponse`: example modified; new property `workspace_id`
    * Used by [`GET /generation`](/docs/api/api-reference/generations/get-request-&-usage-metadata-for-a-generation)
  * `PublicEndpoint`: example modified; new property `supports_voice_cloning`
    * Used by [`GET /endpoints/zdr`](/docs/api/api-reference/endpoints/preview-the-impact-of-zdr-on-the-available-endpoints), [`GET /models/{author}/{slug}/endpoints`](/docs/api/api-reference/endpoints/list-all-endpoints-for-a-model)
  * `SpeechRequest`: new property `input_references`
    * Used by [`POST /audio/speech`](/docs/api/api-reference/tts/create-speech)
</Update>

<Update label="August 1, 2026" tags={["Guardrails"]} rss="2 modified endpoints, 1 modified schema.">
  ## Modified endpoints

  * [`GET /guardrails/{id}`](/docs/api/api-reference/guardrails/get-a-guardrail): description updated
  * [`PATCH /guardrails/{id}`](/docs/api/api-reference/guardrails/update-a-guardrail): description updated

  ## Modified schemas

  * `Workspace`: description updated

      <Expandable title="4 endpoints using this schema">
        * [`GET /workspaces`](/docs/api/api-reference/workspaces/list-workspaces)
        * [`GET /workspaces/{id}`](/docs/api/api-reference/workspaces/get-a-workspace)
        * [`PATCH /workspaces/{id}`](/docs/api/api-reference/workspaces/update-a-workspace)
        * [`POST /workspaces`](/docs/api/api-reference/workspaces/create-a-workspace)
      </Expandable>
</Update>

<Update label="July 31, 2026" tags={[]} rss="API specification updated." />

<Update label="July 30, 2026" tags={["BYOK","Breaking","SCIM","Schemas"]} rss="1 breaking change, 6 new endpoints, 1 modified endpoint, 10 new schemas, 11 modified schemas.">
  ## Breaking changes

  * `SpeechRequest`: required `voice` property removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
    * No action required for existing consumers. `voice` is now optional; requests that send it are unaffected.
    * Used by [`POST /audio/speech`](/docs/api/api-reference/tts/create-speech)

  ## New endpoints

  * [`GET /scim/group-mappings`](/docs/api/api-reference/scim/list-scim-group-mappings): List SCIM group mappings
  * [`POST /scim/group-mappings`](/docs/api/api-reference/scim/create-a-scim-group-mapping): Create a SCIM group mapping
  * [`GET /scim/group-mappings/{id}`](/docs/api/api-reference/scim/get-a-scim-group-mapping): Get a SCIM group mapping
  * [`PATCH /scim/group-mappings/{id}`](/docs/api/api-reference/scim/update-a-scim-group-mapping): Update a SCIM group mapping
  * [`DELETE /scim/group-mappings/{id}`](/docs/api/api-reference/scim/delete-a-scim-group-mapping): Delete a SCIM group mapping
  * [`GET /scim/groups`](/docs/api/api-reference/scim/list-scim-groups): List SCIM groups

  ## Modified endpoints

  * [`GET /byok`](/docs/api/api-reference/byok/list-byok-provider-credentials): parameter `provider` updated

  ## New schemas

  * `CreateScimGroupMappingRequest`
    * Used by [`POST /scim/group-mappings`](/docs/api/api-reference/scim/create-a-scim-group-mapping)
  * `CreateScimGroupMappingResponse`
    * Used by [`POST /scim/group-mappings`](/docs/api/api-reference/scim/create-a-scim-group-mapping)
  * `DeleteScimGroupMappingResponse`
    * Used by [`DELETE /scim/group-mappings/{id}`](/docs/api/api-reference/scim/delete-a-scim-group-mapping)
  * `GetScimGroupMappingResponse`
    * Used by [`GET /scim/group-mappings/{id}`](/docs/api/api-reference/scim/get-a-scim-group-mapping)
  * `ListScimGroupMappingsResponse`
    * Used by [`GET /scim/group-mappings`](/docs/api/api-reference/scim/list-scim-group-mappings)
  * `ListScimGroupsResponse`
    * Used by [`GET /scim/groups`](/docs/api/api-reference/scim/list-scim-groups)
  * `ScimGroup`
    * Used by [`GET /scim/groups`](/docs/api/api-reference/scim/list-scim-groups)
  * `ScimGroupMapping`

      <Expandable title="4 endpoints using this schema">
        * [`GET /scim/group-mappings`](/docs/api/api-reference/scim/list-scim-group-mappings)
        * [`GET /scim/group-mappings/{id}`](/docs/api/api-reference/scim/get-a-scim-group-mapping)
        * [`PATCH /scim/group-mappings/{id}`](/docs/api/api-reference/scim/update-a-scim-group-mapping)
        * [`POST /scim/group-mappings`](/docs/api/api-reference/scim/create-a-scim-group-mapping)
      </Expandable>
  * `UpdateScimGroupMappingRequest`
    * Used by [`PATCH /scim/group-mappings/{id}`](/docs/api/api-reference/scim/update-a-scim-group-mapping)
  * `UpdateScimGroupMappingResponse`
    * Used by [`PATCH /scim/group-mappings/{id}`](/docs/api/api-reference/scim/update-a-scim-group-mapping)

  ## Modified schemas

  * `VideoGenerationRequest`: enum property\_added
    * Used by [`POST /videos`](/docs/api/api-reference/video-generation/submit-a-video-generation-request)
  * `VideoModel`: enum property\_added
    * Used by [`GET /videos/models`](/docs/api/api-reference/video-generation/list-all-video-generation-models)
  * `SpeechRequest`: minLength property\_added
    * Used by [`POST /audio/speech`](/docs/api/api-reference/tts/create-speech)
  * `BYOKProviderSlug`: enum property\_added

      <Expandable title="4 endpoints using this schema">
        * [`GET /byok`](/docs/api/api-reference/byok/list-byok-provider-credentials)
        * [`GET /byok/{id}`](/docs/api/api-reference/byok/get-a-byok-provider-credential)
        * [`PATCH /byok/{id}`](/docs/api/api-reference/byok/update-a-byok-provider-credential)
        * [`POST /byok`](/docs/api/api-reference/byok/create-a-byok-provider-credential)
      </Expandable>
  * `MessagesStartEvent`: property `provider` updated
    * Used by [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
  * `ProviderName`: enum property\_added

      <Expandable title="11 endpoints using this schema">
        * [`GET /endpoints/zdr`](/docs/api/api-reference/endpoints/preview-the-impact-of-zdr-on-the-available-endpoints)
        * [`GET /models/{author}/{slug}/endpoints`](/docs/api/api-reference/endpoints/list-all-endpoints-for-a-model)
        * [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion)
        * [`POST /embeddings`](/docs/api/api-reference/embeddings/submit-an-embedding-request)
        * [`POST /images`](/docs/api/api-reference/images/generate-an-image)
        * [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
        * [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
        * [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
        * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body)
        * [`POST /rerank`](/docs/api/api-reference/rerank/submit-a-rerank-request)
        * [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
      </Expandable>
  * `ProviderOptions`: new property `thinkingmachines`

      <Expandable title="4 endpoints using this schema">
        * [`POST /audio/speech`](/docs/api/api-reference/tts/create-speech)
        * [`POST /audio/transcriptions`](/docs/api/api-reference/stt/create-transcription)
        * [`POST /images`](/docs/api/api-reference/images/generate-an-image)
        * [`POST /videos`](/docs/api/api-reference/video-generation/submit-a-video-generation-request)
      </Expandable>
  * `ProviderResponse`: enum property\_added
    * Used by [`GET /generation`](/docs/api/api-reference/generations/get-request-&-usage-metadata-for-a-generation)
  * `ChatRequest`: description updated; enum property\_added
    * Used by [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion), [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
  * `ResponsesErrorField`: enum property\_added
    * Used by [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `ResponsesRequest`: description updated; enum property\_added
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
</Update>

<Update label="July 29, 2026" tags={["Benchmarks","Breaking","Files","Schemas","Workspaces"]} rss="17 breaking changes, 12 modified endpoints, 14 new response codes, 13 new schemas, 16 modified schemas.">
  ## Breaking changes

  * `FileMetadata`: schema object removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
  * `FileDeleteResponse`: discriminator `discriminator` object added<Badge stroke color="red" icon="triangle-exclamation" className="changelog-status-badge">Action required</Badge>
    * HTTP clients: no change. Requests without a vendor SDK still get the OpenRouter shape (`_shape: "openrouter"`) with the same fields as before. Typed SDK clients: this response type is now a union discriminated by `_shape`. In the TypeScript SDK, the field is named `shape`, so check `shape === "openrouter"` before reading OpenRouter fields such as `id` and `type`.
    * Used by [`DELETE /files/{file_id}`](/docs/api/api-reference/files/delete-a-file)
  * `FileDeleteResponse`: properties `id` object removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
    * Used by [`DELETE /files/{file_id}`](/docs/api/api-reference/files/delete-a-file)
  * `FileDeleteResponse`: properties `type` object removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
    * Used by [`DELETE /files/{file_id}`](/docs/api/api-reference/files/delete-a-file)
  * `FileDeleteResponse`: required `id` property removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
    * Used by [`DELETE /files/{file_id}`](/docs/api/api-reference/files/delete-a-file)
  * `FileDeleteResponse`: required `type` property removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
    * Used by [`DELETE /files/{file_id}`](/docs/api/api-reference/files/delete-a-file)
  * `FileListResponse`: discriminator `discriminator` object added<Badge stroke color="red" icon="triangle-exclamation" className="changelog-status-badge">Action required</Badge>
    * HTTP clients: no change. Requests without a vendor SDK still get the OpenRouter shape (`_shape: "openrouter"`) with the same fields as before. Typed SDK clients: this response type is now a union discriminated by `_shape`. In the TypeScript SDK, the field is named `shape`, so check `shape === "openrouter"` before reading OpenRouter fields such as `cursor`.
    * Used by [`GET /files`](/docs/api/api-reference/files/list-files)
  * `FileListResponse`: properties `cursor` object removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
    * Used by [`GET /files`](/docs/api/api-reference/files/list-files)
  * `FileListResponse`: properties `data` object removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
    * Used by [`GET /files`](/docs/api/api-reference/files/list-files)
  * `FileListResponse`: properties `first_id` object removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
    * Used by [`GET /files`](/docs/api/api-reference/files/list-files)
  * `FileListResponse`: properties `has_more` object removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
    * Used by [`GET /files`](/docs/api/api-reference/files/list-files)
  * `FileListResponse`: properties `last_id` object removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
    * Used by [`GET /files`](/docs/api/api-reference/files/list-files)
  * `FileListResponse`: required `cursor` property removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
    * Used by [`GET /files`](/docs/api/api-reference/files/list-files)
  * `FileListResponse`: required `data` property removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
    * Used by [`GET /files`](/docs/api/api-reference/files/list-files)
  * `FileListResponse`: required `first_id` property removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
    * Used by [`GET /files`](/docs/api/api-reference/files/list-files)
  * `FileListResponse`: required `has_more` property removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
    * Used by [`GET /files`](/docs/api/api-reference/files/list-files)
  * `FileListResponse`: required `last_id` property removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
    * Used by [`GET /files`](/docs/api/api-reference/files/list-files)

  ## Modified endpoints

  * [`GET /benchmarks`](/docs/api/api-reference/benchmarks/list-benchmarks): description updated; parameter `source` updated; response schema updated
  * [`GET /files`](/docs/api/api-reference/files/list-files):
    * new parameter `after`
    * new parameter `after_id`
    * new parameter `before_id`
    * new parameter `order`
    * new parameter `provider`
  * [`POST /files`](/docs/api/api-reference/files/upload-a-file): new parameter `provider`; response schema updated
  * [`DELETE /files/{file_id}`](/docs/api/api-reference/files/delete-a-file): new parameter `provider`
  * [`GET /files/{file_id}`](/docs/api/api-reference/files/get-file-metadata): new parameter `provider`; response schema updated
  * [`GET /files/{file_id}/content`](/docs/api/api-reference/files/download-file-content): new parameter `provider`
  * [`GET /workspaces`](/docs/api/api-reference/workspaces/list-workspaces): response schema updated
  * [`POST /workspaces`](/docs/api/api-reference/workspaces/create-a-workspace): response schema updated
  * [`GET /workspaces/{id}`](/docs/api/api-reference/workspaces/get-a-workspace): response schema updated
  * [`PATCH /workspaces/{id}`](/docs/api/api-reference/workspaces/update-a-workspace): response schema updated
  * [`GET /workspaces/{id}/budgets`](/docs/api/api-reference/workspaces/list-workspace-budgets): response schema updated
  * [`PUT /workspaces/{id}/budgets/{interval}`](/docs/api/api-reference/workspaces/create-or-update-a-workspace-budget): description updated; request schema updated; response schema updated

  ## New response codes

  * [`GET /files`](/docs/api/api-reference/files/list-files): now returns `403`
  * [`GET /files`](/docs/api/api-reference/files/list-files): now returns `502`
  * [`GET /files`](/docs/api/api-reference/files/list-files): now returns `503`
  * [`POST /files`](/docs/api/api-reference/files/upload-a-file): now returns `502`
  * [`POST /files`](/docs/api/api-reference/files/upload-a-file): now returns `503`
  * [`DELETE /files/{file_id}`](/docs/api/api-reference/files/delete-a-file): now returns `403`
  * [`DELETE /files/{file_id}`](/docs/api/api-reference/files/delete-a-file): now returns `502`
  * [`DELETE /files/{file_id}`](/docs/api/api-reference/files/delete-a-file): now returns `503`
  * [`GET /files/{file_id}`](/docs/api/api-reference/files/get-file-metadata): now returns `403`
  * [`GET /files/{file_id}`](/docs/api/api-reference/files/get-file-metadata): now returns `502`
  * [`GET /files/{file_id}`](/docs/api/api-reference/files/get-file-metadata): now returns `503`
  * [`GET /files/{file_id}/content`](/docs/api/api-reference/files/download-file-content): now returns `403`
  * [`GET /files/{file_id}/content`](/docs/api/api-reference/files/download-file-content): now returns `502`
  * [`GET /files/{file_id}/content`](/docs/api/api-reference/files/download-file-content): now returns `503`

  ## New schemas

  * `UnifiedBenchmarksORItem`
    * Used by [`GET /benchmarks`](/docs/api/api-reference/benchmarks/list-benchmarks)
  * `AnthropicFile`
    * Used by [`GET /files`](/docs/api/api-reference/files/list-files), [`GET /files/{file_id}`](/docs/api/api-reference/files/get-file-metadata), [`POST /files`](/docs/api/api-reference/files/upload-a-file)
  * `AnthropicFileDeleted`
    * Used by [`DELETE /files/{file_id}`](/docs/api/api-reference/files/delete-a-file)
  * `AnthropicFileList`
    * Used by [`GET /files`](/docs/api/api-reference/files/list-files)
  * `FileProvider`

      <Expandable title="5 endpoints using this schema">
        * [`DELETE /files/{file_id}`](/docs/api/api-reference/files/delete-a-file)
        * [`GET /files`](/docs/api/api-reference/files/list-files)
        * [`GET /files/{file_id}`](/docs/api/api-reference/files/get-file-metadata)
        * [`GET /files/{file_id}/content`](/docs/api/api-reference/files/download-file-content)
        * [`POST /files`](/docs/api/api-reference/files/upload-a-file)
      </Expandable>
  * `FileResponse`
    * Used by [`GET /files/{file_id}`](/docs/api/api-reference/files/get-file-metadata), [`POST /files`](/docs/api/api-reference/files/upload-a-file)
  * `OpenAIFile`
    * Used by [`GET /files`](/docs/api/api-reference/files/list-files), [`GET /files/{file_id}`](/docs/api/api-reference/files/get-file-metadata), [`POST /files`](/docs/api/api-reference/files/upload-a-file)
  * `OpenAIFileDeleted`
    * Used by [`DELETE /files/{file_id}`](/docs/api/api-reference/files/delete-a-file)
  * `OpenAIFileList`
    * Used by [`GET /files`](/docs/api/api-reference/files/list-files)
  * `OpenRouterFile`
    * Used by [`GET /files`](/docs/api/api-reference/files/list-files), [`GET /files/{file_id}`](/docs/api/api-reference/files/get-file-metadata), [`POST /files`](/docs/api/api-reference/files/upload-a-file)
  * `OpenRouterFileDeleted`
    * Used by [`DELETE /files/{file_id}`](/docs/api/api-reference/files/delete-a-file)
  * `OpenRouterFileList`
    * Used by [`GET /files`](/docs/api/api-reference/files/list-files)
  * `ModelAliasTarget`

      <Expandable title="4 endpoints using this schema">
        * [`GET /embeddings/models`](/docs/api/api-reference/embeddings/list-all-embeddings-models)
        * [`GET /model/{author}/{slug}`](/docs/api/api-reference/models/get-a-model-by-its-slug)
        * [`GET /models`](/docs/api/api-reference/models/list-all-models-and-their-properties)
        * [`GET /models/user`](/docs/api/api-reference/models/list-models-filtered-by-user-provider-preferences-privacy-settings-and-guardrails)
      </Expandable>

  ## Modified schemas

  * `UnifiedBenchmarksMeta`: enum property\_added
    * Used by [`GET /benchmarks`](/docs/api/api-reference/benchmarks/list-benchmarks)
  * `UnifiedBenchmarksResponse`: example modified; new union variant added
    * Used by [`GET /benchmarks`](/docs/api/api-reference/benchmarks/list-benchmarks)
  * `FileDeleteResponse`:
    * description updated
    * example modified
    * new union variant added
    * type property\_removed
    * Used by [`DELETE /files/{file_id}`](/docs/api/api-reference/files/delete-a-file)
  * `FileListResponse`:
    * description updated
    * example modified
    * new union variant added
    * type property\_removed
    * Used by [`GET /files`](/docs/api/api-reference/files/list-files)
  * `CreateWorkspaceResponse`: example modified
    * Used by [`POST /workspaces`](/docs/api/api-reference/workspaces/create-a-workspace)
  * `GetWorkspaceResponse`: example modified
    * Used by [`GET /workspaces/{id}`](/docs/api/api-reference/workspaces/get-a-workspace)
  * `ListWorkspaceBudgetsResponse`: example modified; new property `include_byok_in_budgets`
    * Used by [`GET /workspaces/{id}/budgets`](/docs/api/api-reference/workspaces/list-workspace-budgets)
  * `ListWorkspacesResponse`: example modified
    * Used by [`GET /workspaces`](/docs/api/api-reference/workspaces/list-workspaces)
  * `Model`: new property `alias_target`

      <Expandable title="4 endpoints using this schema">
        * [`GET /embeddings/models`](/docs/api/api-reference/embeddings/list-all-embeddings-models)
        * [`GET /model/{author}/{slug}`](/docs/api/api-reference/models/get-a-model-by-its-slug)
        * [`GET /models`](/docs/api/api-reference/models/list-all-models-and-their-properties)
        * [`GET /models/user`](/docs/api/api-reference/models/list-models-filtered-by-user-provider-preferences-privacy-settings-and-guardrails)
      </Expandable>
  * `UpdateWorkspaceResponse`: example modified
    * Used by [`PATCH /workspaces/{id}`](/docs/api/api-reference/workspaces/update-a-workspace)
  * `UpsertWorkspaceBudgetRequest`: example modified; new property `include_byok_in_budgets`
    * Used by [`PUT /workspaces/{id}/budgets/{interval}`](/docs/api/api-reference/workspaces/create-or-update-a-workspace-budget)
  * `UpsertWorkspaceBudgetResponse`: example modified; new property `include_byok_in_budgets`
    * Used by [`PUT /workspaces/{id}/budgets/{interval}`](/docs/api/api-reference/workspaces/create-or-update-a-workspace-budget)
  * `Workspace`: example modified; new property `include_byok_in_budgets`

      <Expandable title="4 endpoints using this schema">
        * [`GET /workspaces`](/docs/api/api-reference/workspaces/list-workspaces)
        * [`GET /workspaces/{id}`](/docs/api/api-reference/workspaces/get-a-workspace)
        * [`PATCH /workspaces/{id}`](/docs/api/api-reference/workspaces/update-a-workspace)
        * [`POST /workspaces`](/docs/api/api-reference/workspaces/create-a-workspace)
      </Expandable>
  * `AutoBetaRouterPlugin`: example modified; new property `excluded_models`

      <Expandable title="6 endpoints using this schema">
        * [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion)
        * [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
        * [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
        * [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
        * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body)
        * [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
      </Expandable>
  * `AutoRouterPlugin`: example modified; new property `excluded_models`

      <Expandable title="6 endpoints using this schema">
        * [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion)
        * [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
        * [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
        * [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
        * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body)
        * [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
      </Expandable>
  * `VideoModel`: enum property\_added
    * Used by [`GET /videos/models`](/docs/api/api-reference/video-generation/list-all-video-generation-models)
</Update>

<Update label="July 28, 2026" tags={["Breaking","Files","Responses","Schemas"]} rss="2 breaking changes, 5 modified endpoints, 22 modified schemas.">
  ## Breaking changes

  * `FusionCallAnalysisInProgressEvent`: required `analyst_model` property added<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
    * **No action required for existing consumers.** `analyst_model` replaces `judge_model` in this streaming event; `judge_model` is retained as a deprecated alias that always carries the same value.
    * Used by [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * \$.tags: responses object removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
    * **No action required.** The `responses` OpenAPI tag was renamed to `Responses` for consistent Title Case across the API Reference. This is a documentation-grouping change only: `POST /api/v1/responses` and its schemas are unchanged, SDK namespaces are unchanged (`client.responses.send()` in TypeScript and Python, `Sdk.Responses.Send()` in Go), and endpoint documentation URLs are unchanged.

  ## Modified endpoints

  * [`GET /files`](/docs/api/api-reference/files/list-files): parameter `cursor` updated; response schema updated
  * [`POST /files`](/docs/api/api-reference/files/upload-a-file): response schema updated
  * [`DELETE /files/{file_id}`](/docs/api/api-reference/files/delete-a-file): parameter `file_id` updated; response schema updated
  * [`GET /files/{file_id}`](/docs/api/api-reference/files/get-file-metadata): parameter `file_id` updated; response schema updated
  * [`GET /files/{file_id}/content`](/docs/api/api-reference/files/download-file-content): parameter `file_id` updated

  ## Modified schemas

  * `FusionAnalysisResult`: description updated
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `FusionCallAnalysisCompletedEvent`: description updated
    * Used by [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `FusionCallAnalysisInProgressEvent`:
    * description updated
    * example modified
    * new property `analyst_model`
    * property `judge_model` deprecated (alias of `analyst_model`, kept for existing consumers)
    * Used by [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `FusionPlugin`: description updated

      <Expandable title="6 endpoints using this schema">
        * [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion)
        * [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
        * [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
        * [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
        * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body)
        * [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
      </Expandable>
  * `FusionServerToolConfig`: description updated; property `effort` updated; property `max_tokens` updated

      <Expandable title="4 endpoints using this schema">
        * [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion)
        * [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
        * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body)
        * [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
      </Expandable>
  * `FusionServerTool_OpenRouter`: description updated

      <Expandable title="4 endpoints using this schema">
        * [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion)
        * [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
        * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body)
        * [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
      </Expandable>
  * `FusionSource`: description updated
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `OutputFusionServerToolItem`: description updated
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `ChatWebSearchShorthand`: description updated
    * Used by [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion), [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
  * `WebSearchConfig`: description updated

      <Expandable title="4 endpoints using this schema">
        * [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion)
        * [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
        * [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
        * [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
      </Expandable>
  * `WebSearchDomainFilter`: example modified; new property `blocked_domains`
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `WebSearchServerToolConfig`: description updated
    * Used by [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body), [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
  * `AnthropicFileDocumentSource`: example modified
    * Used by [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message), [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
  * `FileDeleteResponse`: example modified
    * Used by [`DELETE /files/{file_id}`](/docs/api/api-reference/files/delete-a-file)
  * `FileListResponse`: example modified
    * Used by [`GET /files`](/docs/api/api-reference/files/list-files)
  * `FileMetadata`: example modified
    * Used by [`GET /files`](/docs/api/api-reference/files/list-files), [`GET /files/{file_id}`](/docs/api/api-reference/files/get-file-metadata), [`POST /files`](/docs/api/api-reference/files/upload-a-file)
  * `GenerationResponse`: property `data_region` updated
    * Used by [`GET /generation`](/docs/api/api-reference/generations/get-request-&-usage-metadata-for-a-generation)
  * `CreateGuardrailRequest`: new property `enable_free_model_publication`; new property `enable_free_model_training`; new property `enable_paid_model_training`
    * Used by [`POST /guardrails`](/docs/api/api-reference/guardrails/create-a-guardrail)
  * `Guardrail`:

    * example modified
    * new property `enable_free_model_publication`
    * new property `enable_free_model_training`
    * new property `enable_paid_model_training`

      <Expandable title="4 endpoints using this schema">
        - [`GET /guardrails`](/docs/api/api-reference/guardrails/list-guardrails)
        - [`GET /guardrails/{id}`](/docs/api/api-reference/guardrails/get-a-guardrail)
        - [`PATCH /guardrails/{id}`](/docs/api/api-reference/guardrails/update-a-guardrail)
        - [`POST /guardrails`](/docs/api/api-reference/guardrails/create-a-guardrail)
      </Expandable>
  * `UpdateGuardrailRequest`: new property `enable_free_model_publication`; new property `enable_free_model_training`; new property `enable_paid_model_training`
    * Used by [`PATCH /guardrails/{id}`](/docs/api/api-reference/guardrails/update-a-guardrail)
  * `AutoBetaRouterPlugin`:

    * example modified
    * new property `cost_tier`
    * deprecated property\_added
    * description updated

      <Expandable title="6 endpoints using this schema">
        - [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion)
        - [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
        - [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
        - [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
        - [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body)
        - [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
      </Expandable>
  * `AutoRouterPlugin`:

    * example modified
    * new property `cost_tier`
    * deprecated property\_added
    * description updated

      <Expandable title="6 endpoints using this schema">
        - [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion)
        - [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
        - [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
        - [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
        - [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body)
        - [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
      </Expandable>
</Update>

<Update label="July 27, 2026" tags={["Embeddings","Schemas"]} rss="1 modified endpoint, 2 modified schemas.">
  ## Modified endpoints

  * [`POST /embeddings`](/docs/api/api-reference/embeddings/submit-an-embedding-request): request schema updated

  ## Modified schemas

  * `Quantization`: enum property\_added

      <Expandable title="10 endpoints using this schema">
        * [`GET /endpoints/zdr`](/docs/api/api-reference/endpoints/preview-the-impact-of-zdr-on-the-available-endpoints)
        * [`GET /models/{author}/{slug}/endpoints`](/docs/api/api-reference/endpoints/list-all-endpoints-for-a-model)
        * [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion)
        * [`POST /embeddings`](/docs/api/api-reference/embeddings/submit-an-embedding-request)
        * [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
        * [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
        * [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
        * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body)
        * [`POST /rerank`](/docs/api/api-reference/rerank/submit-a-rerank-request)
        * [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
      </Expandable>
  * `ReasoningFormat`: enum property\_added

      <Expandable title="4 endpoints using this schema">
        * [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion)
        * [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
        * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body)
        * [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
      </Expandable>
</Update>

<Update label="July 25, 2026" tags={["BYOK","Breaking","Responses","Schemas"]} rss="2 breaking changes, 2 modified endpoints, 5 modified schemas.">
  ## Breaking changes

  * [`POST /responses`](/docs/api/api-reference/responses/create-a-response): tags `beta.responses` property removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
    * **Migration: no action for HTTP clients.** The Responses API is now GA. `beta.responses` was an OpenAPI grouping tag and SDK namespace, never a URL. `POST /api/v1/responses` and its request and response schemas are unchanged, so raw HTTP callers and OpenAI-compatible clients (including the OpenAI Agents SDK) need no changes. The endpoint now appears under **Responses** instead of **Beta responses** in the API Reference.
    * **Migration for SDK users: optional until sunset.** The canonical namespace is now `responses`, with `client.responses.send()` (TypeScript, Python) and `client.Responses.Send()` (Go). The `beta.responses` namespace, and TypeScript's `betaResponsesSend` standalone function, keep working as deprecated aliases; their removal will be announced here with a sunset date before it ships.
  * \$.tags: beta.responses object removed<Badge stroke color="gray" className="changelog-status-badge">No action needed</Badge>
    * Same change as above at the specification level: the `beta.responses` tag definition is gone from `$.tags`.

  ## Modified endpoints

  * [`POST /responses`](/docs/api/api-reference/responses/create-a-response): tags property\_added
  * [`GET /byok`](/docs/api/api-reference/byok/list-byok-provider-credentials): parameter `provider` updated

  ## Modified schemas

  * `MessagesStartEvent`: property `provider` updated
    * Used by [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
  * `ProviderName`: enum property\_added

      <Expandable title="11 endpoints using this schema">
        * [`GET /endpoints/zdr`](/docs/api/api-reference/endpoints/preview-the-impact-of-zdr-on-the-available-endpoints)
        * [`GET /models/{author}/{slug}/endpoints`](/docs/api/api-reference/endpoints/list-all-endpoints-for-a-model)
        * [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion)
        * [`POST /embeddings`](/docs/api/api-reference/embeddings/submit-an-embedding-request)
        * [`POST /images`](/docs/api/api-reference/images/generate-an-image)
        * [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
        * [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
        * [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
        * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body)
        * [`POST /rerank`](/docs/api/api-reference/rerank/submit-a-rerank-request)
        * [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
      </Expandable>
  * `ProviderOptions`: new property `claude-on-aws`

      <Expandable title="4 endpoints using this schema">
        * [`POST /audio/speech`](/docs/api/api-reference/tts/create-speech)
        * [`POST /audio/transcriptions`](/docs/api/api-reference/stt/create-transcription)
        * [`POST /images`](/docs/api/api-reference/images/generate-an-image)
        * [`POST /videos`](/docs/api/api-reference/video-generation/submit-a-video-generation-request)
      </Expandable>
  * `ProviderResponse`: enum property\_added
    * Used by [`GET /generation`](/docs/api/api-reference/generations/get-request-&-usage-metadata-for-a-generation)
  * `BYOKProviderSlug`: enum property\_added

      <Expandable title="4 endpoints using this schema">
        * [`GET /byok`](/docs/api/api-reference/byok/list-byok-provider-credentials)
        * [`GET /byok/{id}`](/docs/api/api-reference/byok/get-a-byok-provider-credential)
        * [`PATCH /byok/{id}`](/docs/api/api-reference/byok/update-a-byok-provider-credential)
        * [`POST /byok`](/docs/api/api-reference/byok/create-a-byok-provider-credential)
      </Expandable>
</Update>

<Update label="July 24, 2026" tags={["Schemas"]} rss="8 modified schemas.">
  ## Modified schemas

  * `MessagesStartEvent`: property `provider` updated
    * Used by [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
  * `ProviderName`: enum property\_added

      <Expandable title="11 endpoints using this schema">
        * [`GET /endpoints/zdr`](/docs/api/api-reference/endpoints/preview-the-impact-of-zdr-on-the-available-endpoints)
        * [`GET /models/{author}/{slug}/endpoints`](/docs/api/api-reference/endpoints/list-all-endpoints-for-a-model)
        * [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion)
        * [`POST /embeddings`](/docs/api/api-reference/embeddings/submit-an-embedding-request)
        * [`POST /images`](/docs/api/api-reference/images/generate-an-image)
        * [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
        * [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
        * [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
        * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body)
        * [`POST /rerank`](/docs/api/api-reference/rerank/submit-a-rerank-request)
        * [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
      </Expandable>
  * `ProviderOptions`: new property `voyageai`

      <Expandable title="4 endpoints using this schema">
        * [`POST /audio/speech`](/docs/api/api-reference/tts/create-speech)
        * [`POST /audio/transcriptions`](/docs/api/api-reference/stt/create-transcription)
        * [`POST /images`](/docs/api/api-reference/images/generate-an-image)
        * [`POST /videos`](/docs/api/api-reference/video-generation/submit-a-video-generation-request)
      </Expandable>
  * `ProviderResponse`: enum property\_added
    * Used by [`GET /generation`](/docs/api/api-reference/generations/get-request-&-usage-metadata-for-a-generation)
  * `AnthropicCompactionBlock`: new property `encrypted_content`
    * Used by [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
  * `MessagesToolAdditionBlock`: new property `cache_control`; new union variant added; type property\_removed
    * `tool` widened from a single `tool_reference` object to a union of `tool_reference`, `mcp_tool_reference` (`name` + `server_name`) and `mcp_toolset_reference` (`server_name`). The `tool_reference` variant is unchanged, so existing `{ "type": "tool_reference", "name": "…" }` payloads stay valid. The `name` and `type` properties moved into that variant rather than being removed.
    * Used by [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message), [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
  * `MessagesToolRemovalBlock`: new property `cache_control`; new union variant added; type property\_removed
    * `tool` widened the same way as `MessagesToolAdditionBlock`; existing `tool_reference` payloads stay valid.
    * Used by [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message), [`POST /presets/{slug}/messages`](/docs/api/api-reference/presets/create-a-preset-from-a-messages-request-body)
  * `ORAnthropicStopReason`: enum property\_added
    * Used by [`POST /messages`](/docs/api/api-reference/anthropic-messages/create-a-message)
</Update>

<Update label="July 8, 2026" tags={["Schemas"]} rss="1 new schema, 1 modified schema.">
  ## New schemas

  * `ImageGenTextChunkEvent`
    * Used by [`POST /images`](/docs/api/api-reference/images/generate-an-image)

  ## Modified schemas

  * `ImageStreamingResponse`: new union variant added
    * Used by [`POST /images`](/docs/api/api-reference/images/generate-an-image)
</Update>

<Update label="July 7, 2026" tags={["Datasets","Images","Models","STT"]} rss="3 modified endpoints, 1 new response code, 3 new schemas, 6 modified schemas.">
  ## Modified endpoints

  * [`POST /audio/transcriptions`](/docs/api/api-reference/stt/create-transcription): description updated; request body now accepts `multipart/form-data`
  * [`GET /datasets/rankings-daily`](/docs/api/api-reference/datasets/daily-token-totals-for-top-50-models):
    * description updated
    * new parameter `category`
    * new parameter `context_bucket`
    * new parameter `language_type`
    * new parameter `modality`
    * new parameter `period`
  * [`GET /models`](/docs/api/api-reference/models/list-all-models-and-their-properties):
    * new parameter `max_age_days`
    * new parameter `max_agentic_index`
    * new parameter `max_coding_index`
    * new parameter `max_intelligence_index`
    * new parameter `max_output_price`
    * new parameter `max_tool_success_rate`
    * new parameter `min_age_days`
    * new parameter `min_agentic_index`
    * new parameter `min_coding_index`
    * new parameter `min_intelligence_index`
    * new parameter `min_output_price`
    * new parameter `min_tool_success_rate`
    * description updated
    * parameter `sort` updated

  ## New response codes

  * [`POST /images`](/docs/api/api-reference/images/generate-an-image): now returns `413`

  ## New schemas

  * `STTSegment`
    * Used by [`POST /audio/transcriptions`](/docs/api/api-reference/stt/create-transcription)
  * `STTTimestampGranularity`
    * Used by [`POST /audio/transcriptions`](/docs/api/api-reference/stt/create-transcription)
  * `STTWord`
    * Used by [`POST /audio/transcriptions`](/docs/api/api-reference/stt/create-transcription)

  ## Modified schemas

  * `ChatFunctionTool`: new union variant added
    * Used by [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion), [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
  * `FusionServerToolConfig`: description updated

      <Expandable title="4 endpoints using this schema">
        * [`POST /chat/completions`](/docs/api/api-reference/chat/create-a-chat-completion)
        * [`POST /presets/{slug}/chat/completions`](/docs/api/api-reference/presets/create-a-preset-from-a-chat-completions-request-body)
        * [`POST /presets/{slug}/responses`](/docs/api/api-reference/presets/create-a-preset-from-a-responses-request-body)
        * [`POST /responses`](/docs/api/api-reference/responses/create-a-response)
      </Expandable>
  * `ImageGenCompletedEvent`: description updated; example modified
    * Used by [`POST /images`](/docs/api/api-reference/images/generate-an-image)
  * `ImageGenerationResponse`: property `media_type` updated
    * Used by [`POST /images`](/docs/api/api-reference/images/generate-an-image)
  * `STTRequest`: new property `response_format`; new property `timestamp_granularities`
    * Used by [`POST /audio/transcriptions`](/docs/api/api-reference/stt/create-transcription)
  * `STTResponse`:
    * new property `duration`
    * new property `language`
    * new property `segments`
    * new property `task`
    * new property `words`
    * Used by [`POST /audio/transcriptions`](/docs/api/api-reference/stt/create-transcription)
</Update>

<Update label="July 3, 2026" tags={["Workspaces"]} rss="1 new endpoint, 1 new schema.">
  ## New endpoints

  * [`GET /workspaces/{id}/members`](/docs/api/api-reference/workspaces/list-workspace-members): List workspace members

  ## New schemas

  * `ListWorkspaceMembersResponse`
    * Used by [`GET /workspaces/{id}/members`](/docs/api/api-reference/workspaces/list-workspace-members)
</Update>