v2

latestOpenAPI 3.0.3Apache 2.0raw.githubusercontent.com2026-01-12412664.0 KB
Gateway - Proxy

Proxy POST Request

Proxy POST requests to external services with automatic secret injection. The target URL is specified via the X-Target-Base-URL header. Note: X-Target-Base-URL is treated as a base URL; the final upstream URL is composed as:

<base>.rstrip('/') + '/' + {path}.lstrip('/').
post/proxy/{path}

Path parameters

pathstring required
Example:v1/chat/completions

The path component to append to the target URL

Headers

X-Target-Base-URLstring required
Example:https://api.openai.com

The base URL of the target service

Authorizationstring required
Example:Bearer eyJhbGciOiJIUzI1NiIs...

Bearer JWT token from the Control Plane

Request body

object required

Request payload for the target service

Example request

{
  "model": "gpt-4",
  "messages": [
    {
      "role": "user",
      "content": "Hello"
    }
  ],
  "max_tokens": 100
}

Response

Request proxied successfully

object required

Response from the target service