POST /api/alpha/extractions is now available, and extraction request and field schemas reject unknown keys instead of silently dropping them, returning 400 with a validation error naming the key. Also removed the no-op provider.options.scaledown.context_chars, added a per-item confidences array on list answers, PDF asset support, and new filter schemas for the analytics query endpoint.
Changelog
npx @buildinternet/releases get openrouter-changelogDeferredToolsControl adds a cascade_mode property and a hint property, and DeferredBm25Search and DeferredRegexSearch gain a siblings property. Several tool schemas, including ImageGenerationServerToolConfig and CodeInterpreterServerTool, received updated descriptions and examples.
CreateGuardrailRequest: description updated Used by POST /guardrails Guardrail: description updated \ \GET /guardrails\ \ \GET /guardrails/{id}\ \ \PATCH /guardrails/{id}\ \ \POST /guardrails\ UpdateGuardrailRequest: description updated Used by PATCH /guardrails/{id}
OpenRouter's Responses API now reports MCP tool calls and tool listing through new streaming and output schemas, with tool choice and approval requests included. ChatUsage gains a deferred_tools_details field, and decisions requests no longer require the instructions property.
New endpoints let machines buy credits and check purchases, presets gain restore and workspace_id filtering, and extraction responses now return 200 with null entries in spans instead of 502 when list items have no offsets in the state text. Client code reading spans must check each entry for null.
The deprecated PUT /private-endpoints/{id}/parameters and /pricing endpoints now return 404, and POST /private-endpoints no longer reads a top-level max_completion_tokens field, which must move to settings.max_completion_tokens. GET /providers/{provider_slug}/endpoints lists a provider's endpoints with provider-wide stats, and STT, speech, and video requests accept provider routing fields.
DeferredBm25Search and DeferredRegexSearch gained spread and miss_sources properties, while DeferredToolsControl adds announce_catalog_changes and min_deferred_tools. OutputToolSearchServerToolItem also gained a catalog_changes property, and several schema descriptions were updated.
Observability OTel collector destinations gain config.metricsEndpoint and config.shouldSendMetrics properties, and web fetch tool output now includes a retrieved_at timestamp. The changelog also adds a ContentFilterReadEntry guardrail schema, bad-request response schemas for POST /responses and credits purchases, and updates the embeddings request and response schemas.
The GET /models endpoint accepts a new endpoints parameter. The API also adds Pearl Research and Ant Digital provider options, enum additions for reasoning format and BYOK provider slugs, and an input_tokens_details property on decisions usage.
Sending "scope": "client" in deferred_tools now returns 400 on chat/completions, messages, responses, and preset endpoints; scope accepts only "all" or "mcp". Omit scope or set "all" to defer across all eligible tools, or set "mcp" to defer MCP tools only.
ExtractionsRequest no longer requires a state property, and the guardrail policy request schemas no longer require workspace_id, with the changelog noting no action is needed. ChatRequest also gains reasoning.context, reasoning.enabled, reasoning.exclude and reasoning.mode properties, and extraction field schemas add unit and integer properties.
New endpoints let workspaces create, list, update, and delete account-wide guardrail policies covering budget, moderation, and model availability, plus read and change policy assignments for API keys and members. Preset chat, messages, and responses endpoints accept a new workspace_id parameter, and DeferredToolsControl gained interface and scope properties.
Private provider requests and responses no longer accept or return a configurable data_policy, and newly created providers automatically apply a policy with no prompt retention, training, or publication. A PATCH body containing only data_policy now returns 400 instead of 200.
New /private-providers CRUD endpoints manage private providers, and PATCH /private-endpoints/{id} is now a merge patch over every owner-controlled field, so upstream_model_id is no longer required. The pricing and parameters PUT routes remain as deprecated aliases.
ObservabilityS3Destination.config.roleArn now accepts only commercial-partition roles (arn:aws:iam::), so POST and PATCH requests with GovCloud or China ARNs fail validation and those destinations must be recreated. IAM role destinations now also verify that the trust policy carries an sts:ExternalId condition, returning 403 on Test Connection and live delivery otherwise, and ChatDeveloperMessage and ChatSystemMessage configuration_update became a reference to the named ConfigurationUpdate schema.
S3 observability destinations now support IAM role authentication via authMode "iam_role" with provider, roleArn, region, and externalId, so OpenRouter assumes a role in your AWS account instead of storing access keys. The accessKeyId and secretAccessKey config properties are no longer required in the schema and may be absent in destination responses for IAM role destinations; existing destinations and default access_keys behavior are unchanged.
Added the AnthropicToolUnion schema for POST /messages and POST /presets/{slug}/messages, and MessagesToolAdditionBlock gained a new union variant with an updated description. VideoModel also received an added enum property on GET /videos/models.
GET /generation: now returns 403
GET /interns: description updated POST /interns: description updated; response schema updated DELETE /interns/{internId}: description updated; response schema updated GET /interns/{internId}: description updated PATCH /interns/{internId}: description updated; response schema…
CreateEndUserRequest: schema object removedAction required Renamed to CreateExternalUserRequest; the shape is unchanged, so HTTP callers need no change. The Python SDK (openrouter 1.3.70 and later) and TypeScript SDK (@openrouter/sdk 1.5.0 and later) replace the…

