---
title: "Create a response"
method: POST
path: "/responses"
tags: ["Responses"]
---

# Create a response

`POST /responses`

Creates a response using an OpenAI-compatible request body. Use model ids returned by `GET /models`.

## Request body

- ResponseRequest
  - `input` union, required
    - string
    - union[]
      - union
        - string
        - ResponseInputMessage
          - `content` union, required
            - string
            - object[]
              - …
          - `role` 'system' | 'developer' | 'user' | 'assistant', required
  - `instructions` string, nullable
  - `max_output_tokens` integer, nullable
  - `model` string, required — Model id returned by `GET /models`.
  - `store` false, nullable — Set to false or omit. Stored responses are not supported by this endpoint.
  - `stream` boolean, nullable
  - `temperature` number, nullable
  - `top_p` number, nullable

## Response `200`

Response object

- ResponseResponse
  - `created_at` integer, required
  - `id` string, required
  - `model` string, required
  - `object` 'response', required
  - `output` object[], required
  - `status` string, required
  - `usage` ResponseUsage
    - `input_tokens` integer
    - `input_tokens_details` InputTokensDetails
      - `cached_tokens` integer — Input tokens served from cache for this request.
    - `output_tokens` integer
    - `total_tokens` integer

## Other responses

- `400` — Invalid request body
- `401` — Missing or invalid API key
- `402` — Insufficient API credits
- `404` — Unknown model
- `500` — Response creation failed

---

[API](https://skmtc.net/textcortex/apis/textcortex-api.md) · [All operations](https://skmtc.net/textcortex/apis/textcortex-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/textcortex/textcortex-api/revisions/434c9de75420/schema)