dev.cocore.devicePair.start
Begin a device-pairing flow (OAuth 2.0 device-authorization style). Returns a `deviceId` plus a short human-typable `userCode` and the `verificationUri` where a signed-in user approves the pairing. The caller then polls `dev.cocore.devicePair.poll` until approval. The optional input lets an application (rather than a provider machine) say who it is: `appName` is shown on the approve screen, `keyName` names the minted API key so the user can recognise and revoke it, and `returnUrl` is where the approve screen sends the browser afterwards. `returnUrl` is honoured only for hosts the deployment allowlists; anything else is dropped silently, never rejected.
Details · procedure
| Kind | procedure |
|---|---|
| Authority | devicePair.cocore.dev |
| Indexed |
What's different
same NSID · two revisions from the same publisherRecords and requests that were valid against the base schema stay valid against this one.
Procedure · input
#mainappDid
compatibleNew optional property.
string · did appName
compatibleNew optional property.
string · maxLength: 40 keyName
compatibleNew optional property.
string · maxLength: 100 returnUrl
compatibleNew optional property.
string · uri · maxLength: 2000 Procedure · errors
#mainRateLimited
compatibleNew error.
RateLimited InvalidRequest
compatibleNew error.
InvalidRequest