# at.atjam.invitation

> Published by [atjam.at](https://lexicon.garden/identity/did:plc:b5bxdq5jyv3tvkyscu42xr7u)

✓ This is the authoritative definition for this NSID.

## Description

An invitation to participate in a round, written by an inviter on their own PDS. The inviter's DID is implicit (the record creator). Required for participation in rounds where round.joinMode is 'hosted' (only the jam organizer can invite) or 'network' (the organizer or any current participant that meets networkGate can invite). Consumers MUST validate that the creator DID is a valid inviter for the referenced round before treating an invitation — and the signup it authorizes — as authoritative. Absence of invitation is not the same as rejection; rejections, if any, are out-of-band.

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:b5bxdq5jyv3tvkyscu42xr7u/at.atjam.invitation)
- [Documentation](https://lexicon.garden/lexicon/did:plc:b5bxdq5jyv3tvkyscu42xr7u/at.atjam.invitation/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:b5bxdq5jyv3tvkyscu42xr7u/at.atjam.invitation/examples)

## Definitions

### `at.atjam.invitation`

**Type**: `record`

Declares that the record creator invites the named DID to participate in the referenced round.

**Key**: `tid`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `note` | `string` | No | Optional note to the invitee (e.g. 'Want in?', 'We need more drummers'). |
| `round` | `ref` → `com.atproto.repo.strongRef` | Yes | Strong-ref to the at.atjam.round being invited to. |
| `invitee` | `string` (did) | Yes | DID of the person being invited. Only an at.atjam.signup whose creator DID matches this value should be treated as authorized by this invitation. |
| `createdAt` | `string` (datetime) | Yes |  |

## Raw Schema

```json
{
  "id": "at.atjam.invitation",
  "defs": {
    "main": {
      "key": "tid",
      "type": "record",
      "record": {
        "type": "object",
        "required": [
          "round",
          "invitee",
          "createdAt"
        ],
        "properties": {
          "note": {
            "type": "string",
            "maxLength": 3000,
            "description": "Optional note to the invitee (e.g. 'Want in?', 'We need more drummers').",
            "maxGraphemes": 300
          },
          "round": {
            "ref": "com.atproto.repo.strongRef",
            "type": "ref",
            "description": "Strong-ref to the at.atjam.round being invited to."
          },
          "invitee": {
            "type": "string",
            "format": "did",
            "description": "DID of the person being invited. Only an at.atjam.signup whose creator DID matches this value should be treated as authorized by this invitation."
          },
          "createdAt": {
            "type": "string",
            "format": "datetime"
          }
        }
      },
      "description": "Declares that the record creator invites the named DID to participate in the referenced round."
    }
  },
  "$type": "com.atproto.lexicon.schema",
  "lexicon": 1,
  "description": "An invitation to participate in a round, written by an inviter on their own PDS. The inviter's DID is implicit (the record creator). Required for participation in rounds where round.joinMode is 'hosted' (only the jam organizer can invite) or 'network' (the organizer or any current participant that meets networkGate can invite). Consumers MUST validate that the creator DID is a valid inviter for the referenced round before treating an invitation — and the signup it authorizes — as authoritative. Absence of invitation is not the same as rejection; rejections, if any, are out-of-band."
}
```