---
title: "*[OpenAI Only]* Responses API: Create a model response for the given input"
method: POST
path: "/v1/responses"
tags: ["responses"]
---

# \*\[OpenAI Only\]\* Responses API: Create a model response for the given input

`POST /v1/responses`

## Request

- Base URL: `https://docs.sudoapp.dev` (the document declares no server; this is the origin it was published from)
- URL: `https://docs.sudoapp.dev/v1/responses`
- Auth: HTTP bearer

## Request body

- ResponsesRequest
  - `background` boolean, nullable
  - `conversation` union
    - string
    - unknown
  - `include` unknown[], nullable
    - unknown
  - `input` union
    - string
    - InputItem[]
      - union
        - object
          - `content` union, required
            - string: Simple text content
            - ContentPart[]: Array of content parts for multimodal input
              - …
          - `role` string, required
        - union
          - object
            - `content` union, required
              - …
            - `role` string, required
            - `status` string, required
            - `type` string, required
          - object
            - `content` OutputMessage[], required
              - …
            - `id` string, required
            - `role` string, required
            - `status` string, required
            - `type` string, required
          - object
            - `id` string, required
            - `queries` unknown[], required
              - …
            - `results` unknown[], required
              - …
            - `status` string, required
            - `type` string, required
          - object
            - `action` unknown, required
            - `call_id` string, required
            - `id` string, required
            - `pending_safety_checks` unknown[], required
              - …
            - `status` string, required
            - `type` string, required
          - object
            - `acknowledged_safety_checks` unknown[], nullable
              - …
            - `call_id` string, required
            - `id` string, nullable
            - `output` unknown, required
            - `status` string, nullable
            - `type` string, required
          - object
            - `action` unknown, required
            - `id` string, required
            - `status` string, required
            - `type` string, required
          - object
            - `arguments` string, required
            - `call_id` string, required
            - `id` string, nullable
            - `name` string, required
            - `status` string, nullable
            - `type` string, required
          - object
            - `call_id` string, required
            - `id` string, nullable
            - `output` union, required
              - …
            - `status` string, nullable
            - `type` string, required
          - object
            - `content` unknown[], required
              - …
            - `encrypted_content` string, nullable
            - `id` string, required
            - `status` string, nullable
            - `summary` unknown[], required
              - …
            - `type` string, required
          - object
            - `id` string, required
            - `result` string, required
            - `status` string, required
            - `type` string, required
          - object
            - `code` string, required
            - `container_id` string, required
            - `id` string, required
            - `outputs` unknown[], required
              - …
            - `status` string, required
            - `type` string, required
          - object
            - `action` unknown, required
            - `call_id` string, required
            - `id` string, required
            - `status` string, required
            - `type` string, required
          - object
            - `id` string, required
            - `output` string, required
            - `status` string, nullable
            - `type` string, required
          - object
            - `error` string, nullable
            - `id` string, required
            - `server_label` string, required
            - `tools` unknown[], required
              - …
            - `type` string, required
          - object
            - `arguments` string, required
            - `id` string, required
            - `name` string, required
            - `server_label` string, required
            - `type` string, required
          - object
            - `approval_request_id` string, required
            - `approve` boolean, required
            - `id` string, nullable
            - `reason` string, nullable
            - `type` string, required
          - object
            - `approval_request_id` string, nullable
            - `arguments` string, required
            - `error` string, nullable
            - `id` string, required
            - `name` string, required
            - `output` string, nullable
            - `server_label` string, required
            - `status` string, nullable
            - `type` string, required
          - object
            - `call_id` string, required
            - `id` string, nullable
            - `output` union, required
              - …
            - `type` string, required
          - object
            - `call_id` string, required
            - `id` string, nullable
            - `input` string, required
            - `name` string, required
            - `type` string, required
        - object
          - `id` string, required
          - `type` string, nullable
  - `instructions` string, nullable
  - `max_output_tokens` integer, nullable
  - `max_tool_calls` integer, nullable
  - `metadata` unknown
  - `model` string, nullable
  - `parallel_tool_calls` boolean, nullable
  - `previous_response_id` string, nullable
  - `prompt` unknown
  - `prompt_cache_key` string, nullable
  - `reasoning` unknown
  - `safety_identifier` string, nullable
  - `service_tier` string, nullable
  - `store` boolean, nullable
  - `stream` false: If set, partial message deltas and streaming events will be sent. For regular HTTP responses, this must be false.
  - `stream_options` unknown
  - `temperature` number, float, nullable
  - `text` unknown
  - `tool_choice` union
    - string
    - unknown
  - `tools` unknown[], nullable
    - unknown
  - `top_logprobs` integer, nullable
  - `top_p` number, float, nullable
  - `truncation` string, nullable

## Response `200`

Response created successfully

