v1

latestOpenAPI 3.1.02026-07-13897404.3 KB

Machines

list machine

Creates or updates ask contracts for a machine to list it for rent on the vast.ai platform. Allows setting pricing, minimum GPU requirements, end date and discount rates.

CLI Usage: vastai list machine <machine_id> [options]

put/api/v0/machines/create_asks/

Request body

machineinteger required

ID of the machine to list

price_gpunumber float

Price per GPU per hour

price_disknumber float

Price per GB of disk storage

price_inetunumber float

Price per GB of upload bandwidth

price_inetdnumber float

Price per GB of download bandwidth

price_min_bidnumber float

Minimum bid price allowed

min_chunkinteger

Minimum number of GPUs that must be rented together

end_datenumber float

Unix timestamp for when the listing expires

credit_discount_maxnumber float

Maximum discount rate allowed for prepaid credits

Response

Successful response

successboolean

extendedinteger

Number of client contracts extended to new end date

msgstring

Status message if success is false

Example response

{
  "success": true,
  "extended": 2
}