POST
/
route
/
route
curl --request POST \
  --url https://run.vast.ai/route/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "endpoint": "vLLM-Qwen3-8B",
  "cost": 242
}'
{
  "endpoint": "vLLM-Qwen3-8B",
  "url": "http://192.168.1.10:8000",
  "cost": 242,
  "reqnum": 12345,
  "signature": "a1b2c3d4e5f60708090a0b0c0d0e0f101112131415161718191a1b1c1d1e1f20",
  "__request_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
endpoint
string
required

Name of the endpoint

Example:

"vLLM-Qwen3-8B"

​
cost
number
default:100
required

The estimated compute resources for the request

Required range: x >= 0
Example:

242

Response

Success response - either worker assignment or status

​
endpoint
string

Same as the input parameter

Example:

"vLLM-Qwen3-8B"

​
url
string

The address of the worker instance to send the request to

Example:

"http://192.168.1.10:8000"

​
cost
number

Same as the input parameter

Example:

242

​
reqnum
integer

Request number corresponding to this worker instance

Example:

12345

​
signature
string

Cryptographic signature authenticating the response

Example:

"a1b2c3d4e5f60708090a0b0c0d0e0f101112131415161718191a1b1c1d1e1f20"

​
__request_id
string

Unique identifier generated by the server for this request

Example:

"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"