- Response
  - `background` boolean, nullable: Whether the response was generated in the background
  - `conversation` ResponseConversation
    - `id` string, required
  - `created_at` integer, required: Unix timestamp (in seconds) when the response was created
  - `error` unknown
  - `id` string, required: Unique identifier for the response
  - `incomplete_details` IncompleteDetails
    - `reason` string, required: The reason the response is incomplete
  - `instructions` union
    - string
    - unknown[]
      - unknown
  - `max_output_tokens` integer, nullable: Maximum number of output tokens
  - `max_tool_calls` integer, nullable: Maximum number of tool calls
  - `metadata` unknown
  - `model` string, required: The model used to generate the response
  - `object` string, required: The object type, always "response"
  - `output` Item[], nullable: The output items generated by the model
    - union
      - object
        - `content` union, required
          - string: Simple text content
          - ContentPart[]: Array of content parts for multimodal input
            - union
              - …
        - `role` string, required
        - `status` string, required
        - `type` string, required
      - object
        - `content` OutputMessage[], required
          - union
            - object
              - …
            - object
              - …
        - `id` string, required
        - `role` string, required
        - `status` string, required
        - `type` string, required
      - object
        - `id` string, required
        - `queries` unknown[], required
          - unknown
        - `results` unknown[], required
          - unknown
        - `status` string, required
        - `type` string, required
      - object
        - `action` unknown, required
        - `call_id` string, required
        - `id` string, required
        - `pending_safety_checks` unknown[], required
          - unknown
        - `status` string, required
        - `type` string, required
      - object
        - `acknowledged_safety_checks` unknown[], nullable
          - unknown
        - `call_id` string, required
        - `id` string, nullable
        - `output` unknown, required
        - `status` string, nullable
        - `type` string, required
      - object
        - `action` unknown, required
        - `id` string, required
        - `status` string, required
        - `type` string, required
      - object
        - `arguments` string, required
        - `call_id` string, required
        - `id` string, nullable
        - `name` string, required
        - `status` string, nullable
        - `type` string, required
      - object
        - `call_id` string, required
        - `id` string, nullable
        - `output` union, required
          - string
          - unknown[]
            - unknown
        - `status` string, nullable
        - `type` string, required
      - object
        - `content` unknown[], required
          - unknown
        - `encrypted_content` string, nullable
        - `id` string, required
        - `status` string, nullable
        - `summary` unknown[], required
          - unknown
        - `type` string, required
      - object
        - `id` string, required
        - `result` string, required
        - `status` string, required
        - `type` string, required
      - object
        - `code` string, required
        - `container_id` string, required
        - `id` string, required
        - `outputs` unknown[], required
          - unknown
        - `status` string, required
        - `type` string, required
      - object
        - `action` unknown, required
        - `call_id` string, required
        - `id` string, required
        - `status` string, required
        - `type` string, required
      - object
        - `id` string, required
        - `output` string, required
        - `status` string, nullable
        - `type` string, required
      - object
        - `error` string, nullable
        - `id` string, required
        - `server_label` string, required
        - `tools` unknown[], required
          - unknown
        - `type` string, required
      - object
        - `arguments` string, required
        - `id` string, required
        - `name` string, required
        - `server_label` string, required
        - `type` string, required
      - object
        - `approval_request_id` string, required
        - `approve` boolean, required
        - `id` string, nullable
        - `reason` string, nullable
        - `type` string, required
      - object
        - `approval_request_id` string, nullable
        - `arguments` string, required
        - `error` string, nullable
        - `id` string, required
        - `name` string, required
        - `output` string, nullable
        - `server_label` string, required
        - `status` string, nullable
        - `type` string, required
      - object
        - `call_id` string, required
        - `id` string, nullable
        - `output` union, required
          - string
          - unknown[]
            - unknown
        - `type` string, required
      - object
        - `call_id` string, required
        - `id` string, nullable
        - `input` string, required
        - `name` string, required
        - `type` string, required
  - `parallel_tool_calls` boolean, nullable: Whether parallel tool calls are enabled
  - `previous_response_id` string, nullable: ID of the previous response
  - `prompt` unknown
  - `prompt_cache_key` string, nullable: Prompt cache key
  - `reasoning` unknown
  - `safety_identifier` string, nullable: Safety identifier
  - `service_tier` string, nullable: Service tier used
  - `status` string, required: The status of the response (e.g., "in_progress", "completed", "failed", "cancelled", "incomplete")
  - `temperature` number, float, nullable: Temperature sampling parameter
  - `text` unknown
  - `tool_choice` union
    - string
    - unknown
  - `tools` unknown[], nullable: Tools available to the model
    - unknown
  - `top_logprobs` integer, nullable: Number of top log probabilities to return
  - `top_p` number, float, nullable: Top-p sampling parameter
  - `truncation` string, nullable: Truncation strategy
  - `usage` ResponseUsage
    - `input_tokens` integer, required: Number of tokens in the input
    - `input_tokens_details` unknown
    - `output_tokens` integer, required: Number of tokens in the output
    - `output_tokens_details` unknown
    - `total_tokens` integer, required: Total number of tokens used

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `500`: Internal server error
- `502`: Bad gateway error

---

[API](https://skmtc.dev/sudoapp/apis/sudo-api.md) - [All operations](https://skmtc.dev/sudoapp/apis/sudo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sudoapp/apis/sudo-api/revisions/7d59684bf816?raw)