Skip to content

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.

One outcome per peer asked. A 200 doesn’t mean any peer answered.

object
outcomes
required
Array<object>
object
source_peer_id
required
string format: uuid
source_display_name
required
string
source_url
required
string
count
required

Entries saved from this peer: those with both an address and a key.

integer
error

Why this peer’s list couldn’t be fetched or saved. Its earlier suggestions are kept.

string

Authentication required, missing, or invalid

object
error
required

Human-readable error summary

string
Example
the request could not be completed
Example
{
"error": "authentication required: sign in and retry with a valid session or API token"
}

Authenticated but missing required capabilities

object
error
required

Human-readable error summary

string
Example
the request could not be completed