Cubes

Create a Cube

post/spaces/{spaceId}/cubes

Request

  • Base URL: https://krova.cloud/api/v1
  • URL: https://krova.cloud/api/v1/spaces/{spaceId}/cubes
  • Auth: API key in header X-API-KEY

Path parameters

spaceIdstring required

Headers

Idempotency-Keystring

Optional unique key (max 255 chars). Replays return the original response and add header Idempotency-Replayed: true. Scoped per space; expires after 24h.

Request body

namestring required
imagestring required
sshPublicKeystring required

SSH public key written to the Cube login user's authorized_keys at boot (~/.ssh/authorized_keys for the ubuntu or debian user; /root/.ssh/authorized_keys on Cubes created before the default-user change). GET /cubes/{cubeId}/ssh reports the login user for a given Cube. Must start with ssh-ed25519, ssh-rsa, ecdsa-sha2-, ssh-dss, or sk-@openssh.com.

regionstring

Region slug from /v1/regions (optional).

userDatastring

cloud-init script (max 16 KB, optional).

terminationProtectionboolean

Create the Cube with termination protection already on, so it is never briefly deletable between create and a follow-up PATCH. Optional; anything other than a boolean is rejected with 400.

Response

Cube created

Changes

No recorded changes to this operation across all 1 revision of this API.