dev.cocore.devicePair.poll
Poll a device-pairing attempt by `deviceId`. While the user has not acted, returns `pending`. On approval, returns `session` together with the granted provider session. Terminal negative states are `denied`, `expired`, and `consumed`. An unknown `deviceId` is `unknown`.
Details · query
| Kind | query |
|---|---|
| Authority | devicePair.cocore.dev |
| Indexed |
Checks
Validunlimited-stringdefs.main.parameters.properties.deviceIdNo maxLength, maxGraphemes or format limits this string.unlimited-stringdefs.main.output.schema.properties.statusNo maxLength, maxGraphemes or format limits this string.
{
"$type": "com.atproto.lexicon.schema",
"defs": {
"main": {
"description": "Poll a device-pairing attempt by `deviceId`. While the user has not acted, returns `pending`. On approval, returns `session` together with the granted provider session. Terminal negative states are `denied`, `expired`, and `consumed`. An unknown `deviceId` is `unknown`.",
"errors": [
{
"description": "The `deviceId` parameter is missing.",
"name": "InvalidRequest"
},
{
"description": "No pairing attempt exists for this `deviceId`.",
"name": "NotFound"
}
],
"output": {
"encoding": "application/json",
"schema": {
"properties": {
"session": {
"description": "The granted provider session; present only when `status` is `session`.",
"type": "unknown"
},
"status": {
"enum": [
"unknown",
"pending",
"denied",
"expired",
"consumed",
"session"
],
"type": "string"
}
},
"required": [
"status"
],
"type": "object"
}
},
"parameters": {
"properties": {
"deviceId": {
"type": "string"
}
},
"required": [
"deviceId"
],
"type": "params"
},
"type": "query"
}
},
"id": "dev.cocore.devicePair.poll",
"lexicon": 1
}