hosts

Approve a pairing code (verified session, or an API key with the host scope)

The consent step of one-line host onboarding. Applies the same hosting rules as createEnrollmentToken (verified email, host scope, admin block, new-host cap; the first use turns hosting on). go_live (default true) lists the machine's seeded offer, unverified, on its first healthy heartbeat through the same path as listMachine with x-accept-unverified, paid-admission guard included. Audited. Wrong codes are limited as in lookup.

post/api/v1/hosts/pairings/approve

Request

  • Base URL: https://amplerun-api.spiry.org
  • URL: https://amplerun-api.spiry.org/api/v1/hosts/pairings/approve
  • Auth: HTTP bearer

Headers

Idempotency-Keystring uuid required
Example:3f0e2a55-8c1b-4d2e-9a6f-0b7c1d2e3f40

UUID scoped to authenticated principal, route and canonical request hash.

Request body

user_codestring required
go_liveboolean

Response

Approved.

approvedunknown required
go_liveboolean required
summaryobject required

Changes

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