AppAIGatewayDocs
API referenceProvider proxy

Proxy a provider-native model request

POST
/v1/apps/{app}/proxy/{provider}/{path}

The path, body, and successful response retain the selected provider's native contract. For example, OpenAI clients send v1/responses or v1/chat/completions; gateway-specific provider slug quirks are never part of the client path. The gateway validates the configured path and model, spends one request from the account's monthly allowance, and streams the upstream response without buffering.

Authorization

GatewayBearer
AuthorizationBearer <token>

A gateway access token, or an application API key for an issuer-less API-key app.

In: header

Path Parameters

app*string
provider*string
Match^[a-z0-9][a-z0-9-]{0,62}$
path*string

The provider's native API path verbatim, without a leading slash.

Header Parameters

x-app-version?string

Required for gateway-token clients; optional for issuer-less API-key clients.

x-end-user-id?string

Optional configured end-user identity for issuer-less API-key applications.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Provider-native JSON request. Consult the selected provider's API reference for the exact shape.

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/proxy/string/string" \  -H "Content-Type: application/json" \  -d '{    "property1": null,    "property2": null  }'
null