# computer.localnetwork.people.link

> An invite link to a performer's, party's or venue's space. Written by the Local Network root account, which shows the link's token once and keeps only its hash. Deleting it revokes the link, which happens too when whoever made it can no longer add people.

- Kind: record
- Record key: tid
- Authority: people.localnetwork.computer
- Lexicon: 1
- Published by [localnetwork.computer](https://lexicon.garden/identity/did:plc:d42l64gsczg6qh2vo243xv5l), not the NSID's authority

## Links

- [Documentation](https://lexicon.garden/lexicon/did:plc:d42l64gsczg6qh2vo243xv5l/computer.localnetwork.people.link)
- [Schema JSON](https://lexicon.garden/lexicon/did:plc:d42l64gsczg6qh2vo243xv5l/computer.localnetwork.people.link/schema.json)
- [Analytics](https://lexicon.garden/lexicon/did:plc:d42l64gsczg6qh2vo243xv5l/computer.localnetwork.people.link/analytics)

## Record (`computer.localnetwork.people.link`)

Type: record · key tid

### Properties

- `capabilities` (ref, required): What joining with the link gives. Never people.manage.
  - Reference: `computer.localnetwork.people.defs#capabilities`
- `createdAt` (string · datetime, required)
- `createdBy` (string · did, required)
- `expiresAt` (string · datetime)
- `role` (ref, required)
  - Reference: `computer.localnetwork.people.defs#role`
- `staff` (boolean): Set when staff made it. It works whoever is in the space. One made by someone in the space stops working once they can't add people.
- `tokenHash` (string, required): The base64url SHA-256 of the link's token.
  - Constraints: maxLength: 64

## Schema

```json
{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "main": {
      "description": "An invite link to a performer's, party's or venue's space. Written by the Local Network root account, which shows the link's token once and keeps only its hash. Deleting it revokes the link, which happens too when whoever made it can no longer add people.",
      "key": "tid",
      "record": {
        "properties": {
          "capabilities": {
            "description": "What joining with the link gives. Never people.manage.",
            "ref": "computer.localnetwork.people.defs#capabilities",
            "type": "ref"
          },
          "createdAt": {
            "format": "datetime",
            "type": "string"
          },
          "createdBy": {
            "format": "did",
            "type": "string"
          },
          "expiresAt": {
            "format": "datetime",
            "type": "string"
          },
          "role": {
            "ref": "computer.localnetwork.people.defs#role",
            "type": "ref"
          },
          "staff": {
            "description": "Set when staff made it. It works whoever is in the space. One made by someone in the space stops working once they can't add people.",
            "type": "boolean"
          },
          "tokenHash": {
            "description": "The base64url SHA-256 of the link's token.",
            "maxLength": 64,
            "type": "string"
          }
        },
        "required": [
          "tokenHash",
          "role",
          "capabilities",
          "createdBy",
          "createdAt"
        ],
        "type": "object"
      },
      "type": "record"
    }
  },
  "id": "computer.localnetwork.people.link",
  "lexicon": 1
}
```
