Pairing
Pair this client directly
Issues a device token to the signed-in caller, for the path where the user typed the server address and signed in rather than scanning a code. Requires a signed-in session. Requires the **viewer** role.
udon_session<token>
In: cookie
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
curl -X POST "https://example.com/api/pair/devices" \ -H "Content-Type: application/json" \ -d '{}'{ "token": "string", "expiresAt": "2019-08-24T14:15:22Z", "device": { "id": "string", "name": "string", "platform": "string", "createdAt": "2019-08-24T14:15:22Z", "lastSeenAt": "2019-08-24T14:15:22Z", "expiresAt": "2019-08-24T14:15:22Z", "current": true }, "user": { "id": "string", "username": "string", "role": "viewer", "disabled": true, "twoFactor": true }, "server": { "serverId": "string", "serverName": "string", "version": "string" }}Search Docker Hub GET
Search Docker Hub images, up to 25 results. An empty query returns no results. Requires the **viewer** role.
Claim a pairing code POST
Exchanges a pairing secret for a long-lived device token. Unauthenticated by necessity and rate limited hard. Wrong, expired, and already-claimed codes all answer identically, so a caller with no credential learns nothing from the difference.