dev.knotless.delegateWrites
{
"$type": "com.atproto.lexicon.schema",
"defs": {
"main": {
"description": "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.",
"errors": [
{
"description": "The gateway or the account's PDS refused to start it.",
"name": "InvalidRequest"
},
{
"description": "No account is logged in to the pages, or its session has ended.",
"name": "AuthenticationRequired"
}
],
"input": {
"encoding": "application/json",
"schema": {
"properties": {},
"type": "object"
}
},
"output": {
"encoding": "application/json",
"schema": {
"properties": {
"state": {
"description": "What names this delegation to dev.knotless.awaitDelegation.",
"maxLength": 256,
"type": "string"
},
"url": {
"description": "The page at the account's authorization server where it approves the grant.",
"format": "uri",
"type": "string"
}
},
"required": [
"url",
"state"
],
"type": "object"
}
},
"type": "procedure"
}
},
"description": "Starts delegating the writes of the account logged in to this appview's pages to the appview's gateway, as `knotless delegate` does.",
"id": "dev.knotless.delegateWrites",
"lexicon": 1
}
Metadata
- DID
-
did:plc:yqsg7znbbhfmj3a2nrpnaerk - CID
-
bafyreidtem72bwyj4bjzftygt3g3e6tvwisrk3wqjhear5pc37drdqhjfy - Indexed At
- 2026-10-28 21:21 UTC
- AT-URI
-
at://did:plc:yqsg7znbbhfmj3a2nrpnaerk/com.atproto.lexicon.schema/dev.knotless.delegateWrites
Similar Lexicons
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, …
-
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.
-
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.