---
title: "Create Response"
method: POST
path: "/v1/responses"
tags: ["Intelligence"]
---

# Create Response

`POST /v1/responses`

Forward Responses API requests to the resolved upstream and track usage.

## Request body

- ResponsesCreateRequest — Request schema for responses create.
  - `model` string, required
  - `input` union, required
    - string
    - union[]
      - union
        - ResponsesInputMessage — Schema for responses input message.
          - `type` 'message', nullable
          - `id` string, nullable
          - `role` 'user' | 'assistant' | 'system' | 'developer', required
          - `content` union, required
            - string
            - union[]
              - …
          - `phase` 'commentary' | 'final_answer', nullable
        - ResponsesInputFunctionCall — Schema for responses input function call.
          - `type` 'function_call', required
          - `call_id` string, required
          - `name` string, required
          - `arguments` string, required
        - ResponsesInputFunctionCallOutput — Schema for responses input function call output.
          - `type` 'function_call_output', required
          - `call_id` string, required
          - `output` string, required
        - ResponsesInputReasoning — Schema for a native Responses reasoning replay item.
          - `type` 'reasoning', required
        - ResponsesInputAgentMessage — Schema for a Codex agent-to-agent replay item.
          - `type` 'agent_message', required
          - `id` string, nullable
          - `author` string, nullable
          - `recipient` string, nullable
          - `content` union[], required
            - union
              - …
  - `instructions` string, nullable
  - `temperature` number, nullable
  - `top_p` number, nullable — top_p must be in (0, 1].
  - `max_output_tokens` integer, nullable
  - `tools` object[], nullable
  - `tool_choice` union
    - string
    - object
  - `parallel_tool_calls` boolean
  - `stream` boolean
  - `metadata` object, nullable
  - `store` boolean
  - `previous_response_id` string, nullable

## Response `200`

Successful Response

- ResponsesCreateResponse — Response schema for creating responses.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/flower/apis/superlink-api.md) · [All operations](https://skmtc.dev/flower/apis/superlink-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/flower/superlink-api/revisions/58e8351486b3/schema)