# Block a domain

Creates a new domain block that prevents or limits interactions with the specified domain. The block severity can be SUSPEND (removes all content), LIMIT (hides posts from non-followers), or NOOP (only rejects media/reports). Cannot block the instance's own domain.

RBAC: requires Federation.Manage

Endpoint: POST /api/v1/admin/domain-block
Version: 1.0
Security: 

## Request fields (application/json):

  - `domain` (string, required)
    Domain to block. Can be subdomain, i.e. example.com will block sub.example.com
    Example: "example.com"

  - `publicComment` (string, required)
    A comment visible to the general public
    Example: "Violence"

  - `state` (string, required)
    Registration mode:
      * SUSPEND - removes all content, media, and profile data for this domain's accounts from your server.
      * LIMIT - makes posts from accounts at this domain invisible to anyone who isn't following them.
      * NOOP - when you just want to reject media files or reports.
    Enum: "SUSPEND", "LIMIT", "NOOP"

  - `rejectMedia` (boolean)
    Rejects any media coming from the domain and removes already downloaded. Ignored for SUSPEND

  - `rejectReports` (boolean)
    Ignore all reports coming from this domain. Ignored for SUSPEND

  - `privateComment` (string, required)
    Comment available only for moderators

  - `obfuscate` (boolean)
    Partially obfuscate the domain name in the list

## Response 403 fields (application/json):

  - `errorCode` (string, required)
    Error code

  - `message` (string, required)
    Error message

  - `docUrl` (string)
    Link to documentation

## Response 409 fields (application/json):

  - `errorCode` (string, required)
    Error code

  - `message` (string, required)
    Error message

  - `docUrl` (string)
    Link to documentation


## Response 400 fields