# place.stream.chat.pinnedRecord

> Record pinning a chat message for prominent display.

- Kind: record
- Record key: tid
- Authority: chat.stream.place
- Lexicon: 1
- Published by [stream.place](https://lexicon.garden/identity/did:plc:rbvrr34edl5ddpuwcubjiost), not the NSID's authority

## Links

- [Documentation](https://lexicon.garden/lexicon/did:plc:rbvrr34edl5ddpuwcubjiost/place.stream.chat.pinnedRecord)
- [Schema JSON](https://lexicon.garden/lexicon/did:plc:rbvrr34edl5ddpuwcubjiost/place.stream.chat.pinnedRecord/schema.json)
- [Analytics](https://lexicon.garden/lexicon/did:plc:rbvrr34edl5ddpuwcubjiost/place.stream.chat.pinnedRecord/analytics)

## Record (`place.stream.chat.pinnedRecord`)

Type: record · key tid

### Properties

- `createdAt` (string · datetime, required): When this pin was created.
- `expiresAt` (string · datetime): Optional expiration time. If set, the pin is considered inactive after this time.
- `pinnedBy` (string · did): DID of the user who pinned the message.
- `pinnedMessage` (string · at-uri, required): AT-URI of the pinned chat message.

## Schema

```json
{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "main": {
      "description": "Record pinning a chat message for prominent display.",
      "key": "tid",
      "record": {
        "properties": {
          "createdAt": {
            "description": "When this pin was created.",
            "format": "datetime",
            "type": "string"
          },
          "expiresAt": {
            "description": "Optional expiration time. If set, the pin is considered inactive after this time.",
            "format": "datetime",
            "type": "string"
          },
          "pinnedBy": {
            "description": "DID of the user who pinned the message.",
            "format": "did",
            "type": "string"
          },
          "pinnedMessage": {
            "description": "AT-URI of the pinned chat message.",
            "format": "at-uri",
            "type": "string"
          }
        },
        "required": [
          "pinnedMessage",
          "createdAt"
        ],
        "type": "object"
      },
      "type": "record"
    }
  },
  "id": "place.stream.chat.pinnedRecord",
  "lexicon": 1
}
```