---
title: "Run a turn (OpenAI Responses compatible)"
method: POST
path: "/v1/responses"
---

# Run a turn (OpenAI Responses compatible)

`POST /v1/responses`

## Request

- Base URL: `https://api.harnessrouter.ai`
- URL: `https://api.harnessrouter.ai/v1/responses`
- Auth: none declared

## Request body

- CreateResponseBody
  - `model` string, nullable
  - `input` unknown
  - `stream` boolean
  - `previous_response_id` string, nullable
  - `store` boolean
  - `instructions` string, nullable
  - `max_output_tokens` integer, nullable
  - `background` boolean
  - `metadata` object, nullable
  - `tools` unknown[], nullable
    - unknown
  - `include` unknown[], nullable
    - unknown
  - `backend` string, nullable
  - `max_step` integer, nullable
  - `timeout_seconds` integer, nullable
  - `max_cost_usd` number, nullable
  - `reasoning` object, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

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