Create new instance by accepting a provider offer

1min

PUT
https://console.vast.ai/api/v0/asks/{id}/
Production server
Creates a new instance by accepting an "ask" contract from a provider. This is the main endpoint for launching new instances on Vast.ai.
CLI Usage: vast create instance <offer_id> [options]
Authentication
BearerAuth
http
Path Parameters
id
integer
*
Body Parameters
body
object
*
template_id
integer
template_hash_id
string
image
string
disk
number
extra_env
object
runtype
string<ssh | jupyter | args>
onstart
string
label
string
image_login
string
price
number
target_state
string<running | stopped>
cancel_unavail
boolean
vm
boolean
client_id
string
apikey_id
string
Responses
200
Instance created successfully
object
success
boolean
new_contract
integer
400
Bad Request
object
success
boolean
error
string<invalid_args | invalid_price | no_ssh_key_for_vm>
msg
string
ask_id
integer
401
Unauthorized
Error
success
boolean
error
string
msg
string
403
Forbidden
object
success
boolean
error
string
msg
string
ask_id
integer
404
Offer not found
object
success
boolean
error
string
msg
string
ask_id
integer
410
Offer no longer available
object
success
boolean
error
string
msg
string
ask_id
integer
429
Too Many Requests
object
detail
string
﻿
﻿

Updated 17 Jan 2025

Did this page help you?

Change Bid Price

Destroy an instance