Poll a pairing
Poll pairing state with the pairing’s poll_token as the bearer credential. With wait=true the request holds open (≤30 s) and returns as soon as the pairing is claimed. After a claim, the computer receives the minted Agent Token. A lost response is recoverable: the same poll credential receives the same token until its first successful Agent API use or ten minutes after first delivery. Then Relay scrubs the recovery copy and returns 410. An expired unclaimed pairing returns 404. A newer concurrent poll terminates the older one with 409 terminated_by_other_consumer.
Authorizations
Pairing poll token (rlyp_…) from POST /v1/pairings. Authorizes only polling that pairing, never the platform API.
Path Parameters
^pair_Query Parameters
Hold the request open until claimed or ~25 s pass.
Response
Current pairing state.
- Pending
- Claimed
"pending"