# place.pollen.post.atmoembed

> Published by [keith.pollen.place](https://lexicon.garden/identity/did:plc:nwgfqqv7a56aicy3d3um37ch)

✓ This is the authoritative definition for this NSID.

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:nwgfqqv7a56aicy3d3um37ch/place.pollen.post.atmoembed)
- [Documentation](https://lexicon.garden/lexicon/did:plc:nwgfqqv7a56aicy3d3um37ch/place.pollen.post.atmoembed/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:nwgfqqv7a56aicy3d3um37ch/place.pollen.post.atmoembed/examples)

## Definitions

### `place.pollen.post.atmoembed`

**Type**: `record`

Embedded content from any Atmosphere app. Single item or curated collection.

**Key**: `tid`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `cid` | `string` (cid) | No | CID of the embedded record for integrity verification. |
| `uri` | `string` (at-uri) | No | AT URI of the embedded record (single-item mode). |
| `tags` | `array` | No | Hashtags for discovery. |
| `text` | `string` | No | Optional commentary. |
| `items` | `array` | No | Multiple embedded items (collection mode). |
| `title` | `string` | No | Title of the embedded content. |
| `facets` | `array` | No | Rich text annotations for the commentary. |
| `source` | `string` | No | Identifier of the source Atmosphere app. |
| `webUrl` | `string` (uri) | No | Web URL to view the content in its native app. |
| `authorDid` | `string` (did) | No | DID of the embedded content's author. |
| `createdAt` | `string` (datetime) | Yes | Client-declared timestamp when the post was created. |
| `updatedAt` | `string` (datetime) | No | Timestamp of the most recent edit. |
| `description` | `string` | No | Description of the embedded content. |
| `authorHandle` | `string` (handle) | No | Handle of the embedded content's author. |
| `thumbnailUrl` | `string` (uri) | No | Preview image URL. |

### `place.pollen.post.atmoembed#embedItem`

**Type**: `object`

A single item in a multi-item Atmosphere collection.

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `cid` | `string` (cid) | No | CID for integrity verification. |
| `uri` | `string` (at-uri) | Yes | AT URI of the record. |
| `title` | `string` | No | Title of the content. |
| `source` | `string` | Yes | Source Atmosphere app identifier. |
| `webUrl` | `string` (uri) | No | Web URL to view the content. |
| `authorDid` | `string` (did) | Yes | DID of the content author. |
| `commentary` | `string` | No | Per-item commentary from the curator. |
| `description` | `string` | No | Description of the content. |
| `authorHandle` | `string` (handle) | No | Handle of the content author. |
| `thumbnailUrl` | `string` (uri) | No | Preview image URL. |

## Raw Schema

```json
{
  "id": "place.pollen.post.atmoembed",
  "defs": {
    "main": {
      "key": "tid",
      "type": "record",
      "record": {
        "type": "object",
        "required": [
          "createdAt"
        ],
        "properties": {
          "cid": {
            "type": "string",
            "format": "cid",
            "description": "CID of the embedded record for integrity verification."
          },
          "uri": {
            "type": "string",
            "format": "at-uri",
            "description": "AT URI of the embedded record (single-item mode)."
          },
          "tags": {
            "type": "array",
            "items": {
              "type": "string",
              "maxLength": 64
            },
            "maxLength": 10,
            "description": "Hashtags for discovery."
          },
          "text": {
            "type": "string",
            "maxLength": 500,
            "description": "Optional commentary."
          },
          "items": {
            "type": "array",
            "items": {
              "ref": "#embedItem",
              "type": "ref"
            },
            "maxLength": 20,
            "description": "Multiple embedded items (collection mode)."
          },
          "title": {
            "type": "string",
            "maxLength": 300,
            "description": "Title of the embedded content."
          },
          "facets": {
            "type": "array",
            "items": {
              "ref": "place.pollen.richtext.facet#main",
              "type": "ref"
            },
            "description": "Rich text annotations for the commentary."
          },
          "source": {
            "type": "string",
            "maxLength": 200,
            "description": "Identifier of the source Atmosphere app."
          },
          "webUrl": {
            "type": "string",
            "format": "uri",
            "description": "Web URL to view the content in its native app."
          },
          "authorDid": {
            "type": "string",
            "format": "did",
            "description": "DID of the embedded content's author."
          },
          "createdAt": {
            "type": "string",
            "format": "datetime",
            "description": "Client-declared timestamp when the post was created."
          },
          "updatedAt": {
            "type": "string",
            "format": "datetime",
            "description": "Timestamp of the most recent edit."
          },
          "description": {
            "type": "string",
            "maxLength": 1000,
            "description": "Description of the embedded content."
          },
          "authorHandle": {
            "type": "string",
            "format": "handle",
            "description": "Handle of the embedded content's author."
          },
          "thumbnailUrl": {
            "type": "string",
            "format": "uri",
            "description": "Preview image URL."
          }
        }
      },
      "description": "Embedded content from any Atmosphere app. Single item or curated collection."
    },
    "embedItem": {
      "type": "object",
      "required": [
        "uri",
        "source",
        "authorDid"
      ],
      "properties": {
        "cid": {
          "type": "string",
          "format": "cid",
          "description": "CID for integrity verification."
        },
        "uri": {
          "type": "string",
          "format": "at-uri",
          "description": "AT URI of the record."
        },
        "title": {
          "type": "string",
          "maxLength": 300,
          "description": "Title of the content."
        },
        "source": {
          "type": "string",
          "maxLength": 200,
          "description": "Source Atmosphere app identifier."
        },
        "webUrl": {
          "type": "string",
          "format": "uri",
          "description": "Web URL to view the content."
        },
        "authorDid": {
          "type": "string",
          "format": "did",
          "description": "DID of the content author."
        },
        "commentary": {
          "type": "string",
          "maxLength": 500,
          "description": "Per-item commentary from the curator."
        },
        "description": {
          "type": "string",
          "maxLength": 1000,
          "description": "Description of the content."
        },
        "authorHandle": {
          "type": "string",
          "format": "handle",
          "description": "Handle of the content author."
        },
        "thumbnailUrl": {
          "type": "string",
          "format": "uri",
          "description": "Preview image URL."
        }
      },
      "description": "A single item in a multi-item Atmosphere collection."
    }
  },
  "$type": "com.atproto.lexicon.schema",
  "lexicon": 1
}
```