Skip to main content
POST
/
v1
/
regions
/
{region}
/
projects
/
{project}
/
infrastructure
/
servers
/
{id}
:provision
Provision server
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({osImage: '<string>', configuration: {}})
};

fetch('https://api.k0rdent.ai/v1/regions/{region}/projects/{project}/infrastructure/servers/{id}:provision', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
{
  "jobId": "<string>",
  "status": "queued"
}

Authorizations

Authorization
string
header
required

Bearer token authentication using OAuth2/OIDC tokens

Path Parameters

region
string
required

Region identifier

project
string
required

Project identifier

id
string<uuid>
required

Unique server identifier (UUID)

Body

application/json

Provisioning request details

osImage
string

OS image identifier for provisioning

configuration
object

Additional provisioning configuration

Response

Provisioning job initiated

jobId
string

Provisioning job identifier for status tracking

status
enum<string>

Initial provisioning job status

Available options:
queued,
in-progress,
completed,
failed