---
title: "Responses Endpoint"
method: POST
path: "/v1/responses"
---

# Responses Endpoint

`POST /v1/responses`

## Request

- Base URL: `https://api.empiriolabs.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.empiriolabs.ai/v1/responses`
- Auth: none declared
- TypeScript: <https://skmtc.dev/empiriolabs/apis/empiriolabs-gateway/docs/v1/responses/post.ts> (a function with typed inputs; its response is checked against the schema)

OpenAI Responses API surface.

Workers fall into two camps:
  1. Native Responses handler — returns real Responses shape +
     response.* SSE events. Forwarded straight through.
  2. Chat-only worker — body is translated to chat-completions
     shape, hits /v1/chat/completions, then the chat-completion
     JSON is converted back to Responses shape on the way out.
     Streaming requests pass the chat.completion.chunk SSE through
     verbatim (a separate refactor will rewrite chunks into
     response.* events).

## Response `200`

Successful Response

- unknown

---

[API](https://skmtc.dev/empiriolabs/apis/empiriolabs-gateway.md) - [All operations](https://skmtc.dev/empiriolabs/apis/empiriolabs-gateway/llms.txt) - [OpenAPI document](https://skmtc.dev/empiriolabs/apis/empiriolabs-gateway/revisions/94bb966b0560?raw)
