# blue.catbird.circle.defs

> Published by [catbird.blue](https://lexicon.garden/identity/did:plc:xg4h4n7w5mh3m4uoi27me4hh)

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:xg4h4n7w5mh3m4uoi27me4hh/blue.catbird.circle.defs)
- [Documentation](https://lexicon.garden/lexicon/did:plc:xg4h4n7w5mh3m4uoi27me4hh/blue.catbird.circle.defs/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:xg4h4n7w5mh3m4uoi27me4hh/blue.catbird.circle.defs/examples)

## Definitions

### `blue.catbird.circle.defs#feedItem`

**Type**: `object`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `post` | `ref` → `app.bsky.feed.defs#feedViewPost` | Yes |  |
| `circle` | `ref` → `#circleSummary` | Yes |  |

### `blue.catbird.circle.defs#notification`

**Type**: `object`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `id` | `string` | Yes | Canonical lowercase hyphenated RFC 4122 UUID. |
| `actor` | `ref` → `app.bsky.actor.defs#profileViewBasic` | Yes |  |
| `circle` | `ref` → `#circleSummary` | Yes |  |
| `reason` | `string` | Yes |  |
| `subject` | `string` (at-uri) | No |  |
| `indexedAt` | `string` (datetime) | Yes |  |

### `blue.catbird.circle.defs#circleSummary`

**Type**: `object`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `uri` | `string` (space-ref) | Yes |  |
| `name` | `string` | Yes |  |
| `muted` | `boolean` | No |  |
| `owner` | `string` (did) | Yes |  |
| `circleId` | `string` (tid) | Yes | Stable Circle identity, independent of the Space key, so a Circle remains recognizable across a Space migration. |
| `memberCount` | `integer` | No | Number of members on the owner's PDS member list. The member list itself is owner-only and is read from the owner's PDS, not from this service. |

## Raw Schema

```json
{
  "id": "blue.catbird.circle.defs",
  "defs": {
    "feedItem": {
      "type": "object",
      "required": [
        "post",
        "circle"
      ],
      "properties": {
        "post": {
          "ref": "app.bsky.feed.defs#feedViewPost",
          "type": "ref"
        },
        "circle": {
          "ref": "#circleSummary",
          "type": "ref"
        }
      }
    },
    "notification": {
      "type": "object",
      "required": [
        "id",
        "reason",
        "actor",
        "indexedAt",
        "circle"
      ],
      "properties": {
        "id": {
          "type": "string",
          "maxLength": 36,
          "minLength": 36,
          "description": "Canonical lowercase hyphenated RFC 4122 UUID."
        },
        "actor": {
          "ref": "app.bsky.actor.defs#profileViewBasic",
          "type": "ref"
        },
        "circle": {
          "ref": "#circleSummary",
          "type": "ref"
        },
        "reason": {
          "enum": [
            "reply",
            "like",
            "invite"
          ],
          "type": "string"
        },
        "subject": {
          "type": "string",
          "format": "at-uri"
        },
        "indexedAt": {
          "type": "string",
          "format": "datetime"
        }
      }
    },
    "circleSummary": {
      "type": "object",
      "required": [
        "uri",
        "circleId",
        "name",
        "owner"
      ],
      "properties": {
        "uri": {
          "type": "string",
          "format": "space-ref"
        },
        "name": {
          "type": "string",
          "maxLength": 64,
          "minLength": 1
        },
        "muted": {
          "type": "boolean"
        },
        "owner": {
          "type": "string",
          "format": "did"
        },
        "circleId": {
          "type": "string",
          "format": "tid",
          "description": "Stable Circle identity, independent of the Space key, so a Circle remains recognizable across a Space migration."
        },
        "memberCount": {
          "type": "integer",
          "minimum": 0,
          "description": "Number of members on the owner's PDS member list. The member list itself is owner-only and is read from the owner's PDS, not from this service."
        }
      }
    }
  },
  "$type": "com.atproto.lexicon.schema",
  "lexicon": 1
}
```