# net.atpix.gallery.album

> Published by [lexicon.atpix.net](https://lexicon.garden/identity/did:plc:x4crpdfko2d7xrcd5eovpwex)

✓ This is the authoritative definition for this NSID.

## Description

ATPix album container. Maps to schema:ImageGallery / schema:Collection conceptually.

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:x4crpdfko2d7xrcd5eovpwex/net.atpix.gallery.album)
- [Documentation](https://lexicon.garden/lexicon/did:plc:x4crpdfko2d7xrcd5eovpwex/net.atpix.gallery.album/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:x4crpdfko2d7xrcd5eovpwex/net.atpix.gallery.album/examples)

## Definitions

### `net.atpix.gallery.album`

**Type**: `record`

A named collection of photos with visibility and optional Permissioned Space binding.

**Key**: `tid`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `name` | `string` | Yes | dc:title · schema:name — album display name. |
| `creator` | `string` (did) | No | dc:creator — owner DID. |
| `spaceKey` | `string` | No | ATPix — skey used when creating the linked space (defaults to album rkey). |
| `spaceUri` | `string` | No | ATPix · ATP-0016 — proposal-form at://{spaceDid}/space/net.atpix.gallery.albumSpace/{skey} for permissioned albums. |
| `createdAt` | `string` (datetime) | Yes | dc:date · schema:dateCreated — RFC 3339 UTC. |
| `modifiedAt` | `string` (datetime) | No | schema:dateModified — RFC 3339 UTC. |
| `visibility` | `ref` → `net.atpix.gallery.defs#visibility` | Yes | ATPix — public, unlisted, or permissioned. |
| `description` | `string` | No | dc:description · schema:description. |
| `coverPhotoUri` | `string` (at-uri) | No | schema:image · schema:thumbnail — cover photo AT URI. |
| `collectionRuleUris` | `array` | No | ATPix — collectionRule records that seed or refresh album membership. |

## Raw Schema

```json
{
  "id": "net.atpix.gallery.album",
  "defs": {
    "main": {
      "key": "tid",
      "type": "record",
      "record": {
        "type": "object",
        "required": [
          "name",
          "createdAt",
          "visibility"
        ],
        "properties": {
          "name": {
            "type": "string",
            "maxLength": 200,
            "description": "dc:title · schema:name — album display name."
          },
          "creator": {
            "type": "string",
            "format": "did",
            "description": "dc:creator — owner DID."
          },
          "spaceKey": {
            "type": "string",
            "maxLength": 64,
            "description": "ATPix — skey used when creating the linked space (defaults to album rkey)."
          },
          "spaceUri": {
            "type": "string",
            "maxLength": 512,
            "description": "ATPix · ATP-0016 — proposal-form at://{spaceDid}/space/net.atpix.gallery.albumSpace/{skey} for permissioned albums."
          },
          "createdAt": {
            "type": "string",
            "format": "datetime",
            "description": "dc:date · schema:dateCreated — RFC 3339 UTC."
          },
          "modifiedAt": {
            "type": "string",
            "format": "datetime",
            "description": "schema:dateModified — RFC 3339 UTC."
          },
          "visibility": {
            "ref": "net.atpix.gallery.defs#visibility",
            "type": "ref",
            "description": "ATPix — public, unlisted, or permissioned."
          },
          "description": {
            "type": "string",
            "maxLength": 5000,
            "description": "dc:description · schema:description."
          },
          "coverPhotoUri": {
            "type": "string",
            "format": "at-uri",
            "description": "schema:image · schema:thumbnail — cover photo AT URI."
          },
          "collectionRuleUris": {
            "type": "array",
            "items": {
              "type": "string",
              "format": "at-uri"
            },
            "maxLength": 20,
            "description": "ATPix — collectionRule records that seed or refresh album membership."
          }
        }
      },
      "description": "A named collection of photos with visibility and optional Permissioned Space binding."
    }
  },
  "$type": "com.atproto.lexicon.schema",
  "lexicon": 1,
  "description": "ATPix album container. Maps to schema:ImageGallery / schema:Collection conceptually."
}
```