Lexicon Garden

dev.knotless.delegateWrites

Asks this appview's gateway, with a service token the account's PDS mints for the session the appview keeps for it, to take its writes (dev.knotless.putDelegation). The gateway asks the account's authorization server for a grant of its own, of the knotless records and blobs alone, which the account approves at the page this answers with; dev.knotless.awaitDelegation then waits for that. Once approved, sharing a repository for writing names the gateway, through which collaborators push. 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

Output

application/json

state

requiredstring

What names this delegation to dev.knotless.awaitDelegation.

  • maxLength: 256

url

requiredstring · uri

The page at the account's authorization server where it approves the grant.

Errors

InvalidRequest

The gateway or the account's PDS refused to start it.

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.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.

  • dev.knotless.awaitDelegation

    procedure

    Waits a while for the account logged in to this appview's pages to approve a delegation dev.knotless.delegateWrites started.

  • dev.knotless.shareRepo

    procedure

    Lets an account push to a repository, or read a private one.

  • 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.