Refresh suggestions from your peers
POST /admin/federation/suggestions/refresh
Asks each of your connected, enabled peers, one at a time, for the peers it shows publicly, and saves what comes back as suggestions.
For a peer that answers, its old suggestions are replaced by its current list, so instances it no longer lists are dropped; entries without an address or key are skipped. A peer that fails keeps its earlier suggestions. The lists aren’t signed, so they’re saved as received. Each peer gets up to 15 seconds. Nothing else refreshes suggestions: there’s no schedule.
As shipped, this asks each peer for /federation/peers/visible
without the /api/v1 prefix it’s served under, so Artist Alley
peers come back with an error.
You get 200 with one outcome per peer asked, each with a count or
an error. Needs the system.admin capability.
Authorizations
Section titled “Authorizations ”Responses
Section titled “ Responses ”One outcome per peer asked. A 200 doesn’t mean any peer answered.
object
object
Entries saved from this peer: those with both an address and a key.
Why this peer’s list couldn’t be fetched or saved. Its earlier suggestions are kept.
Authentication required, missing, or invalid
object
Human-readable error summary
Example
the request could not be completedExample
{ "error": "authentication required: sign in and retry with a valid session or API token"}Authenticated but missing required capabilities
object
Human-readable error summary
Example
the request could not be completed