# cloud.substratum.place.retirement

> Published by [official.fileorbit.cloud](https://lexicon.garden/identity/did:plc:s6kq5tsir7nbyrciloncz5b3)

✓ This is the authoritative definition for this NSID.

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:s6kq5tsir7nbyrciloncz5b3/cloud.substratum.place.retirement)
- [Documentation](https://lexicon.garden/lexicon/did:plc:s6kq5tsir7nbyrciloncz5b3/cloud.substratum.place.retirement/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:s6kq5tsir7nbyrciloncz5b3/cloud.substratum.place.retirement/examples)

## Definitions

### `cloud.substratum.place.retirement`

**Type**: `object`

Operator-repo tombstone for a retired Place (ADR 70). Refresh / backfill skip this placeId.

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `reason` | `string` | No | Optional retirement reason (e.g. duplicate, replaced). |
| `placeId` | `string` | Yes | Stable place id that was retired (e.g. personal_node:{peer_id}). |
| `retiredAt` | `string` (datetime) | Yes |  |
| `displayName` | `string` | No | Last known Place label at retirement (optional snapshot). |
| `operatorDid` | `string` (did) | Yes |  |

## Raw Schema

```json
{
  "id": "cloud.substratum.place.retirement",
  "defs": {
    "main": {
      "type": "object",
      "required": [
        "placeId",
        "operatorDid",
        "retiredAt"
      ],
      "properties": {
        "reason": {
          "type": "string",
          "description": "Optional retirement reason (e.g. duplicate, replaced)."
        },
        "placeId": {
          "type": "string",
          "description": "Stable place id that was retired (e.g. personal_node:{peer_id})."
        },
        "retiredAt": {
          "type": "string",
          "format": "datetime"
        },
        "displayName": {
          "type": "string",
          "description": "Last known Place label at retirement (optional snapshot)."
        },
        "operatorDid": {
          "type": "string",
          "format": "did"
        }
      },
      "description": "Operator-repo tombstone for a retired Place (ADR 70). Refresh / backfill skip this placeId."
    }
  },
  "$type": "com.atproto.lexicon.schema",
  "lexicon": 1
}
```