Skip to content

chore: update OpenAPI spec from monorepo #1209

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
openrouter-docs-sync merged 1 commit into from
Nov 4, 2026
Merged

chore: update OpenAPI spec from monorepo #1209

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
275 changes: 2 additions & 273 deletions .speakeasy/in.openapi.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10400,12 +10400,6 @@ components:
type:
- 'boolean'
- 'null'
max_completion_tokens:
description: 'Cap on completion tokens per request. Requests asking for more skip this endpoint, and the default output length stays within it. When omitted, the cap is copied from the public endpoint for the same model and provider, if there is one.'
example: 131072
maximum: 2147483647
minimum: 1
type: 'integer'
model_permaslug:
description: 'Permanent slug of the model this endpoint serves.'
example: 'openai/gpt-4o-2024-08-06'
Expand Down Expand Up @@ -33684,27 +33678,6 @@ components:
required:
- 'is_filtered_model_catalog_enabled'
type: 'object'
UpdatePrivateEndpointParametersRequest:
properties:
declared_parameters:
description: 'Parameters the upstream supports beyond the tested ones. Replaces the earlier declaration; tested parameters stay. Order and repeated names are ignored, but the list holds at most as many entries as there are declarable parameters, repeats included. `tool_choice` requires `tools` to be tested or declared.'
example:
- 'temperature'
- 'seed'
items:
$ref: '#/components/schemas/PrivateEndpointDeclaredParameter'
maxItems: 25
type: 'array'
required:
- 'declared_parameters'
type: 'object'
UpdatePrivateEndpointPricingRequest:
properties:
pricing:
$ref: '#/components/schemas/PrivateEndpointPricing'
required:
- 'pricing'
type: 'object'
UpdatePrivateEndpointRequest:
description: 'Only the fields present change. `base_url`, `upstream_model_id`, `declared_zdr` and `declared_region` are accepted on a draft only; `pricing` and `declared_parameters` replace their value; `settings` is itself a partial update where `null` clears a limit or restores the provider default.'
example:
Expand Down Expand Up @@ -48670,12 +48643,12 @@ paths:
description: 'Create a private endpoint as a draft. Drafts are not routable: validate one with `POST /private-endpoints/{id}/validate`, then activate it with `POST /private-endpoints/{id}/activate`. Pass `activate` to do all three in one call; if validation fails the draft is kept and returned with the failed checks. Send an `Idempotency-Key` header to make retries safe: a repeated key with the same request returns the endpoint the first request created; reusing it with different fields returns 422 `idempotency_key_reused`. Returns 400 `parameters_invalid` when `tool_choice` is declared without `tools`. The response does not echo `declared_parameters` or `tested_parameters`; read them with `GET /private-endpoints/{id}`. [Management key](/docs/guides/overview/auth/management-api-keys) required.'
operationId: 'createPrivateEndpoint'
parameters:
- description: 'Retry-safe create: a repeated create with the same key from the same organization returns the endpoint the first request created instead of creating another. The endpoint is returned as it is now. Reusing a key with a different request body (model, provider, base URL, upstream model ID, declared ZDR or region, pricing, or declared parameters) is rejected with 422 `idempotency_key_reused`. Declared parameters are compared as a set, so a retry that reorders or repeats a name replays the endpoint. `activate` and `max_completion_tokens` are not compared, and later edits to the endpoint do not affect the comparison.'
- description: 'Retry-safe create: a repeated create with the same key from the same organization returns the endpoint the first request created instead of creating another. The endpoint is returned as it is now. Reusing a key with a different request body (model, provider, base URL, upstream model ID, declared ZDR or region, pricing, or declared parameters) is rejected with 422 `idempotency_key_reused`. Declared parameters are compared as a set, so a retry that reorders or repeats a name replays the endpoint. `activate` and `settings` are not compared, and later edits to the endpoint do not affect the comparison. `settings` is still validated before the replay, so a retry with invalid settings returns 400 `settings_invalid` instead of the endpoint.'
in: 'header'
name: 'idempotency-key'
required: false
schema:
description: 'Retry-safe create: a repeated create with the same key from the same organization returns the endpoint the first request created instead of creating another. The endpoint is returned as it is now. Reusing a key with a different request body (model, provider, base URL, upstream model ID, declared ZDR or region, pricing, or declared parameters) is rejected with 422 `idempotency_key_reused`. Declared parameters are compared as a set, so a retry that reorders or repeats a name replays the endpoint. `activate` and `max_completion_tokens` are not compared, and later edits to the endpoint do not affect the comparison.'
description: 'Retry-safe create: a repeated create with the same key from the same organization returns the endpoint the first request created instead of creating another. The endpoint is returned as it is now. Reusing a key with a different request body (model, provider, base URL, upstream model ID, declared ZDR or region, pricing, or declared parameters) is rejected with 422 `idempotency_key_reused`. Declared parameters are compared as a set, so a retry that reorders or repeats a name replays the endpoint. `activate` and `settings` are not compared, and later edits to the endpoint do not affect the comparison. `settings` is still validated before the replay, so a retry with invalid settings returns 400 `settings_invalid` instead of the endpoint.'
example: 'wayfair-gpt-4o-eastus-2026-09'
maxLength: 255
minLength: 1
Expand Down Expand Up @@ -49441,250 +49414,6 @@ paths:
tags:
- 'Private Endpoints'
x-speakeasy-name-override: 'enable'
/private-endpoints/{id}/parameters:
put:
deprecated: true
description: 'Deprecated: send `declared_parameters` to `PATCH /private-endpoints/{id}` instead; this route behaves exactly like that call and will be removed. The body replaces the earlier declaration and is read as a set; `tested_parameters` stay. Returns 400 `parameters_invalid` when `tool_choice` is declared without `tools` being tested or declared. [Management key](/docs/guides/overview/auth/management-api-keys) required.'
operationId: 'updatePrivateEndpointParameters'
parameters:
- description: 'Stable identifier of the private endpoint.'
in: 'path'
name: 'id'
required: true
schema:
description: 'Stable identifier of the private endpoint.'
example: '5b1c4c4e-7d0a-4a8e-9f3a-2d6c1b0e8a11'
format: 'uuid'
type: 'string'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/UpdatePrivateEndpointParametersRequest'
required: true
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/PrivateEndpointResponse'
description: 'The endpoint with its new declared parameters'
'400':
content:
application/json:
example:
error:
code: 400
message: 'Invalid request parameters'
schema:
$ref: '#/components/schemas/BadRequestResponse'
description: 'Bad Request - Invalid request parameters or malformed input'
'401':
content:
application/json:
example:
error:
code: 401
message: 'Missing Authentication header'
schema:
$ref: '#/components/schemas/UnauthorizedResponse'
description: 'Unauthorized - Authentication required or invalid credentials'
'403':
content:
application/json:
example:
error:
code: 403
message: 'Only management keys can perform this operation'
schema:
$ref: '#/components/schemas/ForbiddenResponse'
description: 'Forbidden - Authentication successful but insufficient permissions'
'404':
content:
application/json:
example:
error:
code: 404
message: 'Resource not found'
schema:
$ref: '#/components/schemas/NotFoundResponse'
description: 'Not Found - Resource does not exist'
'408':
content:
application/json:
example:
error:
code: 408
message: 'Operation timed out. Please try again later.'
schema:
$ref: '#/components/schemas/RequestTimeoutResponse'
description: 'Request Timeout - Operation exceeded time limit'
'409':
content:
application/json:
example:
error:
code: 409
message: 'Resource conflict. Please try again later.'
schema:
$ref: '#/components/schemas/ConflictResponse'
description: 'Conflict - Resource conflict or concurrent modification'
'422':
content:
application/json:
example:
error:
code: 422
message: 'Invalid argument'
schema:
$ref: '#/components/schemas/UnprocessableEntityResponse'
description: 'Unprocessable Entity - Semantic validation failure'
'500':
content:
application/json:
example:
error:
code: 500
message: 'Internal Server Error'
schema:
$ref: '#/components/schemas/InternalServerResponse'
description: 'Internal Server Error - Unexpected server error'
'502':
content:
application/json:
example:
error:
code: 502
message: 'Provider returned error'
schema:
$ref: '#/components/schemas/BadGatewayResponse'
description: 'Bad Gateway - Provider/upstream API failure'
summary: 'Set private endpoint supported parameters (deprecated)'
tags:
- 'Private Endpoints'
x-speakeasy-name-override: 'updateParameters'
/private-endpoints/{id}/pricing:
put:
deprecated: true
description: 'Deprecated: send `pricing` to `PATCH /private-endpoints/{id}` instead; this route behaves exactly like that call and will be removed. The body replaces the whole pricing object: omitting `cache_read` or `cache_write` reverts that rate to the provider pricing strategy default. [Management key](/docs/guides/overview/auth/management-api-keys) required.'
operationId: 'updatePrivateEndpointPricing'
parameters:
- description: 'Stable identifier of the private endpoint.'
in: 'path'
name: 'id'
required: true
schema:
description: 'Stable identifier of the private endpoint.'
example: '5b1c4c4e-7d0a-4a8e-9f3a-2d6c1b0e8a11'
format: 'uuid'
type: 'string'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/UpdatePrivateEndpointPricingRequest'
required: true
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/PrivateEndpointResponse'
description: 'The endpoint with its new pricing'
'400':
content:
application/json:
example:
error:
code: 400
message: 'Invalid request parameters'
schema:
$ref: '#/components/schemas/BadRequestResponse'
description: 'Bad Request - Invalid request parameters or malformed input'
'401':
content:
application/json:
example:
error:
code: 401
message: 'Missing Authentication header'
schema:
$ref: '#/components/schemas/UnauthorizedResponse'
description: 'Unauthorized - Authentication required or invalid credentials'
'403':
content:
application/json:
example:
error:
code: 403
message: 'Only management keys can perform this operation'
schema:
$ref: '#/components/schemas/ForbiddenResponse'
description: 'Forbidden - Authentication successful but insufficient permissions'
'404':
content:
application/json:
example:
error:
code: 404
message: 'Resource not found'
schema:
$ref: '#/components/schemas/NotFoundResponse'
description: 'Not Found - Resource does not exist'
'408':
content:
application/json:
example:
error:
code: 408
message: 'Operation timed out. Please try again later.'
schema:
$ref: '#/components/schemas/RequestTimeoutResponse'
description: 'Request Timeout - Operation exceeded time limit'
'409':
content:
application/json:
example:
error:
code: 409
message: 'Resource conflict. Please try again later.'
schema:
$ref: '#/components/schemas/ConflictResponse'
description: 'Conflict - Resource conflict or concurrent modification'
'422':
content:
application/json:
example:
error:
code: 422
message: 'Invalid argument'
schema:
$ref: '#/components/schemas/UnprocessableEntityResponse'
description: 'Unprocessable Entity - Semantic validation failure'
'500':
content:
application/json:
example:
error:
code: 500
message: 'Internal Server Error'
schema:
$ref: '#/components/schemas/InternalServerResponse'
description: 'Internal Server Error - Unexpected server error'
'502':
content:
application/json:
example:
error:
code: 502
message: 'Provider returned error'
schema:
$ref: '#/components/schemas/BadGatewayResponse'
description: 'Bad Gateway - Provider/upstream API failure'
summary: 'Set private endpoint pricing (deprecated)'
tags:
- 'Private Endpoints'
x-speakeasy-name-override: 'updatePricing'
/private-endpoints/{id}/validate:
post:
description: 'Send a live test request to the draft endpoint using the given workspace''s BYOK credential for its provider. A passing validation is required before activation. Failed checks return 200 with `passed: false`. [Management key](/docs/guides/overview/auth/management-api-keys) required.'
Expand Down
Loading