---
title: "Api Register Host"
method: PUT
path: "/host"
tags: ["Hosts"]
---

# Api Register Host

`PUT /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

## Request body

- HostIn
  - `host_id` string, required
  - `ip` string, required
  - `gpu_model` string, required
  - `total_vram_gb` number, required
  - `free_vram_gb` number, required
  - `cost_per_hour` number
  - `country` string
  - `province` string
  - `versions` object, nullable
  - `corporation_name` string
  - `business_number` string
  - `gst_hst_number` string
  - `legal_name` string

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/aabiro/apis/xcelsior.md) · [All operations](https://skmtc.dev/aabiro/apis/xcelsior/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/aabiro/xcelsior/revisions/95960849edcd/schema)