# Admin FASP

Administrative endpoints for managing FASP (Fediverse Auxiliary Service Provider) provider registrations and default capability assignments. Allows accepting, declining, and blocking providers, as well as configuring which provider is the default for each capability. Read operations require Federation.Read or Federation.Manage permission; write operations require Federation.Manage permission.

## List default providers

 - [GET /api/v1/admin/fasp/defaults](https://docs.wellesley.social/openapi/admin-fasp/paths/~1api~1v1~1admin~1fasp~1defaults/get.md): Retrieves all default providers configured for each capability.

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

## Set default provider for capability

 - [PUT /api/v1/admin/fasp/defaults/{capability}](https://docs.wellesley.social/openapi/admin-fasp/paths/~1api~1v1~1admin~1fasp~1defaults~1%7Bcapability%7D/put.md): Sets the default FASP provider for a capability. The provider must be in ACCEPTED state and must support the specified capability. The change is audit-logged. Requires Federation.Manage permission.

RBAC: requires Federation.Manage

## Remove default provider for capability

 - [DELETE /api/v1/admin/fasp/defaults/{capability}](https://docs.wellesley.social/openapi/admin-fasp/paths/~1api~1v1~1admin~1fasp~1defaults~1%7Bcapability%7D/delete.md): Removes the default FASP provider assignment for a capability. After removal, no default provider will be used for this capability until a new one is set. The change is audit-logged. Requires Federation.Manage permission.

RBAC: requires Federation.Manage

## Get default provider for capability

 - [GET /api/v1/admin/fasp/defaults/{capability}](https://docs.wellesley.social/openapi/admin-fasp/paths/~1api~1v1~1admin~1fasp~1defaults~1%7Bcapability%7D/get.md): Retrieves the default provider for a specific capability.

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

## List FASP providers

 - [GET /api/v1/admin/fasp/providers](https://docs.wellesley.social/openapi/admin-fasp/paths/~1api~1v1~1admin~1fasp~1providers/get.md): Retrieves a list of all FASP providers with optional state filtering.

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

## Get FASP provider by ID

 - [GET /api/v1/admin/fasp/providers/{faspId}](https://docs.wellesley.social/openapi/admin-fasp/paths/~1api~1v1~1admin~1fasp~1providers~1%7Bfaspid%7D/get.md): Retrieves detailed information about a specific FASP provider.

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

## Accept FASP provider registration

 - [POST /api/v1/admin/fasp/providers/{faspId}/accept](https://docs.wellesley.social/openapi/admin-fasp/paths/~1api~1v1~1admin~1fasp~1providers~1%7Bfaspid%7D~1accept/post.md): Accepts a pending FASP provider registration, enabling it to provide capabilities to this instance. The state change is audit-logged. Requires Federation.Manage permission.

RBAC: requires Federation.Manage

## Request backfill from FASP provider

 - [POST /api/v1/admin/fasp/providers/{faspId}/backfill](https://docs.wellesley.social/openapi/admin-fasp/paths/~1api~1v1~1admin~1fasp~1providers~1%7Bfaspid%7D~1backfill/post.md): Sends a backfill request to the specified FASP provider for the given content category. The remote provider will then deliver historical data back to this server. Requires Federation.Manage permission.

RBAC: requires Federation.Manage

## Block FASP provider (stealth)

 - [POST /api/v1/admin/fasp/providers/{faspId}/block](https://docs.wellesley.social/openapi/admin-fasp/paths/~1api~1v1~1admin~1fasp~1providers~1%7Bfaspid%7D~1block/post.md): Blocks a FASP provider and removes it from default capability assignments. Future registration attempts from this provider will be silently ignored. The state change is audit-logged. Requires Federation.Manage permission.

RBAC: requires Federation.Manage

## Update FASP provider capabilities

 - [POST /api/v1/admin/fasp/providers/{faspId}/capabilities](https://docs.wellesley.social/openapi/admin-fasp/paths/~1api~1v1~1admin~1fasp~1providers~1%7Bfaspid%7D~1capabilities/post.md): Updates the capabilities of a FASP provider. Activates newly enabled capabilities on the remote provider and merges new capabilities with existing ones. Requires Federation.Manage permission.

RBAC: requires Federation.Manage

## Decline FASP provider registration

 - [POST /api/v1/admin/fasp/providers/{faspId}/decline](https://docs.wellesley.social/openapi/admin-fasp/paths/~1api~1v1~1admin~1fasp~1providers~1%7Bfaspid%7D~1decline/post.md): Declines a FASP provider registration by permanently deleting the provider and all associated subscriptions, defaults, backfill requests, debug callbacks, and preview-card trends. The deletion is audit-logged. Requires Federation.Manage permission.

RBAC: requires Federation.Manage