Получить список версий пресета
Возвращает все версии пресета, отсортированные по номеру версии в порядке возрастания (от самой старой к самой новой).
OpenAPI
yaml
openapi: 3.1.0
info:
contact:
email: support@openrouter.ai
name: OpenRouter Support
url: https://openrouter.ai/docs
description: OpenAI-compatible API with additional OpenRouter features
license:
name: MIT
url: https://opensource.org/licenses/MIT
title: OpenRouter API
version: 1.0.0
servers:
- description: Production server
url: https://openrouter.ai/api/v1
x-speakeasy-server-id: production
security:
- apiKey: []
tags:
- description: API key management endpoints
name: API Keys
- description: Analytics and usage endpoints
name: Analytics
- description: Anthropic Messages endpoints
name: Anthropic Messages
- description: BYOK endpoints
name: BYOK
- description: Benchmarks endpoints
name: Benchmarks
- description: Chat completion endpoints
name: Chat
- description: Task classification market-share endpoints
name: Classifications
- description: Credit management endpoints
name: Credits
- description: >-
Public OpenRouter usage datasets. Data returned by these endpoints is
licensed under CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/):
reuse and republish it, including commercially, with attribution to
OpenRouter.
name: Datasets
- description: Text embedding endpoints
name: Embeddings
- description: Endpoint information
name: Endpoints
- description: Files endpoints
name: Files
- description: Generation history endpoints
name: Generations
- description: Guardrails endpoints
name: Guardrails
- description: Images endpoints
name: Images
- description: Model information endpoints
name: Models
- description: OAuth authentication endpoints
name: OAuth
- description: Observability endpoints
name: Observability
- description: Organization endpoints
name: Organization
- description: Presets endpoints
name: Presets
- description: Provider information endpoints
name: Providers
- description: Rerank endpoints
name: Rerank
- description: OpenAI-compatible Responses API endpoints
name: Responses
- description: SCIM endpoints
name: SCIM
- description: Speech-to-text endpoints
name: STT
x-displayName: Transcriptions
- description: Text-to-speech endpoints
name: TTS
x-displayName: Speech
- description: Video Generation endpoints
name: Video Generation
- description: Workspaces endpoints
name: Workspaces
- description: beta.Analytics endpoints
name: beta.Analytics
externalDocs:
description: OpenRouter Documentation
url: https://openrouter.ai/docs
paths:
/presets/{slug}/versions:
get:
tags:
- Presets
summary: List versions of a preset
description: >-
Lists all versions of a preset, ordered by version number ascending
(oldest first).
operationId: listPresetVersions
parameters:
- description: URL-safe slug identifying the preset.
in: path
name: slug
required: true
schema:
description: URL-safe slug identifying the preset.
example: my-preset
minLength: 1
type: string
- description: Number of records to skip for pagination
in: query
name: offset
required: false
schema:
default: 0
description: Number of records to skip for pagination
example: 0
minimum: 0
type:
- integer
- 'null'
- description: Maximum number of records to return (max 100)
in: query
name: limit
required: false
schema:
default: 50
description: Maximum number of records to return (max 100)
example: 50
maximum: 100
minimum: 1
type: integer
responses:
'200':
content:
application/json:
example:
data:
- config:
model: openai/gpt-4o
temperature: 0.7
created_at: '2026-04-20T10:00:00Z'
creator_id: user_2dHFtVWx2n56w6HkM0000000000
id: 550e8400-e29b-41d4-a716-446655440000
preset_id: 650e8400-e29b-41d4-a716-446655440001
system_prompt: You are a helpful assistant.
updated_at: '2026-04-20T10:00:00Z'
version: 1
total_count: 1
schema:
$ref: '#/components/schemas/ListPresetVersionsResponse'
description: Paginated list of preset versions.
'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
'404':
content:
application/json:
example:
error:
code: 404
message: Resource not found
schema:
$ref: '#/components/schemas/NotFoundResponse'
description: Not Found - Resource does not exist
'500':
content:
application/json:
example:
error:
code: 500
message: Internal Server Error
schema:
$ref: '#/components/schemas/InternalServerResponse'
description: Internal Server Error - Unexpected server error
security:
- apiKey: []
components:
schemas:
ListPresetVersionsResponse:
description: A paginated list of preset versions.
example:
data:
- config:
model: openai/gpt-4o
temperature: 0.7
created_at: '2026-04-20T10:00:00Z'
creator_id: user_2dHFtVWx2n56w6HkM0000000000
id: 550e8400-e29b-41d4-a716-446655440000
preset_id: 650e8400-e29b-41d4-a716-446655440001
system_prompt: You are a helpful assistant.
updated_at: '2026-04-20T10:00:00Z'
version: 1
total_count: 1
properties:
data:
items:
$ref: '#/components/schemas/PresetDesignatedVersion'
type: array
total_count:
type: integer
required:
- data
- total_count
type: object
BadRequestResponse:
description: Bad Request - Invalid request parameters or malformed input
example:
error:
code: 400
message: Invalid request parameters
properties:
error:
$ref: '#/components/schemas/BadRequestResponseErrorData'
openrouter_metadata:
additionalProperties: {}
type:
- object
- 'null'
user_id:
type:
- string
- 'null'
required:
- error
type: object
UnauthorizedResponse:
description: Unauthorized - Authentication required or invalid credentials
example:
error:
code: 401
message: Missing Authentication header
properties:
error:
$ref: '#/components/schemas/UnauthorizedResponseErrorData'
openrouter_metadata:
additionalProperties: {}
type:
- object
- 'null'
user_id:
type:
- string
- 'null'
required:
- error
type: object
NotFoundResponse:
description: Not Found - Resource does not exist
example:
error:
code: 404
message: Resource not found
properties:
error:
$ref: '#/components/schemas/NotFoundResponseErrorData'
openrouter_metadata:
additionalProperties: {}
type:
- object
- 'null'
user_id:
type:
- string
- 'null'
required:
- error
type: object
InternalServerResponse:
description: Internal Server Error - Unexpected server error
example:
error:
code: 500
message: Internal Server Error
properties:
error:
$ref: '#/components/schemas/InternalServerResponseErrorData'
openrouter_metadata:
additionalProperties: {}
type:
- object
- 'null'
user_id:
type:
- string
- 'null'
required:
- error
type: object
PresetDesignatedVersion:
description: >-
A specific version of a preset, containing config and optional system
prompt.
example:
config:
model: openai/gpt-4o
temperature: 0.7
created_at: '2026-04-20T10:00:00Z'
creator_id: user_2dHFtVWx2n56w6HkM0000000000
id: 550e8400-e29b-41d4-a716-446655440000
preset_id: 650e8400-e29b-41d4-a716-446655440001
system_prompt: You are a helpful assistant.
updated_at: '2026-04-20T10:00:00Z'
version: 1
properties:
config:
additionalProperties: {}
type: object
created_at:
type: string
creator_id:
type: string
id:
type: string
preset_id:
type: string
system_prompt:
type:
- string
- 'null'
updated_at:
type: string
version:
type: integer
required:
- id
- preset_id
- creator_id
- version
- system_prompt
- config
- created_at
- updated_at
type:
- object
- 'null'
BadRequestResponseErrorData:
description: Error data for BadRequestResponse
example:
code: 400
message: Invalid request parameters
properties:
code:
type: integer
message:
type: string
metadata:
additionalProperties: {}
type:
- object
- 'null'
required:
- code
- message
type: object
UnauthorizedResponseErrorData:
description: Error data for UnauthorizedResponse
example:
code: 401
message: Missing Authentication header
properties:
code:
type: integer
message:
type: string
metadata:
additionalProperties: {}
type:
- object
- 'null'
required:
- code
- message
type: object
NotFoundResponseErrorData:
description: Error data for NotFoundResponse
example:
code: 404
message: Resource not found
properties:
code:
type: integer
message:
type: string
metadata:
additionalProperties: {}
type:
- object
- 'null'
required:
- code
- message
type: object
InternalServerResponseErrorData:
description: Error data for InternalServerResponse
example:
code: 500
message: Internal Server Error
properties:
code:
type: integer
message:
type: string
metadata:
additionalProperties: {}
type:
- object
- 'null'
required:
- code
- message
type: object
securitySchemes:
apiKey:
description: API key as bearer token in Authorization header
scheme: bearer
type: http