# airdress.person.*

{/* Generated by scripts/generate-event-reference.mjs from https://schemas.airdress.co/operator/events/v1.json (operator v0.1.138).
    Do not edit by hand: run `pnpm generate:event-reference` and commit the result. */}

The events in the `airdress.person` family. How to read a section, and what
each audience means, is on the [event reference](/events/) page.

## `airdress.person.contact_tag.rotated`

The person it concerns info

A person rotated their contact tag, retiring the contact link they had shared.

**Audience: the person it concerns.** About one person on the airdress. It reaches only that person: their own devices and subscriptions they made themselves. The owner's subscriptions never receive another person's events.

**Where it goes**

- **The operator's journal**, as one log line at this level, and **the event log**, where `airdress events tail` reads it.
- **Subscriptions** that name it, within its audience.
- Not functions bound to this operator's events: functions act for the owner, and this event is about someone else.

**Versions**

- Version 1: first carried by operator v0.1.138.

**Data**

| Field | Type | Required | Description |
| ----- | ---- | -------- | ----------- |
| `principal_id` | string (uuid) | yes |  |

<details>
<summary>JSON Schema</summary>

```json
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "description": "A person rotated their contact tag, retiring the contact link they had shared.",
  "properties": {
    "principal_id": {
      "format": "uuid",
      "type": "string"
    }
  },
  "required": [
    "principal_id"
  ],
  "title": "ContactTagRotated",
  "type": "object"
}
```

</details>

## `airdress.person.root.mismatched`

The person it concerns warn

A member's enrollment was refused: its person root does not match the one pinned for them.

**Audience: the person it concerns.** About one person on the airdress. It reaches only that person: their own devices and subscriptions they made themselves. The owner's subscriptions never receive another person's events.

**Where it goes**

- **The operator's journal**, as one log line at this level, and **the event log**, where `airdress events tail` reads it.
- **Subscriptions** that name it, within its audience.
- Not functions bound to this operator's events: functions act for the owner, and this event is about someone else.

**Versions**

- Version 1: first carried by operator v0.1.138.

**Data**

| Field | Type | Required | Description |
| ----- | ---- | -------- | ----------- |
| `airdress` | string | yes |  |
| `principal_id` | string (uuid) | yes |  |

<details>
<summary>JSON Schema</summary>

```json
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "description": "A member's enrollment was refused: its person root does not match the one pinned for them.",
  "properties": {
    "airdress": {
      "type": "string"
    },
    "principal_id": {
      "format": "uuid",
      "type": "string"
    }
  },
  "required": [
    "airdress",
    "principal_id"
  ],
  "title": "PersonRootMismatched",
  "type": "object"
}
```

</details>

## `airdress.person.root.pinned`

The person it concerns info

A member's person root was established on first use. The person is recorded; the journal line never carried them.

**Audience: the person it concerns.** About one person on the airdress. It reaches only that person: their own devices and subscriptions they made themselves. The owner's subscriptions never receive another person's events.

**Where it goes**

- **The operator's journal**, as one log line at this level, and **the event log**, where `airdress events tail` reads it.
- **Subscriptions** that name it, within its audience.
- Not functions bound to this operator's events: functions act for the owner, and this event is about someone else.

**Versions**

- Version 1: first carried by operator v0.1.138.

**Data**

| Field | Type | Required | Description |
| ----- | ---- | -------- | ----------- |
| `airdress` | string | yes |  |
| `confirmed_by_sign_in` | boolean | yes |  |
| `principal_id` | string (uuid) | yes |  |

<details>
<summary>JSON Schema</summary>

```json
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "description": "A member's person root was established on first use. The person is recorded; the journal line never carried them.",
  "properties": {
    "airdress": {
      "type": "string"
    },
    "confirmed_by_sign_in": {
      "type": "boolean"
    },
    "principal_id": {
      "format": "uuid",
      "type": "string"
    }
  },
  "required": [
    "airdress",
    "confirmed_by_sign_in",
    "principal_id"
  ],
  "title": "PersonRootPinned",
  "type": "object"
}
```

</details>