# fyi.opensocial.label

> Published by [lexicons.opensocial.fyi](https://lexicon.garden/identity/did:plc:2gqnilpksz2e7faj3bwvo6qc)

✓ This is the authoritative definition for this NSID.

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:2gqnilpksz2e7faj3bwvo6qc/fyi.opensocial.label)
- [Documentation](https://lexicon.garden/lexicon/did:plc:2gqnilpksz2e7faj3bwvo6qc/fyi.opensocial.label/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:2gqnilpksz2e7faj3bwvo6qc/fyi.opensocial.label/examples)

## Definitions

### `fyi.opensocial.label`

**Type**: `record`

A moderation label, written by the group authority into the space its subject lives in — or, for an account, into the members space.

**Key**: `tid`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `createdAt` | `string` (datetime) | Yes |  |
| `neg` | `boolean` | No | If true, negates an earlier label with the same val on the same subject. |
| `rule` | `string` (at-uri) | No | The fyi.opensocial.rule this label cites. |
| `subject` | `union` | Yes | A record inside one of the group's spaces, or an account. A record's label lives in that record's space; an account's in the members space. |
| `val` | `string` | Yes | The label value, e.g. '!hide', '!takedown', or a group-defined value. |

## Raw Schema

```json
{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "main": {
      "description": "A moderation label, written by the group authority into the space its subject lives in — or, for an account, into the members space.",
      "key": "tid",
      "record": {
        "properties": {
          "createdAt": {
            "format": "datetime",
            "type": "string"
          },
          "neg": {
            "description": "If true, negates an earlier label with the same val on the same subject.",
            "type": "boolean"
          },
          "rule": {
            "description": "The fyi.opensocial.rule this label cites.",
            "format": "at-uri",
            "type": "string"
          },
          "subject": {
            "description": "A record inside one of the group's spaces, or an account. A record's label lives in that record's space; an account's in the members space.",
            "refs": [
              "com.atproto.admin.defs#repoRef",
              "com.atproto.repo.strongRef"
            ],
            "type": "union"
          },
          "val": {
            "description": "The label value, e.g. '!hide', '!takedown', or a group-defined value.",
            "maxLength": 128,
            "type": "string"
          }
        },
        "required": [
          "subject",
          "val",
          "createdAt"
        ],
        "type": "object"
      },
      "type": "record"
    }
  },
  "id": "fyi.opensocial.label",
  "lexicon": 1
}
```