# zone.stratos.defs

> Published by [lexicon.northsky.app](https://lexicon.garden/identity/did:plc:6uxgo3ypovauub7nblwylqyv)

✓ This is the authoritative definition for this NSID.

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:6uxgo3ypovauub7nblwylqyv/zone.stratos.defs)
- [Documentation](https://lexicon.garden/lexicon/did:plc:6uxgo3ypovauub7nblwylqyv/zone.stratos.defs/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:6uxgo3ypovauub7nblwylqyv/zone.stratos.defs/examples)

## Definitions

### `zone.stratos.defs#source`

**Type**: `object`

Indicates this record requires hydration from an external service. The stub record on the PDS contains minimal data; full content is fetched from the service endpoint.

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `vary` | `string` | Yes | Indicates when hydration is needed. 'authenticated' means full content requires viewer authentication. |
| `service` | `string` (did) | Yes | DID of the hydration service, optionally with fragment identifying the service entry (e.g., 'did:plc:abc123#atproto_pns'). |
| `subject` | `ref` → `#subjectRef` | Yes | Reference to the full record at the hydration service. |

### `zone.stratos.defs#subjectRef`

**Type**: `object`

A strong reference to a record, including its content hash for verification.

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `cid` | `string` (cid) | Yes | CID of the full record content for integrity verification. |
| `uri` | `string` (at-uri) | Yes | AT-URI of the record at the hydration service. |

## Raw Schema

```json
{
  "id": "zone.stratos.defs",
  "defs": {
    "source": {
      "type": "object",
      "required": [
        "vary",
        "subject",
        "service"
      ],
      "properties": {
        "vary": {
          "type": "string",
          "maxLength": 128,
          "description": "Indicates when hydration is needed. 'authenticated' means full content requires viewer authentication.",
          "knownValues": [
            "authenticated",
            "unauthenticated"
          ]
        },
        "service": {
          "type": "string",
          "format": "did",
          "description": "DID of the hydration service, optionally with fragment identifying the service entry (e.g., 'did:plc:abc123#atproto_pns')."
        },
        "subject": {
          "ref": "#subjectRef",
          "type": "ref",
          "description": "Reference to the full record at the hydration service."
        }
      },
      "description": "Indicates this record requires hydration from an external service. The stub record on the PDS contains minimal data; full content is fetched from the service endpoint."
    },
    "subjectRef": {
      "type": "object",
      "required": [
        "uri",
        "cid"
      ],
      "properties": {
        "cid": {
          "type": "string",
          "format": "cid",
          "description": "CID of the full record content for integrity verification."
        },
        "uri": {
          "type": "string",
          "format": "at-uri",
          "description": "AT-URI of the record at the hydration service."
        }
      },
      "description": "A strong reference to a record, including its content hash for verification."
    }
  },
  "$type": "com.atproto.lexicon.schema",
  "lexicon": 1
}
```