List cached peer-of-peer suggestions

GET

/admin/federation/suggestions

• Local development behind nginx (port 8088 by default)

Returns suggestions from all sources, deduped against our own federation_peers (URLs we already federate with are hidden). Each suggestion carries provenance — which of OUR peers contributed it.

Authorizations

• cookieAuth
• bearerAuth

Parameters

Query Parameters

limit

integer

default: 200 >= 1 <= 500

Responses

200

List of suggestions.

object

items

required

Array<object>

object

id

required

string format: uuid

source_peer_id

required

string format: uuid

source_display_name

required

string

source_url

required

string

suggested_url

required

string

suggested_display_name

required

string

suggested_public_key

required

string

suggested_fingerprint

required

string

cached_at

required

string format: date-time

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