Proxy a provider-native model request
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 A gateway access token, or an application API key for an issuer-less API-key app.
In: header
Path Parameters
^[a-z0-9][a-z0-9-]{0,62}$The provider's native API path verbatim, without a leading slash.
Header Parameters
Required for gateway-token clients; optional for issuer-less API-key clients.
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.
^v1\.[0-9]{1,12}\.[A-Za-z0-9_-]{22}\.[A-Za-z0-9_-]+$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 }'nullGet the current user's limits, spend and block state
Get the current user's limits, spend and block state (GET /v1/apps/{app}/me) in the App AI Gateway API. Accepts a gateway token or an app API key.
Call a server-configured custom endpoint
Call a server-configured custom endpoint (POST /v1/apps/{app}/endpoints/{slug}) in the App AI Gateway API. Accepts a gateway token or an app API key.