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

# Create a response

`POST /v1/responses`

## Request

- Base URL: `https://api.roar-ai.com`
- URL: `https://api.roar-ai.com/v1/responses`
- Auth: HTTP bearer

OpenAI-compatible Responses API, passed through to the provider. Only models served directly by a provider that offers this endpoint can answer it — everything else returns 400 naming `/v1/chat/completions` instead. `stream: true` is supported. Of the built-in tools, `web_search` runs and is billed per search on top of tokens — the rate is on each model in `GET /client/models` (`builtinTools`), and each call shows its searches in the usage log. The other built-in tools (`file_search`, `code_interpreter`, `hosted_shell`, `image_generation`, `computer_use`) are refused. Function and custom tools work normally. Requires `inference`.

## Response `200`

The response object

## Other responses

- `400`: Unsupported model, streaming, or a fee-bearing built-in tool
- `401`: Missing or invalid key

---

[API](https://skmtc.dev/roar-ai/apis/roar-ai-api.md) · [All operations](https://skmtc.dev/roar-ai/apis/roar-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/roar-ai/apis/roar-ai-api/revisions/37e4d0d5a7fe?raw)