---
title: "POST /openai/v1/responses"
method: POST
path: "/openai/v1/responses"
---

# POST /openai/v1/responses

`POST /openai/v1/responses`

## Request body

- object
  - `model` string
  - `input` union[]
    - union — An item in the [input] array sent to the OpenAI Responses API.
      - object
        - `role` union
          - string
          - string
          - string
          - string
        - `content` string — Plain-text message with no file attachments.
      - object
        - `type` string
        - `call_id` string
        - `output` string
      - object
        - `role` OpenaiMessageRole — unresolved $ref
        - `content` union[] — Multi-part message: text plus one or more image/file parts.
          - union
            - object
              - …
            - object — Direct URL to an image file (PNG, JPEG, GIF, WebP).
              - …
            - object — Direct URL to a non-image file (PDF, DOCX, spreadsheet, …).
              - …
  - `previous_response_id` string
  - `tools` union[]
    - union
      - object
        - `type` string
        - `name` string
        - `description` string
        - `parameters` unknown
        - `strict` boolean
        - `defer_loading` boolean
      - object
        - `type` string
        - `name` string
        - `description` string
      - object
        - `type` string
        - `execution` string
        - `description` string
      - object
        - `type` string
        - `search_context_size` string — Controls the amount of context retrieved from the web. ["low"], ["medium"] (default), or ["high"]. Higher values improve accuracy at increased cost and latency.
  - `tool_choice` string
  - `metadata` object
  - `text` object
    - `format` object
      - `type` string
      - `name` string
      - `schema` unknown
      - `strict` boolean
  - `reasoning` object
    - `effort` union
      - string
      - string
      - string
      - string
      - string
      - string
  - `organization_id` unknown

## Response `200`

OpenAI Responses API response

- object
  - `id` string
  - `output` union[]
    - union
      - object
        - `type` string
        - `call_id` string
        - `name` string
        - `arguments` union
          - string
          - string
      - object
        - `type` string
        - `content` object[]
          - `type` string
          - `text` string
          - `annotations` object[]
            - `type` string
            - `url` string
            - `title` string
            - `start_index` integer
            - `end_index` integer
      - object
        - `type` string
        - `id` string
        - `call_id` string
      - object
        - `type` string
        - `id` string
        - `call_id` string
      - object
        - `type` string
        - `id` string
        - `status` string
      - object
        - `type` string
        - `id` string
  - `usage` object
    - `input_tokens` integer
    - `output_tokens` integer
    - `total_tokens` integer
    - `input_tokens_details` object
      - `cached_tokens` integer
    - `output_tokens_details` object
      - `reasoning_tokens` integer

---

[API](https://skmtc.dev/routine/apis/routine-co.md) · [All operations](https://skmtc.dev/routine/apis/routine-co/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/routine/routine-co/revisions/efced8f8ad00/schema)