# social.dracome.library.collection

> Published by [dracome.social](https://lexicon.garden/identity/did:plc:66dyrt2bmghwlmdteyizs5l3)

✓ This is the authoritative definition for this NSID.

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:66dyrt2bmghwlmdteyizs5l3/social.dracome.library.collection)
- [Documentation](https://lexicon.garden/lexicon/did:plc:66dyrt2bmghwlmdteyizs5l3/social.dracome.library.collection/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:66dyrt2bmghwlmdteyizs5l3/social.dracome.library.collection/examples)

## Definitions

### `social.dracome.library.collection`

**Type**: `record`

A custom collection header owned by an actor. Items are separate social.dracome.library.collection.item records that reference this record by AT-URI. The rkey is a TID minted once at first create and never changes.

**Key**: `tid`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `cover` | `blob` | No | Optional cover image for the custom collection, stored as a blob in the actor's PDS. Renderable cover URLs are resolved from this reference at read time; it is not itself a transport URL. |
| `createdAt` | `string` (datetime) | Yes | Canonical UTC instant serialized as ISO 8601 with a trailing Z suffix. |
| `description` | `string` | No | Optional free-text description of the custom collection. |
| `title` | `string` | Yes | Display title of the custom collection. Mutable, and duplicate titles across an actor's collections are allowed. |
| `updatedAt` | `string` (datetime) | No | Canonical UTC instant serialized as ISO 8601 with a trailing Z suffix. |

## Raw Schema

```json
{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "main": {
      "description": "A custom collection header owned by an actor. Items are separate social.dracome.library.collection.item records that reference this record by AT-URI. The rkey is a TID minted once at first create and never changes.",
      "key": "tid",
      "record": {
        "properties": {
          "cover": {
            "accept": [
              "image/*"
            ],
            "description": "Optional cover image for the custom collection, stored as a blob in the actor's PDS. Renderable cover URLs are resolved from this reference at read time; it is not itself a transport URL.",
            "maxSize": 2000000,
            "type": "blob"
          },
          "createdAt": {
            "description": "Canonical UTC instant serialized as ISO 8601 with a trailing Z suffix.",
            "format": "datetime",
            "type": "string"
          },
          "description": {
            "description": "Optional free-text description of the custom collection.",
            "maxGraphemes": 2048,
            "maxLength": 8192,
            "type": "string"
          },
          "title": {
            "description": "Display title of the custom collection. Mutable, and duplicate titles across an actor's collections are allowed.",
            "maxGraphemes": 256,
            "maxLength": 1024,
            "minLength": 1,
            "type": "string"
          },
          "updatedAt": {
            "description": "Canonical UTC instant serialized as ISO 8601 with a trailing Z suffix.",
            "format": "datetime",
            "type": "string"
          }
        },
        "required": [
          "title",
          "createdAt"
        ],
        "type": "object"
      },
      "type": "record"
    }
  },
  "id": "social.dracome.library.collection",
  "lexicon": 1
}
```