# Admin Domain Blocks

Administrative APIs for managing domain blocks. Provides endpoints to block specific domains with different severity levels (SUSPEND, LIMIT, NOOP), update existing blocks, unblock domains, and list currently blocked domains. Domain blocks prevent or limit federation with specified domains.

## Update domain block

 - [PUT /api/v1/admin/domain-block](https://docs.wellesley.social/openapi/admin-domain-blocks/paths/~1api~1v1~1admin~1domain-block/put.md): Modifies an existing domain block with new settings. Can change the block severity, media/report rejection settings, comments, and obfuscation. Triggers background jobs if the state changes.

RBAC: requires Federation.Manage

## List blocked domains (Admin)

 - [GET /api/v1/admin/domain-block](https://docs.wellesley.social/openapi/admin-domain-blocks/paths/~1api~1v1~1admin~1domain-block/get.md): Retrieves the complete list of domains that are blocked, including all metadata such as private comments, exact domain names, and internal settings. This endpoint is for administrators only.

RBAC:
- requires ANY of Federation.Read, Federation.Manage

## Block a domain

 - [POST /api/v1/admin/domain-block](https://docs.wellesley.social/openapi/admin-domain-blocks/paths/~1api~1v1~1admin~1domain-block/post.md): 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

## Unblock a domain

 - [DELETE /api/v1/admin/domain-block/{domain}](https://docs.wellesley.social/openapi/admin-domain-blocks/paths/~1api~1v1~1admin~1domain-block~1%7Bdomain%7D/delete.md): Removes a block from a domain to allow interactions with it again. This triggers background jobs to restore any suspended accounts and content from the domain.

RBAC: requires Federation.Manage