dev.knotless.awaitDelegation

lexicons.knotless.dev

Documentation

Asks this appview's gateway whether the delegation is approved (dev.knotless.getDelegation), which waits a while for it before saying it is not yet: ask again until done. Once done, the appview remembers the gateway for the account, so that sharing a repository for writing from the pages names it. A procedure, since it writes that. Requires the session cookie the pages' login sets.

main procedure

Asks this appview's gateway whether the delegation is approved (dev.knotless.getDelegation), which waits a while for it before saying it is not yet: ask again until done. Once done, the appview remembers the gateway for the account, so that sharing a repository for writing from the pages names it. A procedure, since it writes that. Requires the session cookie the pages' login sets.

Input

Encodingapplication/json
state string Required

The delegation, as dev.knotless.delegateWrites named it.

maxLength: 256 bytes

Output

Encodingapplication/json
done boolean Required

Whether it was approved: false while it waits still.

gateway stringdid Optional

Once done, the gateway that now writes for the account.

Errors

InvalidRequest No such delegation waits, or the account refused the grant.
AuthenticationRequired No account is logged in to the pages, or its session has ended.
Try It

Requests are sent directly from your browser. Some servers may block requests due to CORS.

Base URL for XRPC calls (e.g., https://bsky.social)
Enter valid JSON for the request body
View raw schema 
{
  "description": "Asks this appview's gateway whether the delegation is approved (dev.knotless.getDelegation), which waits a while for it before saying it is not yet: ask again until done. Once done, the appview remembers the gateway for the account, so that sharing a repository for writing from the pages names it. A procedure, since it writes that. Requires the session cookie the pages' login sets.",
  "errors": [
    {
      "description": "No such delegation waits, or the account refused the grant.",
      "name": "InvalidRequest"
    },
    {
      "description": "No account is logged in to the pages, or its session has ended.",
      "name": "AuthenticationRequired"
    }
  ],
  "input": {
    "encoding": "application/json",
    "schema": {
      "properties": {
        "state": {
          "description": "The delegation, as dev.knotless.delegateWrites named it.",
          "maxLength": 256,
          "type": "string"
        }
      },
      "required": [
        "state"
      ],
      "type": "object"
    }
  },
  "output": {
    "encoding": "application/json",
    "schema": {
      "properties": {
        "done": {
          "description": "Whether it was approved: false while it waits still.",
          "type": "boolean"
        },
        "gateway": {
          "description": "Once done, the gateway that now writes for the account.",
          "format": "did",
          "type": "string"
        }
      },
      "required": [
        "done"
      ],
      "type": "object"
    }
  },
  "type": "procedure"
}

Lexicon Garden

@