Lexicon Garden

com.atproto.sync.listHosts

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

Repository @atproto-lexicons.bsky.social did:plc:6msi3pj7krzih5qxqtryxlzw namespace authority
Details · query
Kindquery
Authoritysync.atproto.com
Indexed
Compare Edit in builder → Fork →
cid bafyreigxo77zttzvqzmhhvttfs7kom5npwjxkapmnmpirjyg7oui5tpwbe

Checks

Valid
  • unlimited-string defs.host.properties.hostnameNo maxLength, maxGraphemes or format limits this string.
  • unlimited-string defs.main.parameters.properties.cursorNo maxLength, maxGraphemes or format limits this string.
  • unlimited-string defs.main.output.schema.properties.cursorNo maxLength, maxGraphemes or format limits this string.
JSONDownload
{
  "$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
}