The responses API from Multiverse Computing — 2 operation(s) for responses.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/multiverse-computing-responses-api"curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
openapi: 3.2.0
info:
title: Chatbot Responses API
description: Chatbot API. Provided by Multiverse Computing.
contact:
name: Multiverse Computing
url: https://multiversecomputing.com/
email: contact@multiversecomputing.com
version: 0.1.1
servers:
- url: https://api.compactif.ai
description: CompactifAI API production base URL (host the spec is served from; docs.compactif.ai documents this base)
tags:
- name: responses
paths:
/v1/responses/{response_id}:
get:
tags:
- responses
summary: Retrieve response
description: 'Return a previously stored response, scoped to the authenticated user.
Only responses created with ``store: true`` are available, and only to the
user who created them.'
operationId: get_response_v1_responses__response_id__get
security:
- HTTPBearer: []
parameters:
- name: response_id
in: path
required: true
schema:
type: string
title: Response Id
- name: x-request-id
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Request-Id
responses:
'200':
description: Stored response payload from /v1/responses
content:
application/json:
schema:
$ref: '#/components/schemas/ResponsesResult'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/v1/responses:
post:
tags:
- responses
summary: Create response
description: 'Generate a response from the model.
Parameters:
- **app_config**: Application configuration
- **body**: ResponsesRequest payload with model and optional response parameters.
- **authorization**: The authorization credentials.
Returns:
- A ResponsesResult for non-streaming requests.
- A StreamingResponse when stream is true.'
operationId: post_responses_v1_responses_post
security:
- HTTPBearer: []
parameters:
- name: x-request-id
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Request-Id
- name: x-app-id
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-App-Id
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/ResponsesRequest'
responses:
'200':
description: Response payload (non-streaming). When stream=true a text/event-stream of response events is returned instead.
content:
application/json:
schema:
$ref: '#/components/schemas/ResponsesResult'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
components:
schemas:
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
ActionScreenshot:
properties:
type:
type: string
const: screenshot
title: Type
additionalProperties: true
type: object
required:
- type
title: ActionScreenshot
CodeInterpreterContainerCodeInterpreterToolAuto:
properties:
type:
type: string
const: auto
title: Type
file_ids:
anyOf:
- items:
type: string
type: array
- type: 'null'
title: File Ids
additionalProperties: true
type: object
required:
- type
title: CodeInterpreterContainerCodeInterpreterToolAuto
LocalShellCallAction:
properties:
command:
items:
type: string
type: array
title: Command
env:
additionalProperties:
type: string
type: object
title: Env
type:
type: string
const: exec
title: Type
timeout_ms:
anyOf:
- type: integer
- type: 'null'
title: Timeout Ms
user:
anyOf:
- type: string
- type: 'null'
title: User
working_directory:
anyOf:
- type: string
- type: 'null'
title: Working Directory
additionalProperties: true
type: object
required:
- command
- env
- type
title: LocalShellCallAction
ResponseFormatText:
properties:
type:
type: string
const: text
title: Type
additionalProperties: true
type: object
required:
- type
title: ResponseFormatText
PendingSafetyCheck:
properties:
id:
type: string
title: Id
code:
type: string
title: Code
message:
type: string
title: Message
additionalProperties: true
type: object
required:
- id
- code
- message
title: PendingSafetyCheck
ValidationError:
properties:
loc:
items:
anyOf:
- type: string
- type: integer
type: array
title: Location
msg:
type: string
title: Message
type:
type: string
title: Error Type
input:
title: Input
ctx:
type: object
title: Context
type: object
required:
- loc
- msg
- type
title: ValidationError
ResponseFormatJSONObject:
properties:
type:
type: string
const: json_object
title: Type
additionalProperties: true
type: object
required:
- type
title: ResponseFormatJSONObject
Message:
properties:
content:
items:
anyOf:
- $ref: '#/components/schemas/ResponseInputText'
- $ref: '#/components/schemas/ResponseInputImage'
- $ref: '#/components/schemas/ResponseInputFile'
- $ref: '#/components/schemas/ResponseInputAudio'
type: array
title: Content
role:
type: string
enum:
- user
- system
- developer
title: Role
status:
anyOf:
- type: string
enum:
- in_progress
- completed
- incomplete
- type: 'null'
title: Status
type:
anyOf:
- type: string
const: message
- type: 'null'
title: Type
additionalProperties: true
type: object
required:
- content
- role
title: Message
ResponseInputImageContent:
properties:
type:
type: string
const: input_image
title: Type
detail:
anyOf:
- type: string
enum:
- low
- high
- auto
- type: 'null'
title: Detail
file_id:
anyOf:
- type: string
- type: 'null'
title: File Id
image_url:
anyOf:
- type: string
- type: 'null'
title: Image Url
additionalProperties: true
type: object
required:
- type
title: ResponseInputImageContent
FileSearchTool:
properties:
type:
type: string
const: file_search
title: Type
vector_store_ids:
items:
type: string
type: array
title: Vector Store Ids
filters:
anyOf:
- $ref: '#/components/schemas/ComparisonFilter'
- $ref: '#/components/schemas/CompoundFilter'
- type: 'null'
title: Filters
max_num_results:
anyOf:
- type: integer
- type: 'null'
title: Max Num Results
ranking_options:
anyOf:
- $ref: '#/components/schemas/RankingOptions'
- type: 'null'
additionalProperties: true
type: object
required:
- type
- vector_store_ids
title: FileSearchTool
Reasoning:
properties:
effort:
anyOf:
- type: string
enum:
- minimal
- low
- medium
- high
- type: 'null'
title: Effort
generate_summary:
anyOf:
- type: string
enum:
- auto
- concise
- detailed
- type: 'null'
title: Generate Summary
summary:
anyOf:
- type: string
enum:
- auto
- concise
- detailed
- type: 'null'
title: Summary
additionalProperties: true
type: object
title: Reasoning
LocalShellCallOutput:
properties:
id:
type: string
title: Id
output:
type: string
title: Output
type:
type: string
const: local_shell_call_output
title: Type
status:
anyOf:
- type: string
enum:
- in_progress
- completed
- incomplete
- type: 'null'
title: Status
additionalProperties: true
type: object
required:
- id
- output
- type
title: LocalShellCallOutput
McpApprovalRequest:
properties:
id:
type: string
title: Id
arguments:
type: string
title: Arguments
name:
type: string
title: Name
server_label:
type: string
title: Server Label
type:
type: string
const: mcp_approval_request
title: Type
additionalProperties: true
type: object
required:
- id
- arguments
- name
- server_label
- type
title: McpApprovalRequest
RankingOptions:
properties:
ranker:
anyOf:
- type: string
enum:
- auto
- default-2024-11-15
- type: 'null'
title: Ranker
score_threshold:
anyOf:
- type: number
- type: 'null'
title: Score Threshold
additionalProperties: true
type: object
title: RankingOptions
McpCall:
properties:
id:
type: string
title: Id
arguments:
type: string
title: Arguments
name:
type: string
title: Name
server_label:
type: string
title: Server Label
type:
type: string
const: mcp_call
title: Type
approval_request_id:
anyOf:
- type: string
- type: 'null'
title: Approval Request Id
error:
anyOf:
- type: string
- type: 'null'
title: Error
output:
anyOf:
- type: string
- type: 'null'
title: Output
status:
anyOf:
- type: string
enum:
- in_progress
- completed
- incomplete
- calling
- failed
- type: 'null'
title: Status
additionalProperties: true
type: object
required:
- id
- arguments
- name
- server_label
- type
title: McpCall
ImageGenerationCall:
properties:
id:
type: string
title: Id
result:
anyOf:
- type: string
- type: 'null'
title: Result
status:
type: string
enum:
- in_progress
- completed
- generating
- failed
title: Status
type:
type: string
const: image_generation_call
title: Type
additionalProperties: true
type: object
required:
- id
- status
- type
title: ImageGenerationCall
McpRequireApprovalMcpToolApprovalFilterNever:
properties:
read_only:
anyOf:
- type: boolean
- type: 'null'
title: Read Only
tool_names:
anyOf:
- items:
type: string
type: array
- type: 'null'
title: Tool Names
additionalProperties: true
type: object
title: McpRequireApprovalMcpToolApprovalFilterNever
EasyInputMessage:
properties:
content:
anyOf:
- type: string
- items:
anyOf:
- $ref: '#/components/schemas/ResponseInputText'
- $ref: '#/components/schemas/ResponseInputImage'
- $ref: '#/components/schemas/ResponseInputFile'
- $ref: '#/components/schemas/ResponseInputAudio'
type: array
title: Content
role:
type: string
enum:
- user
- assistant
- system
- developer
title: Role
type:
anyOf:
- type: string
const: message
- type: 'null'
title: Type
additionalProperties: true
type: object
required:
- content
- role
title: EasyInputMessage
ActionFind:
properties:
pattern:
type: string
title: Pattern
type:
type: string
const: find
title: Type
url:
type: string
title: Url
additionalProperties: true
type: object
required:
- pattern
- type
- url
title: ActionFind
ActionScroll:
properties:
scroll_x:
type: integer
title: Scroll X
scroll_y:
type: integer
title: Scroll Y
type:
type: string
const: scroll
title: Type
x:
type: integer
title: X
y:
type: integer
title: Y
additionalProperties: true
type: object
required:
- scroll_x
- scroll_y
- type
- x
- y
title: ActionScroll
ResponseCustomToolCall:
properties:
call_id:
type: string
title: Call Id
input:
type: string
title: Input
name:
type: string
title: Name
type:
type: string
const: custom_tool_call
title: Type
id:
anyOf:
- type: string
- type: 'null'
title: Id
additionalProperties: true
type: object
required:
- call_id
- input
- name
- type
title: ResponseCustomToolCall
ResponseFunctionToolCall:
properties:
arguments:
type: string
title: Arguments
call_id:
type: string
title: Call Id
name:
type: string
title: Name
type:
type: string
const: function_call
title: Type
id:
anyOf:
- type: string
- type: 'null'
title: Id
status:
anyOf:
- type: string
enum:
- in_progress
- completed
- incomplete
- type: 'null'
title: Status
additionalProperties: true
type: object
required:
- arguments
- call_id
- name
- type
title: ResponseFunctionToolCall
ActionClick:
properties:
button:
type: string
enum:
- left
- right
- wheel
- back
- forward
title: Button
type:
type: string
const: click
title: Type
x:
type: integer
title: X
y:
type: integer
title: Y
additionalProperties: true
type: object
required:
- button
- type
- x
- y
title: ActionClick
McpRequireApprovalMcpToolApprovalFilter:
properties:
always:
anyOf:
- $ref: '#/components/schemas/McpRequireApprovalMcpToolApprovalFilterAlways'
- type: 'null'
never:
anyOf:
- $ref: '#/components/schemas/McpRequireApprovalMcpToolApprovalFilterNever'
- type: 'null'
additionalProperties: true
type: object
title: McpRequireApprovalMcpToolApprovalFilter
ResponseUsage:
properties:
input_tokens:
type: integer
title: Input Tokens
input_tokens_details:
$ref: '#/components/schemas/InputTokensDetails'
output_tokens:
type: integer
title: Output Tokens
output_tokens_details:
$ref: '#/components/schemas/OutputTokensDetails'
total_tokens:
type: integer
title: Total Tokens
additionalProperties: true
type: object
required:
- input_tokens
- input_tokens_details
- output_tokens
- output_tokens_details
- total_tokens
title: ResponseUsage
ComparisonFilter:
properties:
key:
type: string
title: Key
type:
type: string
enum:
- eq
- ne
- gt
- gte
- lt
- lte
title: Type
value:
anyOf:
- type: string
- type: number
- type: boolean
title: Value
additionalProperties: true
type: object
required:
- key
- type
- value
title: ComparisonFilter
ResponseCodeInterpreterToolCall:
properties:
id:
type: string
title: Id
code:
anyOf:
- type: string
- type: 'null'
title: Code
container_id:
type: string
title: Container Id
outputs:
anyOf:
- items:
anyOf:
- $ref: '#/components/schemas/OutputLogs'
- $ref: '#/components/schemas/OutputImage'
type: array
- type: 'null'
title: Outputs
status:
type: string
enum:
- in_progress
- completed
- incomplete
- interpreting
- failed
title: Status
type:
type: string
const: code_interpreter_call
title: Type
additionalProperties: true
type: object
required:
- id
- container_id
- status
- type
title: ResponseCodeInterpreterToolCall
ResponseFunctionWebSearch:
properties:
id:
type: string
title: Id
action:
anyOf:
- $ref: '#/components/schemas/ActionSearch'
- $ref: '#/components/schemas/ActionOpenPage'
- $ref: '#/components/schemas/ActionFind'
title: Action
status:
type: string
enum:
- in_progress
- searching
- completed
- failed
title: Status
type:
type: string
const: web_search_call
title: Type
additionalProperties: true
type: object
required:
- id
- action
- status
- type
title: ResponseFunctionWebSearch
ResponsesRequest:
properties:
model:
type: string
minLength: 1
title: Model
description: The name of the model to use (key in model configurations).
input:
title: Input
description: Required. Input to the responses endpoint. This is forwarded to the backend and may be a string or a structured content array, depending on model support.
store:
type: boolean
title: Store
description: Whether to store the response.
default: false
file_id:
anyOf:
- type: string
- type: 'null'
title: File Id
description: Optional. Id returned by POST /v1/files (data layer). The gateway fetches the file metadata/content from the data layer and forwards a file object to vLLM.
temperature:
anyOf:
- type: number
maximum: 2.0
minimum: 0.0
- type: 'null'
title: Temperature
description: Sampling temperature (0–2, same range as chat completions).
max_output_tokens:
anyOf:
- type: integer
maximum: 150000.0
minimum: 1.0
- type: 'null'
title: Max Output Tokens
description: Upper bound on output tokens (same bounds as chat max_completion_tokens).
additionalProperties: true
type: object
required:
- model
- input
title: ResponsesRequest
description: 'Request body for the responses endpoint (/v1/responses).
Required: model, input. Optional: store, temperature, max_output_tokens. Additional
fields (e.g. text, reasoning, metadata, tools) are forwarded to the backend.'
examples:
- input: Say hello in one short sentence.
model: cai-llama-3-1-8b-slim
reasoning: {}
store: false
text:
format:
type: text
CompoundFilter:
properties:
filters:
items:
anyOf:
- $ref: '#/components/schemas/ComparisonFilter'
- {}
type: array
title: Filters
type:
type: string
enum:
- and
- or
title: Type
additionalProperties: true
type: object
required:
- filters
- type
title: CompoundFilter
ResponseComputerToolCall:
properties:
id:
type: string
title: Id
action:
anyOf:
- $ref: '#/components/schemas/ActionClick'
- $ref: '#/components/schemas/ActionDoubleClick'
- $ref: '#/components/schemas/ActionDrag'
- $ref: '#/components/schemas/ActionKeypress'
- $ref: '#/components/schemas/ActionMove'
- $ref: '#/components/schemas/ActionScreenshot'
- $ref: '#/components/schemas/ActionScroll'
- $ref: '#/components/schemas/ActionType'
- $ref: '#/components/schemas/ActionWait'
title: Action
call_id:
type: string
title: Call Id
pending_safety_checks:
items:
$ref: '#/components/schemas/PendingSafetyCheck'
type: array
title: Pending Safety Checks
status:
type: string
enum:
- in_progress
- completed
- incomplete
title: Status
type:
type: string
const: computer_call
title: Type
additionalProperties: true
type: object
required:
- id
- action
- call_id
- pending_safety_checks
- status
- type
title: ResponseComputerToolCall
ImageGenerationInputImageMask:
properties:
file_id:
anyOf:
- type: string
- type: 'null'
title: File Id
image_url:
anyOf:
- type: string
- type: 'null'
title: Image Url
additionalProperties: true
type: object
title: ImageGenerationInputImageMask
ComputerTool:
properties:
display_height:
type: integer
title: Display Height
display_width:
type: integer
title: Display Width
environment:
type: string
enum:
- windows
- mac
- linux
- ubuntu
- browser
title: Environment
type:
type: string
const: computer_use_preview
title: Type
additionalProperties: true
type: object
required:
- display_height
- display_width
- environment
- type
title: ComputerTool
InputTokensDetails:
properties:
cached_tokens:
type: integer
title: Cached Tokens
additionalProperties: true
type: object
required:
- cached_tokens
title: InputTokensDetails
Content:
properties:
text:
type: string
title: Text
type:
type: string
const: reasoning_text
title: Type
additionalProperties: true
type: object
required:
- text
- type
title: Content
ToolChoiceTypes:
properties:
type:
type: string
enum:
- file_search
- web_search_preview
- computer_use_preview
- web_search_preview_2025_03_11
- image_generation
- code_interpreter
title: Type
additionalProperties: true
type: object
required:
- type
title: ToolChoiceTypes
FunctionTool-Output:
properties:
name:
type: string
title: Name
parameters:
anyOf:
- additionalProperties: true
type: object
- type: 'null'
title: Parameters
strict:
anyOf:
- type: boolean
- type: 'null'
title: Strict
type:
type: string
const: function
title: Type
description:
anyOf:
- type: string
- type: 'null'
title: Description
additionalProperties: true
type: object
required:
- name
- type
title: FunctionTool
ResponseComputerToolCallOutputScreenshot:
properties:
type:
type: string
const: computer_screenshot
title: Type
file_id:
anyOf:
- type: string
- type: 'null'
title: File Id
image_url:
anyOf:
- type: string
- type: 'null'
title: Image Url
additionalProperties: true
type: object
required:
- type
title: ResponseComputerToolCallOutputScreenshot
Summary:
properties:
text:
type: string
title: Text
type:
type: string
const: summary_text
title: Type
additionalProperties: true
type: object
required:
- text
- type
title: Summary
ResponseTextConfig:
properties:
format:
anyOf:
- $ref: '#/components/schemas/ResponseFormatText'
- $ref: '#/components/schemas/ResponseFormatTextJSONSchemaConfig'
- $ref: '#/components/schemas/ResponseFormatJSONObject'
- type: 'null'
title: Format
verbosity:
anyOf:
- type: string
enum:
- low
- medium
- high
- type: 'null'
title: Verbosity
additionalProperties: true
type: object
title: ResponseTextConfig
McpListToolsTool:
properties:
input_schema:
title: Input Schema
name:
type: string
title: Name
annotations:
anyOf:
- {}
- type: 'null'
title: Annotations
description:
anyOf:
- type: string
- type: 'null'
title: Description
additionalProperties: true
type: object
required:
- input_schema
- name
title: McpListToolsTool
McpRequireApprovalMcpToolApprovalFilterAlways:
properties:
read_only:
anyOf:
- type: boolean
- type: 'null'
title: Read Only
tool_names:
anyOf:
- items:
type: string
type: array
- type: 'null'
title: Tool Names
additionalProperties: true
type: object
title: McpRequireApprovalMcpToolApprovalFilterAlways
ResponseOutputRefusal:
properties:
refusal:
type: string
title: Refusal
type:
type: string
const: refusal
title: Type
additionalProperties: true
type: object
required:
- refusal
- type
title: ResponseOutputRefusal
LocalShellCall:
properties:
id:
type: string
title: Id
action:
$ref: '#/components/schemas/LocalShellCallAction'
call_id:
type: string
title: Call Id
status:
type: string
enum:
- in_progress
- completed
- incomplete
title: Status
type:
type: string
const: local_shell_call
title: Type
additionalProperties: true
type: object
required:
- id
- action
- call_id
- status
- type
title: LocalShellCall
FunctionCallOutput:
properties:
call_id:
type: string
title: Call Id
output:
anyOf:
- type: string
- items:
anyOf:
- $ref: '#/components/schemas/ResponseInputTextContent'
- $ref: '#/components/schemas/ResponseInputImageContent'
- $ref: '#/components/schemas/ResponseInputFileContent'
type: array
title: Output
type:
type: string
const: function_call_output
title: Type
id:
anyOf:
- type: string
- type: 'null'
title: Id
status:
anyOf:
- type: string
enum:
- in_progress
- completed
- incomplete
- type: 'null'
title: Status
additionalProperties: true
type: object
required:
- call_id
- output
- type
title: FunctionCallOutput
ResponseInputFile:
properties:
type:
type: string
const: input_file
title: Type
file_data:
anyOf:
- type: string
- type: 'null'
title: File Data
file_id:
anyOf:
- type: string
- type: 'null'
title: File Id
file_url:
anyOf:
- type: string
- type: 'null'
title: File Url
filename:
anyOf:
- type: string
- type: 'null'
title: Filename
additionalProperties: true
type: object
required:
- type
title: ResponseInputFile
ToolChoiceAllowed:
properties:
mode:
type: string
enum:
- auto
- required
title: Mode
tools:
items:
additionalProperties: true
type: object
type: array
title: Tools
type:
type: string
const: allowed_tools
title: Type
additionalProperties: true
type: object
required:
- mode
- tools
- type
title: ToolChoiceAllowed
OutputLogs:
properties:
logs:
type: string
title: Logs
type:
type: string
const: logs
title: Type
additionalProperties: true
type: object
required:
- logs
- type
title: OutputLogs
ResponseFormatTextJSONSchemaConfig:
properties:
name:
type: string
title: Name
sche
# --- truncated at 32 KB (72 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/multiverse-computing/refs/heads/main/openapi/multiverse-computing-responses-api-openapi.yml