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-appattest-proof?string

Required on every request sent with the gateway token of an App Attest application whose authentication.app_attest.verify_on is every_request; ignored, and never forwarded, where verify_on is token_exchange and for API-key clients. Format v1.<timestamp>.<nonce>.<assertion>: decimal unix seconds from the device clock (signed, but not compared with the gateway's clock), 16 random bytes as base64url without padding, and the CBOR assertion from DCAppAttestService.generateAssertion as base64url without padding. The assertion's client data is the SHA-256 of these lines joined by \n with no trailing newline: appaigateway-request-v1, the app id, the upper-case HTTP method, the URL path and query exactly as sent, base64url(sha256(body bytes)) (an absent body hashes as empty), base64url(sha256(the bearer token)), the timestamp, and the nonce. Missing answers 401 assertion_required; refused answers 403 attest_failed. The AppAIGateway Swift package 1.4 or later computes it.

Match^v1\.[0-9]{1,12}\.[A-Za-z0-9_-]{22}\.[A-Za-z0-9_-]+$
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