# FASP

Administration endpoints for managing FASP (Fediverse Auxiliary Service Provider) registrations and capabilities. Handles the FASP registration workflow: providers register via POST, admins confirm registration, and capabilities are activated or deactivated. Also provides debug and backfill request tools. The registration endpoint is publicly accessible; all other endpoints require the Federation.Manage RBAC permission.

## Clear all FASP providers

 - [POST /api/v1/fasp/clear](https://docs.wellesley.social/openapi/fasp/paths/~1api~1v1~1fasp~1clear/post.md): Truncates all FASP provider data including subscriptions and backfill requests. This is a destructive operation that cannot be undone. Requires Federation.Manage RBAC permission.

RBAC: requires Federation.Manage

## Register a FASP provider

 - [POST /api/v1/fasp/registration](https://docs.wellesley.social/openapi/fasp/paths/~1api~1v1~1fasp~1registration/post.md): Initiates the FASP registration workflow. A FASP provider submits its name, base URL, server ID, and Ed25519 public key. The server generates a key pair, stores the provider, and returns the FASP ID, server public key, and a registration completion URI for admin confirmation. Blocked base URLs receive a fake success response (stealth block). No authentication required.

RBAC: requires Federation.Manage

## Update FASP provider capabilities

 - [POST /api/v1/fasp/{providerId}/capabilities](https://docs.wellesley.social/openapi/fasp/paths/~1api~1v1~1fasp~1%7Bproviderid%7D~1capabilities/post.md): Updates the capabilities of a registered FASP provider. Merges new capabilities with existing ones and activates newly enabled capabilities on the remote provider by calling their activation endpoint. Requires Federation.Manage RBAC permission.

RBAC: requires Federation.Manage

## Send debug call to FASP provider

 - [POST /api/v1/fasp/{providerId}/debug-call](https://docs.wellesley.social/openapi/fasp/paths/~1api~1v1~1fasp~1%7Bproviderid%7D~1debug-call/post.md): Sends a debug callback request to the specified FASP provider's debug endpoint. Used for testing connectivity and signature verification with the provider. Requires Federation.Manage RBAC permission.

RBAC: requires Federation.Manage

## Request backfill from FASP provider

 - [POST /api/v1/fasp/{providerId}/request_backfill](https://docs.wellesley.social/openapi/fasp/paths/~1api~1v1~1fasp~1%7Bproviderid%7D~1request_backfill/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 RBAC permission.

RBAC: requires Federation.Manage