Call a server-configured named endpoint
The endpoint's provider, model, fixed parameters, output cap, and fallback chain come from the application configuration, so you can change models without shipping a client release. Responses-style endpoints accept an OpenAI Responses body; transcription-style endpoints accept an OpenAI audio transcription multipart body and may omit the model field. The successful response keeps the serving provider's native format and streaming behaviour.
Authorization
GatewayBearer A gateway access token, or an application API key for an issuer-less API-key app.
In: header
Path Parameters
^[a-z0-9-]{1,64}$Header Parameters
Required for gateway-token clients; optional for issuer-less API-key clients.
Optional configured end-user identity for issuer-less API-key applications.
TypeScript Definitions
Use the request body type in TypeScript.
OpenAI Responses API body for endpoints whose api_style is responses. The gateway overwrites model and deep-merges the configured params.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/apps/string/endpoints/string" \ -H "Content-Type: application/json" \ -d '{ "property1": null, "property2": null }'null