Skip to main content
POST
Route Serverless Request

Authorizations

Authorization
string
header
required

API key must be provided in the Authorization header

Body

application/json
endpoint_id
integer

Endpoint group id (supply this or endpoint).

endpoint
string

Endpoint group name (supply this or endpoint_id).

api_key
string

Endpoint API key. May instead be supplied as a Bearer token in the Authorization header.

cost
number

Estimated request cost in cost units (must be ≥ 0).

latency
number

Average time a single worker takes to complete this request, in seconds.

request_idx
integer

Request index; 0 (or omitted) starts a new request, a prior value re-polls it.

guid
integer

Client-supplied request identifier.

replay_timeout
number

Seconds after which an unanswered request may be replayed on another worker.

Response

Success

endpoint
string
request_idx
integer
url
string

Worker URL to send the request to (present when a worker is ready).

cost
number
reqnum
integer
signature
string

Router signature the worker validates before serving the request.

status
string

Set when no worker URL is returned (e.g. "endpoint stopped").