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

# Create a stateful agent response

`POST /v1/responses`

OpenAI-compatible Responses endpoint using previous_response_id or conversation for continuity.

## Request body

- ResponseRequest
  - `model` string — Agent name such as coding, writing, web-search, or auto.
  - `input` union, required
    - string
    - object[]
  - `previous_response_id` string
  - `conversation` union
    - string
    - object
      - `id` string
  - `store` boolean
  - `stream` boolean
  - `instructions` string
  - `reasoning` object — Controls OreoFlow reasoning effort for this response.
    - `effort` 'low' | 'medium' | 'high'

## Response `200`

Completed response or Responses SSE stream

- object

## Other responses

- `400` — Invalid request
- `503` — Server not ready

---

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