List a directory's cached entries
GET /admin/federation/directories/{id}/entries
Lists the instances in this directory’s listing as of its last successful poll. They come from your instance’s own copy, so the list still works while the directory is down.
Entries the directory verified most recently come first. You get up
to limit entries, 200 by default, with no paging.
Two things can make the list shorter than you expect. Your instance
fetches only the first page of a directory’s listing, so a large
directory can show fewer instances here than it lists. And the list
is cached in memory: after a request with a smaller limit, a
larger one can return the shorter list until the next successful
poll.
Browsing doesn’t contact or pair with anyone. To pair with an
instance you find here, start a handshake with POST /admin/federation/peers/initiate.
Needs the federation.read or system.admin capability.
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ”Query Parameters
Section titled “Query Parameters ”Responses
Section titled “ Responses ”Cached entries.
object
One instance from the directory’s listing, as cached at the last successful poll. Apart from id, directory_id and cached_at, the values are the directory’s, unchanged. Your instance checks the directory’s signature on the listing, not each instance.
object
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 completedResource not found
object
Human-readable error summary
Example
the request could not be completed