id.sifa.org.employmentAttestation

sifa.id

Documentation

Record representing an organization's attestation of a person's employment.

main record

Record representing an organization's attestation of a person's employment.

Record Key tid Timestamp-based ID

Properties

comment string Optional

Optional brief comment from the organization.

maxLength: 3000 bytesmaxGraphemes: 300 graphemes
companyDid string did Optional

DID of the company's ATproto account snapshot from the position record. Pin this when the position carried a companyDid but no entityRef. Part of the identity triple.

createdAt string datetime Required

Client-declared timestamp when this attestation was created.

endedAt string Optional

End date in YYYY-MM or YYYY-MM-DD format. Required context when status is 'past'.

entityRef string uri Optional

Portable entity identifier snapshot (Wikidata Q-ID URI, ROR URI, or LEI URI) from the position record. Pin this when the position carried an entityRef. Part of the identity triple. Never pin the free-text company name.

position ref com.atproto.repo.strongRef Required

StrongRef to the id.sifa.profile.position record being attested. The AT-URI identifies the position, and the CID pins the version for provenance.

startedAt string Required

Start date snapshot in YYYY-MM or YYYY-MM-DD format, mirroring the position lexicon's freeform date shape. Part of the identity triple.

status string Required

Whether the employment is current or past. Accepted values: 'current' or 'past'.

subject string did Required

DID of the employee whose employment is being attested.

title string Required

Job title snapshot from the position record at attestation time. Part of the identity triple: if the position's title later changes, this attestation is voided (the role identity changed).

maxLength: 2560 bytesminLength: 1 bytesmaxGraphemes: 256 graphemes
View raw schema 
{
  "key": "tid",
  "type": "record",
  "record": {
    "type": "object",
    "required": [
      "subject",
      "position",
      "status",
      "title",
      "startedAt",
      "createdAt"
    ],
    "properties": {
      "title": {
        "type": "string",
        "maxLength": 2560,
        "minLength": 1,
        "description": "Job title snapshot from the position record at attestation time. Part of the identity triple: if the position's title later changes, this attestation is voided (the role identity changed).",
        "maxGraphemes": 256
      },
      "labels": {
        "refs": [
          "com.atproto.label.defs#selfLabels"
        ],
        "type": "union",
        "description": "Self-label values for this attestation record."
      },
      "status": {
        "type": "string",
        "description": "Whether the employment is current or past. Accepted values: 'current' or 'past'."
      },
      "comment": {
        "type": "string",
        "maxLength": 3000,
        "description": "Optional brief comment from the organization.",
        "maxGraphemes": 300
      },
      "endedAt": {
        "type": "string",
        "description": "End date in YYYY-MM or YYYY-MM-DD format. Required context when status is 'past'."
      },
      "subject": {
        "type": "string",
        "format": "did",
        "description": "DID of the employee whose employment is being attested."
      },
      "position": {
        "ref": "com.atproto.repo.strongRef",
        "type": "ref",
        "description": "StrongRef to the id.sifa.profile.position record being attested. The AT-URI identifies the position, and the CID pins the version for provenance."
      },
      "createdAt": {
        "type": "string",
        "format": "datetime",
        "description": "Client-declared timestamp when this attestation was created."
      },
      "entityRef": {
        "type": "string",
        "format": "uri",
        "description": "Portable entity identifier snapshot (Wikidata Q-ID URI, ROR URI, or LEI URI) from the position record. Pin this when the position carried an entityRef. Part of the identity triple. Never pin the free-text company name."
      },
      "startedAt": {
        "type": "string",
        "description": "Start date snapshot in YYYY-MM or YYYY-MM-DD format, mirroring the position lexicon's freeform date shape. Part of the identity triple."
      },
      "companyDid": {
        "type": "string",
        "format": "did",
        "description": "DID of the company's ATproto account snapshot from the position record. Pin this when the position carried a companyDid but no entityRef. Part of the identity triple."
      }
    }
  },
  "description": "Record representing an organization's attestation of a person's employment."
}

Lexicon Garden

@