Skip to main content

com.atproto.sync.listHosts

#main​

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

Parameters​

PropertyTypeKnown ValuesRequiredDescription
limitinteger-❌-
cursorstring-❌-

Output​

  • Encoding: application/json
PropertyTypeKnown ValuesRequiredDescription
cursorstring-❌-
hostsarray of #host-✅Sort order is not formally specified. Recommended order is by time host was first seen by the server, with oldest first.

#host​

PropertyTypeKnown ValuesRequiredDescription
hostnamestring-✅hostname of server; not a URL (no scheme)
seqinteger-❌Recent repo stream event sequence number. May be delayed from actual stream processing (eg, persisted cursor not in-memory cursor).
accountCountinteger-❌-
statuscom.atproto.sync.defs#hostStatus-❌-