com.atproto.sync.listHosts

atproto-lexicons.bsky.social

{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "host": {
      "properties": {
        "accountCount": {
          "type": "integer"
        },
        "hostname": {
          "description": "hostname of server; not a URL (no scheme)",
          "type": "string"
        },
        "seq": {
          "description": "Recent repo stream event sequence number. May be delayed from actual stream processing (eg, persisted cursor not in-memory cursor).",
          "type": "integer"
        },
        "status": {
          "ref": "com.atproto.sync.defs#hostStatus",
          "type": "ref"
        }
      },
      "required": [
        "hostname"
      ],
      "type": "object"
    },
    "main": {
      "description": "Enumerates upstream hosts (eg, PDS or relay instances) that this service consumes from. Implemented by relays.",
      "output": {
        "encoding": "application/json",
        "schema": {
          "properties": {
            "cursor": {
              "type": "string"
            },
            "hosts": {
              "description": "Sort order is not formally specified. Recommended order is by time host was first seen by the server, with oldest first.",
              "items": {
                "ref": "#host",
                "type": "ref"
              },
              "type": "array"
            }
          },
          "required": [
            "hosts"
          ],
          "type": "object"
        }
      },
      "parameters": {
        "properties": {
          "cursor": {
            "type": "string"
          },
          "limit": {
            "default": 200,
            "maximum": 1000,
            "minimum": 1,
            "type": "integer"
          }
        },
        "type": "params"
      },
      "type": "query"
    }
  },
  "id": "com.atproto.sync.listHosts",
  "lexicon": 1
}

Validate Record

Validate a record against com.atproto.sync.listHosts

Validation Options
Automatically resolve and include external schemas for full validation
Treat any remaining unresolved references as valid

Metadata

DID
did:plc:6msi3pj7krzih5qxqtryxlzw
CID
bafyreigxo77zttzvqzmhhvttfs7kom5npwjxkapmnmpirjyg7oui5tpwbe
Indexed At
2026-02-18 19:04 UTC
AT-URI
at://did:plc:6msi3pj7krzih5qxqtryxlzw/com.atproto.lexicon.schema/com.atproto.sync.listHosts

Referenced Schemas (1)

Similar Lexicons

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.

Lexicon Garden

@