com.atproto.sync.listHosts

Enumerates upstream hosts (eg, PDS or relay instances) that this service consumes from. Implemented by relays.

Details · query
Kindquery
Authoritysync.atproto.com
Indexed

Query

query · GET

Parameters

query string

cursor

string

limit

integer
  • minimum: 1
  • maximum: 1000
  • default: 200

Output

application/json

cursor

string

hosts

requiredarray

Sort order is not formally specified. Recommended order is by time host was first seen by the server, with oldest first.

itemsref
Reference

#host

object

Properties

hostname

requiredstring

hostname of server; not a URL (no scheme)

seq

integer

Recent repo stream event sequence number. May be delayed from actual stream processing (eg, persisted cursor not in-memory cursor).

Similar lexicons

semantic match

Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.

  • Returns information about a specified upstream host, as consumed by the server. Implemented by relays.

  • Enumerates all the DID, rev, and commit CID for all repos hosted by this service. Does not require auth; implemented by PDS and Relay.