HTTP proxy for online deployments

curl --request PATCH \
  --url https://api.example.com/api/models/{model}/deployments/{name}/run/{path}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

Deployment

HTTP proxy for online deployments

Transparent proxy to the online deployment’s Spark-Serving Service.

Requires Authorization: Bearer <psk>. Accepts two credential types:

Platform PSK: Bypasses role checks and grants full access.
User PSK: The API resolves it to a Keycloak user. The user must hold at least one of the roles configured via PUT /{name}/allowed_roles. A deployment with no configured roles denies user-PSK access.

Validates the deployment status and model scope, then forwards the full request. Strips hop-by-hop headers and the inbound Authorization header before forwarding.

PATCH

api

models

{model}

deployments

{name}

run

{path}

HTTP proxy for online deployments

curl --request PATCH \
  --url https://api.example.com/api/models/{model}/deployments/{name}/run/{path}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

Headers

authorization

string | null

Path Parameters

model

string

required

name

string

required

path

string

required

Response

Successful Response

HTTP proxy for online deployments HTTP proxy for online deployments

⌘I