dev.knotless.putDelegation

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.

Details · procedure
Kindprocedure
Authorityknotless.dev
Indexed

Procedure

procedure · POST

Output

application/json

state

requiredstring

Names the delegation to dev.knotless.getDelegation.

  • maxLength: 64

url

requiredstring · uri

The authorization page for the caller to open.

Similar lexicons

semantic match

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

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

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

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

  • Grant PDS delegation to a trusted editor. Only accessible to administrators. Delegation allows the user to write records to the Governance PDS.