Skip to content

Browse cached entries from one directory

GET
/admin/federation/directories/{id}/entries

Returns the locally cached snapshot of the directory’s listings — survives directory outages per the spec’s local-caching rule.

id
required
string format: uuid
limit
integer
default: 200 >= 1 <= 500

Cached entries.

object
items
required
Array<object>
object
id
required
string format: uuid
directory_id
required
string format: uuid
instance_url
required
string
display_name
required
string
instance_public_key
required
string
fingerprint
required
string
region
string
description
string
tags
Array<string>
verified_at
required
string format: date-time
verified_via
required
string
listing_id
string
cached_at
required
string format: date-time

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

Resource not found

object
error
required

Human-readable error summary

string
Example
the request could not be completed