hosts

Poll a pairing (installer; needs poll_secret)

pending, expired, approved (once, with a fresh single-use 10-minute enrollment token for POST /api/v1/agents/enroll; the pairing is consumed in the same transaction after the approver's hosting rules are re-checked), then consumed (no token; the enrolled machine's Go-live state). A wrong pairing_id or poll_secret is 404.

post/api/v1/hosts/pairings/poll

Request

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

Request body

pairing_idstring uuid required
poll_secretstring required

Example request

{
  "pairing_id": "3f0e2a55-8c1b-4d2e-9a6f-0b7c1d2e3f40"
}

Response

Pairing state.

status'pending' | 'expired' | 'approved' | 'consumed' required
enrollment_tokenstring

Only with status approved

expires_atstring date-time
go_liveboolean

Example response

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

Changes

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