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.

Repository @cocore.dev did:plc:5quuhkmwe2q4k3azfsgg7kdz namespace authority
Details · procedure
Kindprocedure
AuthoritydevicePair.cocore.dev
Indexed

What's different

same NSID · two revisions from the same publisher
devicePair.cocore.dev · namespace authority
devicePair.cocore.dev · namespace authority
6 changes, all backward compatible

Records and requests that were valid against the base schema stay valid against this one.

Procedure · input

#main
Added

appDid

compatible

New optional property.

string · did
Added

appName

compatible

New optional property.

string · maxLength: 40
Added

keyName

compatible

New optional property.

string · maxLength: 100
Added

returnUrl

compatible

New optional property.

string · uri · maxLength: 2000

Procedure · errors

#main
Added

RateLimited

compatible

New error.

RateLimited
Added

InvalidRequest

compatible

New error.

InvalidRequest
5 properties unchanged Open the full schema diff →