Open Responses websocket session

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.phaseo.app/v1/responses/ws', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "error": "error_type",
  "ok": false,
  "message": "Human-readable error message",
  "description": "Additional error details."
}

Text

Responses WebSocket

Opens a persistent websocket session for OpenAI Responses WebSocket mode. This route is currently experimental on AI Stats Gateway and is not recommended for production workloads.

WebSocket handshake uses HTTP GET upgrade semantics and returns 101 Switching Protocols on success (not 200).

This endpoint is OpenAI-only, requires openai/<model> format, and accepts response.create websocket messages. The gateway enforces store=false, allows one in-flight response per connection, and forwards OpenAI Responses streaming events back to the client.

After upgrade, runtime failures are emitted as websocket error events (for example invalid_response_create, openai_routing_failed, response_already_in_flight, model_mismatch, upstream_websocket_*) rather than additional HTTP response codes.

GET

responses

Open Responses websocket session

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.phaseo.app/v1/responses/ws', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "error": "error_type",
  "ok": false,
  "message": "Human-readable error message",
  "description": "Additional error details."
}

Experimental endpoint. Use openai/<model> format only, and prefer POST /v1/responses for production workloads.

Successful connection is HTTP 101 Switching Protocols (not 200). After upgrade, failures are emitted as WebSocket error events. For a full gateway walkthrough (connect, send turns, continue with previous_response_id, and recover from errors), see WebSocket Mode guide.

Authorizations

Authorization

string

header

required

Bearer token authentication

Response

WebSocket upgrade accepted.

Last modified on February 26, 2026

Responses Chat Completions

Start Here

Core Endpoints

Asynchronous Endpoints

Control and Management

Responses WebSocket

Authorizations

Response