---
title: "*[OpenAI Only]* Responses API: Create a streaming model response for the given input using server-sent events."
method: POST
path: "/v1/responses#stream"
tags: ["responses"]
---

# \*\[OpenAI Only\]\* Responses API: Create a streaming model response for the given input using server-sent events.

`POST /v1/responses#stream`

## 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#stream`
- Auth: HTTP bearer

## Request body

- ResponsesRequestStream
  - `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` true: If set, partial message deltas and streaming events will be sent. For streaming responses, this must be set to true.
  - `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 stream created successfully

## 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)