dev.knotless.deleteAccountData

lexicons.knotless.dev

Documentation

Deletes the asking account's knotless data a part at a time, as `knotless delete-data` does: first the spaces of its private repositories, then each public repository as dev.knotless.deleteRepo deletes one, then whatever is left in its dev.knotless.* collections. Asked by the pages' session cookie, it deletes with the session the appview keeps for the account, up to `limit` records and spaces a call, and answers whether it is done; the pages ask again until it is, and a run cut short carries on where it stopped. Once nothing is left, the appview drops what it indexed from the account, as for one deleted at its PDS, keeping its takedowns and reports about it, and ends the account's sessions here, the pages' and MCP's, logging the browser out. Asked with a service token, as the command line asks once it has deleted the records itself, it deletes nothing, and forgets the account only once its PDS holds no knotless records. The atproto account itself, and other apps' records in it, are untouched. Only the account itself can ask.

main procedure

Deletes the asking account's knotless data a part at a time, as `knotless delete-data` does: first the spaces of its private repositories, then each public repository as dev.knotless.deleteRepo deletes one, then whatever is left in its dev.knotless.* collections. Asked by the pages' session cookie, it deletes with the session the appview keeps for the account, up to `limit` records and spaces a call, and answers whether it is done; the pages ask again until it is, and a run cut short carries on where it stopped. Once nothing is left, the appview drops what it indexed from the account, as for one deleted at its PDS, keeping its takedowns and reports about it, and ends the account's sessions here, the pages' and MCP's, logging the browser out. Asked with a service token, as the command line asks once it has deleted the records itself, it deletes nothing, and forgets the account only once its PDS holds no knotless records. The atproto account itself, and other apps' records in it, are untouched. Only the account itself can ask.

Input

Encodingapplication/json
did stringdid Required

The account whose data goes: the one asking, named again so that no call deletes it by mistake.

limit integer Optional

The most records and spaces to delete in this call.

minimum: 1maximum: 1000

Output

Encodingapplication/json
deleted integer Required

How many records and spaces this call deleted.

done boolean Required

Whether nothing is left: the appview has then forgotten the account, and logged it out.

Errors

AuthenticationRequired No account asks, or the pages' session for it has ended.
Forbidden The account asking is not the one named.
RecordsRemain Asked with a service token while the account's PDS still holds knotless records: delete them first.
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": "Deletes the asking account's knotless data a part at a time, as `knotless delete-data` does: first the spaces of its private repositories, then each public repository as dev.knotless.deleteRepo deletes one, then whatever is left in its dev.knotless.* collections. Asked by the pages' session cookie, it deletes with the session the appview keeps for the account, up to `limit` records and spaces a call, and answers whether it is done; the pages ask again until it is, and a run cut short carries on where it stopped. Once nothing is left, the appview drops what it indexed from the account, as for one deleted at its PDS, keeping its takedowns and reports about it, and ends the account's sessions here, the pages' and MCP's, logging the browser out. Asked with a service token, as the command line asks once it has deleted the records itself, it deletes nothing, and forgets the account only once its PDS holds no knotless records. The atproto account itself, and other apps' records in it, are untouched. Only the account itself can ask.",
  "errors": [
    {
      "description": "No account asks, or the pages' session for it has ended.",
      "name": "AuthenticationRequired"
    },
    {
      "description": "The account asking is not the one named.",
      "name": "Forbidden"
    },
    {
      "description": "Asked with a service token while the account's PDS still holds knotless records: delete them first.",
      "name": "RecordsRemain"
    }
  ],
  "input": {
    "encoding": "application/json",
    "schema": {
      "properties": {
        "did": {
          "description": "The account whose data goes: the one asking, named again so that no call deletes it by mistake.",
          "format": "did",
          "type": "string"
        },
        "limit": {
          "default": 400,
          "description": "The most records and spaces to delete in this call.",
          "maximum": 1000,
          "minimum": 1,
          "type": "integer"
        }
      },
      "required": [
        "did"
      ],
      "type": "object"
    }
  },
  "output": {
    "encoding": "application/json",
    "schema": {
      "properties": {
        "deleted": {
          "description": "How many records and spaces this call deleted.",
          "minimum": 0,
          "type": "integer"
        },
        "done": {
          "description": "Whether nothing is left: the appview has then forgotten the account, and logged it out.",
          "type": "boolean"
        }
      },
      "required": [
        "deleted",
        "done"
      ],
      "type": "object"
    }
  },
  "type": "procedure"
}

Lexicon Garden

@