Force a sweep of all connected peers for fresh suggestions

POST

/admin/federation/suggestions/refresh

• Local development behind nginx (port 8088 by default)

Iterates every connected+enabled peer, fetches their /federation/peers/visible response, and persists the results. Returns per-source feedback (count or error).

Authorizations

• cookieAuth
• bearerAuth

Responses

200

Per-source refresh outcomes.

object

outcomes

required

Array<object>

object

source_peer_id

required

string format: uuid

source_display_name

required

string

source_url

required

string

count

required

integer

error

string

401

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"
}

403

Authenticated but missing required capabilities

object

error

required

Human-readable error summary

string

Example

the request could not be completed