Sign in
Servers

Tdx Host Profile Status

Is this host class known, and which VM images cover it? The check chutes-cvm host verify runs.

Deliberately version-free: a miner verifies a host BEFORE downloading any image, so this asks only about the topology -- "can this host run anything at all, and if so what". Whether one specific image can boot is POST /servers/tdx/preflight, which the launch path runs against the version it actually holds.

  • measurements non-empty -> the class is attestable; those are the images it can launch.
  • empty, status: pending -> registered, awaiting measurement generation. Nothing to do but retry later; re-submitting will not speed it up.
  • empty, status: unknown -> never submitted. Register it with POST /servers/tdx/host_profiles.

A POST because the API owns the fingerprint: a caller cannot ask about "my topology" without handing over the profile to be fingerprinted. Stores nothing -- the read-only counterpart to the submission route. Signed by the miner hotkey, so the signature covers the request body.

post/servers/tdx/host_profiles/status

Headers

X-Chutes-Hotkeystring nullable
X-Chutes-Signaturestring nullable
X-Chutes-Noncestring nullable
Authorizationstring nullable

Request body

Response

Successful Response

fingerprintstring required
status'accepted' | 'pending' | 'unknown' required

Retention lifecycle of a submitted host class -- monotonic, only ever advances (unknown -> pending -> accepted) and never regresses.

accepted is class-level and version-agnostic: a measurement was generated for this fingerprint at some point, so the class is on the attestable set and retained (its profile is kept for RTMR0 regeneration). It is NOT the answer to "can version X launch here" -- that is POST /servers/tdx/preflight, which joins the caller's (version, rc) to the class's measurements. Submission only reports which of the three the class is in; POST /servers/tdx/host_profiles/status reports the same lifecycle without storing anything.

detailstring required

Changes

Changed in 3 of the 11 revisions of this API.7185

  • 6543e32b21d37182See the full diff
    • ▲

      added the new required request property /

      new-required-request-property

    • ▲

      added the new required request property /

      new-required-request-property

    • ▲

      added the new required request property /

      new-required-request-property

    • ▲

      added the new required request property

      new-required-request-property

    • ▲

      added the new required request property /

      new-required-request-property

    • ▲

      added the new required request property

      new-required-request-property

    • ▲

      the / request property's min was increased to 1.00

      request-property-min-increased

    • ●

      removed the request property /

      request-property-removed

    • ●

      removed the request property /

      request-property-removed

    • ●

      removed the request property /

      request-property-removed

    • ●

      removed the request property /

      request-property-removed

    • ●

      removed the request property /

      request-property-removed

    • ●

      removed the request property

      request-property-removed

    • ●

      removed the request property

      request-property-removed

    • ●

      removed the request property

      request-property-removed

    • ●

      removed the request property

      request-property-removed

    • ●

      removed the request property /

      request-property-removed

    • ●

      removed the request property /

      request-property-removed

    • ●

      removed the request property /

      request-property-removed

    • ●

      removed the request property

      request-property-removed

    • ●

      removed the request property /

      request-property-removed

    • ●

      removed the request property /

      request-property-removed

    • ●

      removed the request property

      request-property-removed

    • ●

      removed the request property

      request-property-removed

    • ●

      removed the request property

      request-property-removed

    • ○

      added the new optional request property

      new-optional-request-property

    • ○

      added the new optional request property

      new-optional-request-property

    This revision also has 4 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • fe1de11b2a0e2See the full diff
    • ○

      added the new optional request property /

      new-optional-request-property

    • ○

      added the new optional request property /

      new-optional-request-property

  • 37e3c562aa281See the full diff
    • ○

      endpoint added

      endpoint-added

    This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog