Lexicon Garden

dev.knotless.awaitDelegation

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.

Repository @lexicons.knotless.dev did:plc:yqsg7znbbhfmj3a2nrpnaerk namespace authority
Details · procedure
Kindprocedure
Authorityknotless.dev
Indexed
Compare Edit in builder → Fork →

Procedure

procedure · POST

Input

application/json

state

requiredstring

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

  • maxLength: 256

Output

application/json

done

requiredboolean

Whether it was approved: false while it waits still.

gateway

string · did

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.

Similar lexicons

semantic match

Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.

  • dev.knotless.delegateWrites

    procedure

    Starts delegating the writes of the account logged in to this appview's pages to the appview's gateway, as `knotless account delegate` does.

  • dev.knotless.getDelegation

    query

    Waits, for a while, for a delegation the caller started with dev.knotless.putDelegation to be approved. Requires a service token from the caller's PDS, audience the gateway's DID, for this method.

  • dev.knotless.putDelegation

    procedure

    Starts delegating the caller's writes to a gateway. The gateway, an OAuth client of the caller's PDS, pushes an authorization request for the caller and answers with the page where the caller approves it; once they do, the gateway keeps the session, replacing any it held, to write on the caller's behalf for collaborators and batched commits. Requires a service token from the caller's PDS, audience the gateway's DID, for this method.