hosts

Open a host pairing (installer; unauthenticated)

Called by the one-line installer (curl -fsSL https://amplerun.com/host | sudo bash). Returns a short user_code for a person to approve on /pair and a poll_secret only the installer holds; only their hashes are stored. Expires after 10 minutes. The code alone never yields a token. Rate-limited per source address.

post/api/v1/hosts/pairings

Request

  • Base URL: https://amplerun-api.spiry.org
  • URL: https://amplerun-api.spiry.org/api/v1/hosts/pairings
  • Auth: none required

Request body

Response

Pairing opened.

pairing_idstring uuid required
user_codestring required

XXXX-XXXX from an alphabet without look-alike characters

poll_secretstring required

Shown once; needed to poll.

expires_atstring date-time required
intervalinteger required

Seconds between polls.

verification_uristring required
verification_uri_completestring required

Example response

{
  "pairing_id": "3f0e2a55-8c1b-4d2e-9a6f-0b7c1d2e3f40",
  "expires_at": "2026-09-25T12:00:00Z"
}

Changes

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