Servers

Provision a new VM at runtime: record its root CA identity and issue storage secrets.

Only 1.4.0+ VMs reach this route (it is behind require_cvm_proxy), and every one of them signs, so require_hotkey_auth demands a proven hotkey at the door -- no backwards-compatible "unsigned is acceptable" case exists here, unlike boot attestation. The proven identity is what the rc gate in verify_quote is given.

The RTMR3-attested runtime entry point for new VMs (supersedes /luks/attest going forward). The VM presents its per-boot root CA as the mTLS client cert; the quote's REPORTDATA binds SHA256(that cert's pubkey), so the same cert_hash check that guards /luks/attest also proves CA possession — no bespoke quote logic is needed. require_luks_quote_nonce validates and consumes the runtime nonce; the handler verifies the quote (signature + all RTMR measurements incl. RTMR3), records server.vm_root_ca_cert (idempotent), and returns rotated passphrases, the k3s encryption key, and a confirm nonce.

post/servers/{vm_name}/provision

Request

  • Base URL
    https://api.chutes.ai (the document declares no server; this is the origin it was published from)
  • URL
    https://api.chutes.ai/servers/{vm_name}/provision
  • Auth
    none declared

Path parameters

vm_namestring required

Headers

X-Chutes-Hotkeystring nullable
X-Quote-Noncestring nullable

Request body

quotestring required

Base64-encoded TDX quote (runtime type, RTMR3 extended)

volumesstring[] required

Volume names to rotate passphrases for

Response

Successful Response

string required

Changes

    • breaking

      the response's body type changed from object to string for status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • warning

      deleted the header request parameter X-Chutes-Nonce

    • warning

      deleted the header request parameter X-Chutes-Signature

    • warning

      deleted the header request parameter X-Operator-Signature