# app.atmobb.moderation.action

> Published by [lexicons.atmobb.app](https://lexicon.garden/identity/did:plc:dqnwiguwsbb6uwrm7a2rsff2)

✓ This is the authoritative definition for this NSID.

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:dqnwiguwsbb6uwrm7a2rsff2/app.atmobb.moderation.action)
- [Documentation](https://lexicon.garden/lexicon/did:plc:dqnwiguwsbb6uwrm7a2rsff2/app.atmobb.moderation.action/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:dqnwiguwsbb6uwrm7a2rsff2/app.atmobb.moderation.action/examples)

## Definitions

### `app.atmobb.moderation.action`

**Type**: `record`

A moderation action taken by a forum. Lives in the forum account's repo, making moderation portable and auditable — any appview can honor it at read time.

**Key**: `tid`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `board` | `string` (at-uri) | No | Scopes account-level actions (e.g. a ban) to one board. Absent means forum-wide. |
| `action` | `string` | Yes |  |
| `reason` | `string` | No |  |
| `subject` | `union` | Yes |  |
| `createdAt` | `string` (datetime) | No |  |
| `expiresAt` | `string` (datetime) | No | When a temporary action lapses. Absent means until reversed. |

### `app.atmobb.moderation.action#account`

**Type**: `object`

An account as the subject of an action.

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `did` | `string` (did) | Yes |  |

## Raw Schema

```json
{
  "id": "app.atmobb.moderation.action",
  "defs": {
    "main": {
      "key": "tid",
      "type": "record",
      "record": {
        "type": "object",
        "required": [
          "subject",
          "action"
        ],
        "properties": {
          "board": {
            "type": "string",
            "format": "at-uri",
            "description": "Scopes account-level actions (e.g. a ban) to one board. Absent means forum-wide."
          },
          "action": {
            "type": "string",
            "maxLength": 64,
            "knownValues": [
              "hide",
              "unhide",
              "lock",
              "unlock",
              "pin",
              "unpin",
              "ban",
              "unban",
              "warn",
              "block",
              "unblock"
            ]
          },
          "reason": {
            "type": "string",
            "maxLength": 10000,
            "maxGraphemes": 1000
          },
          "subject": {
            "refs": [
              "com.atproto.repo.strongRef",
              "#account"
            ],
            "type": "union"
          },
          "createdAt": {
            "type": "string",
            "format": "datetime"
          },
          "expiresAt": {
            "type": "string",
            "format": "datetime",
            "description": "When a temporary action lapses. Absent means until reversed."
          }
        }
      },
      "description": "A moderation action taken by a forum. Lives in the forum account's repo, making moderation portable and auditable — any appview can honor it at read time."
    },
    "account": {
      "type": "object",
      "required": [
        "did"
      ],
      "properties": {
        "did": {
          "type": "string",
          "format": "did"
        }
      },
      "description": "An account as the subject of an action."
    }
  },
  "$type": "com.atproto.lexicon.schema",
  "lexicon": 1
}
```