# chat.bsky.moderation.defs

> Published by [bsky-lexicons.bsky.social](https://lexicon.garden/identity/did:plc:4v4y5r3lwsbtmsxhile2ljac)

✓ This is the authoritative definition for this NSID.

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:4v4y5r3lwsbtmsxhile2ljac/chat.bsky.moderation.defs)
- [Documentation](https://lexicon.garden/lexicon/did:plc:4v4y5r3lwsbtmsxhile2ljac/chat.bsky.moderation.defs/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:4v4y5r3lwsbtmsxhile2ljac/chat.bsky.moderation.defs/examples)

## Definitions

### `chat.bsky.moderation.defs#convoView`

**Type**: `object`

A view of a conversation for moderation purposes. Unlike chat.bsky.convo.defs#convoView, it does not include viewer-specific data (such as muted, unreadCount, status, lastMessage, lastReaction), since the requester is a moderator and not a member of the conversation. The member list is not included; use chat.bsky.moderation.getConvoMembers to list members.

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `id` | `string` | Yes |  |
| `rev` | `string` | Yes |  |
| `kind` | `union` | No | Union field that has data specific to different kinds of convos. |

### `chat.bsky.moderation.defs#groupConvo`

**Type**: `object`

Data specific to a group conversation, for moderation purposes. Unlike chat.bsky.convo.defs#groupConvo, it does not include viewer-specific data (such as unreadJoinRequestCount), since the requester is a moderator and not a member of the conversation.

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `name` | `string` | Yes | The display name of the group conversation. |
| `joinLink` | `ref` → `chat.bsky.group.defs#joinLinkView` | No |  |
| `createdAt` | `string` (datetime) | Yes |  |
| `lockStatus` | `ref` → `chat.bsky.convo.defs#convoLockStatus` | Yes | The lock status of the conversation. |
| `memberCount` | `integer` | Yes | The total number of members in the group conversation. |
| `memberLimit` | `integer` | Yes | The maximum number of members allowed in the group conversation. |
| `joinRequestCount` | `integer` | Yes | The total number of pending join requests for the group conversation. This information is only visible to the owner and to moderators. Capped at 21. |

### `chat.bsky.moderation.defs#directConvo`

**Type**: `object`

Data specific to a direct conversation, for moderation purposes.

| Property | Type | Required | Description |
|----------|------|----------|-------------|

## Raw Schema

```json
{
  "id": "chat.bsky.moderation.defs",
  "defs": {
    "convoView": {
      "type": "object",
      "required": [
        "id",
        "rev"
      ],
      "properties": {
        "id": {
          "type": "string"
        },
        "rev": {
          "type": "string"
        },
        "kind": {
          "refs": [
            "#directConvo",
            "#groupConvo"
          ],
          "type": "union",
          "description": "Union field that has data specific to different kinds of convos."
        }
      },
      "description": "A view of a conversation for moderation purposes. Unlike chat.bsky.convo.defs#convoView, it does not include viewer-specific data (such as muted, unreadCount, status, lastMessage, lastReaction), since the requester is a moderator and not a member of the conversation. The member list is not included; use chat.bsky.moderation.getConvoMembers to list members."
    },
    "groupConvo": {
      "type": "object",
      "required": [
        "createdAt",
        "joinRequestCount",
        "lockStatus",
        "memberCount",
        "memberLimit",
        "name"
      ],
      "properties": {
        "name": {
          "type": "string",
          "maxLength": 500,
          "description": "The display name of the group conversation.",
          "maxGraphemes": 50
        },
        "joinLink": {
          "ref": "chat.bsky.group.defs#joinLinkView",
          "type": "ref"
        },
        "createdAt": {
          "type": "string",
          "format": "datetime"
        },
        "lockStatus": {
          "ref": "chat.bsky.convo.defs#convoLockStatus",
          "type": "ref",
          "description": "The lock status of the conversation."
        },
        "memberCount": {
          "type": "integer",
          "description": "The total number of members in the group conversation."
        },
        "memberLimit": {
          "type": "integer",
          "description": "The maximum number of members allowed in the group conversation."
        },
        "joinRequestCount": {
          "type": "integer",
          "description": "The total number of pending join requests for the group conversation. This information is only visible to the owner and to moderators. Capped at 21."
        }
      },
      "description": "Data specific to a group conversation, for moderation purposes. Unlike chat.bsky.convo.defs#groupConvo, it does not include viewer-specific data (such as unreadJoinRequestCount), since the requester is a moderator and not a member of the conversation."
    },
    "directConvo": {
      "type": "object",
      "properties": {},
      "description": "Data specific to a direct conversation, for moderation purposes."
    }
  },
  "$type": "com.atproto.lexicon.schema",
  "lexicon": 1
}
```