---
title: "Create Response (OpenAI)"
method: POST
path: "/responses"
---

# Create Response (OpenAI)

`POST /responses`

Create a response using OpenAI's new response format

## Request body

- ResponseRequest
  - `model` string, required
  - `input` union, required
    - string
    - ResponseMessage[]
      - `role` 'user' | 'assistant' | 'system', required
      - `content` union, required
        - string
        - ResponseContentPart[]
          - union
            - InputTextContentPart
              - …
            - InputImageContentPart
              - …
            - OutputTextContentPart
              - …
  - `instructions` string — System instructions
  - `max_output_tokens` integer — Maximum output tokens
  - `temperature` number
  - `top_p` number
  - `stream` boolean
  - `tools` ResponseTool[]
    - union
      - FunctionTool
        - `type` 'function', required
        - `function` FunctionDefinition, required
          - `name` string, required
          - `description` string
          - `parameters` object
      - WebSearchTool
        - `type` 'web_search', required
        - `web_search` object
  - `tool_choice` union
    - 'auto' | 'none'
    - object
  - `web_search` boolean
  - `reasoning` ReasoningConfig
    - `effort` 'low' | 'medium' | 'high'
    - `summary` boolean
  - `metadata` object

## Response `200`

Success

- ResponseOutput
  - `id` string, required
  - `object` 'response', required
  - `created_at` integer, required
  - `status` 'in_progress' | 'completed' | 'incomplete' | 'errored', required
  - `model` string, required
  - `output` ResponseOutputItem[], required
    - `id` string, required
    - `type` 'message' | 'tool_call' | 'tool_result' | 'reasoning', required
    - `status` 'in_progress' | 'completed' | 'incomplete' | 'errored', required
    - `role` 'assistant'
    - `content` OutputTextContentPart[]
      - `type` 'output_text', required
      - `text` string, required
      - `annotations` unknown[]
        - unknown
  - `usage` ResponseUsage
    - `input_tokens` integer, required
    - `input_tokens_details` object
    - `output_tokens` integer, required
    - `output_tokens_details` object
    - `total_tokens` integer, required

---

[API](https://skmtc.dev/electronhub/apis/electron-hub-api.md) · [All operations](https://skmtc.dev/electronhub/apis/electron-hub-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/electronhub/electron-hub-api/revisions/727f9c51555b/schema)