id.sifa.endorsement

{
  "id": "id.sifa.endorsement",
  "defs": {
    "main": {
      "key": "tid",
      "type": "record",
      "record": {
        "type": "object",
        "required": [
          "subject",
          "skillName",
          "createdAt"
        ],
        "properties": {
          "skill": {
            "ref": "com.atproto.repo.strongRef",
            "type": "ref",
            "description": "StrongRef to the id.sifa.profile.skill record being endorsed. The AT-URI identifies the skill, and the CID pins the version. Optional: when absent, the endorser is proposing a skill the subject has not listed, named by skillName. The subject materialises the skill record on acceptance and links it from their id.sifa.endorsement.confirmation, since only they can write to their own repository."
          },
          "comment": {
            "type": "string",
            "maxLength": 3000,
            "description": "Optional brief comment explaining the endorsement.",
            "maxGraphemes": 300
          },
          "subject": {
            "type": "string",
            "format": "did",
            "description": "DID of the user whose skill is being endorsed."
          },
          "createdAt": {
            "type": "string",
            "format": "datetime",
            "description": "Client-declared timestamp when this endorsement was created."
          },
          "skillName": {
            "type": "string",
            "maxLength": 640,
            "minLength": 1,
            "description": "Skill name at endorsement time. When skill is present this is captured from the endorsed record and acts as the anchor: if the skill is later renamed, this value lets the AppView detect that the endorsed claim may no longer match the current record. When skill is absent this is the proposed name for a skill the subject does not yet have. Stored in the endorser's PDS, so the endorsee cannot modify it.",
            "maxGraphemes": 64
          },
          "positionRef": {
            "ref": "com.atproto.repo.strongRef",
            "type": "ref",
            "description": "Optional reference to the id.sifa.position record this endorsement relates to. When present, indicates the endorsement is contextualised to a specific role rather than a general skill."
          },
          "credentialRef": {
            "ref": "com.atproto.repo.strongRef",
            "type": "ref",
            "description": "Optional reference to an education or credential record this endorsement confirms. May be set alongside positionRef when the endorsement relates to both a role and a credential."
          }
        }
      },
      "description": "Record representing an endorsement of another user's claimed skill."
    }
  },
  "$type": "com.atproto.lexicon.schema",
  "lexicon": 1,
  "description": "An endorsement of another user's skill. Lives in the endorser's PDS; the endorser is implicit (whoever owns the repository). May endorse a skill the subject already lists, or propose one they do not."
}