Hosts

Api Register Host

Register or update a host with strict admission gating.

Per REPORT_FEATURE_FINAL.md §62 and REPORT_FEATURE_2.md §37:

  • Hosts must pass node admission (version gating) before accepting work
  • Country/province recorded for jurisdiction-aware scheduling
  • Hosts register as 'pending' until agent completes benchmark + admission
  • If versions are provided inline, admission is checked immediately
put/host

Request body

host_idstring required
ipstring required
gpu_modelstring required
total_vram_gbnumber required
free_vram_gbnumber required
cost_per_hournumber
countrystring
provincestring
versionsobject nullable
corporation_namestring
business_numberstring
gst_hst_numberstring
legal_namestring

Response

Successful Response

{"stackTrail":"paths:/host:put:responses:200:content:application/json:schema","oasType":"schema","type":"unknown"}

Changes