dev.knotless.addEmail

lexicons.knotless.dev

{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "email": {
      "description": "An address, as git authors commits with it.",
      "properties": {
        "email": {
          "description": "The address. Case and spaces around it do not count.",
          "maxLength": 320,
          "type": "string"
        }
      },
      "required": [
        "email"
      ],
      "type": "object"
    },
    "emailState": {
      "description": "What claiming an address, or taking the claim back, did.",
      "properties": {
        "changed": {
          "description": "Whether it changed anything: false for an address claimed already, or, taken back, never claimed.",
          "type": "boolean"
        },
        "count": {
          "description": "How many addresses the account claims now.",
          "minimum": 0,
          "type": "integer"
        }
      },
      "required": [
        "changed",
        "count"
      ],
      "type": "object"
    },
    "main": {
      "description": "Adds the address's hash to the dev.knotless.emails record of the account logged in to this appview's web pages, as `knotless email add` does, so commits authored with it show as the account's on repositories it owns or pushes to. Requires the session cookie the pages' login sets: the appview writes with the session it keeps for that account.",
      "errors": [
        {
          "description": "No email address.",
          "name": "InvalidRequest"
        },
        {
          "description": "No account is logged in to the pages, or its session has ended.",
          "name": "AuthenticationRequired"
        }
      ],
      "input": {
        "encoding": "application/json",
        "schema": {
          "ref": "#email",
          "type": "ref"
        }
      },
      "output": {
        "encoding": "application/json",
        "schema": {
          "ref": "#emailState",
          "type": "ref"
        }
      },
      "type": "procedure"
    }
  },
  "description": "Claims an email address as the account logged in to this appview's pages.",
  "id": "dev.knotless.addEmail",
  "lexicon": 1
}

Validate Record

Validate a record against dev.knotless.addEmail

Validation Options
Treat any remaining unresolved references as valid

Metadata

DID
did:plc:yqsg7znbbhfmj3a2nrpnaerk
CID
bafyreigjdg76jekuko2tilg2dvqkljyziuwgxbbzisjmi6p6yz3lfjr3ui
Indexed At
2026-10-28 21:21 UTC
AT-URI
at://did:plc:yqsg7znbbhfmj3a2nrpnaerk/com.atproto.lexicon.schema/dev.knotless.addEmail

Similar Lexicons

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

  • Takes back the claim to an email address of the account logged in to this appview's pages.

  • How many email addresses the asking account claims as its.

  • The email addresses an account's commits are authored as, so pages can show those commits as the account's.

Lexicon Garden

@