pub.chive.admin.listPDSes

chive.pub

Documentation

List known PDSes and their statistics

main query

List known PDSes and their statistics

Parameters

limit integer Optional

Maximum number of results

Output

Encodingapplication/json

Errors

AuthenticationRequired
AdminRequired
Try It

Requests are sent directly from your browser. Some servers may block requests due to CORS.

Base URL for XRPC calls (e.g., https://api.bsky.social)
Parameters
Maximum number of results
View raw schema
{
  "type": "query",
  "errors": [
    {
      "name": "AuthenticationRequired"
    },
    {
      "name": "AdminRequired"
    }
  ],
  "output": {
    "schema": {
      "type": "object",
      "properties": {
        "stats": {
          "ref": "#pdsStats",
          "type": "ref",
          "description": "PDS statistics"
        }
      }
    },
    "encoding": "application/json"
  },
  "parameters": {
    "type": "params",
    "properties": {
      "limit": {
        "type": "integer",
        "default": 50,
        "maximum": 100,
        "minimum": 1,
        "description": "Maximum number of results"
      }
    }
  },
  "description": "List known PDSes and their statistics"
}
pdsInfo object

Information about a single PDS

Properties

consecutiveErrors integer Optional

Consecutive error count

errorCount integer Optional

Total errors encountered

lastScan string datetime Optional

Last scan timestamp

recordCount integer Optional

Number of indexed records

status string Required

Health status

Known values: healthy, unhealthy, unknown
url string Required

PDS URL

View raw schema
{
  "type": "object",
  "required": [
    "url",
    "status"
  ],
  "properties": {
    "url": {
      "type": "string",
      "description": "PDS URL"
    },
    "status": {
      "type": "string",
      "description": "Health status",
      "knownValues": [
        "healthy",
        "unhealthy",
        "unknown"
      ]
    },
    "lastScan": {
      "type": "string",
      "format": "datetime",
      "description": "Last scan timestamp"
    },
    "errorCount": {
      "type": "integer",
      "description": "Total errors encountered"
    },
    "recordCount": {
      "type": "integer",
      "description": "Number of indexed records"
    },
    "consecutiveErrors": {
      "type": "integer",
      "description": "Consecutive error count"
    }
  },
  "description": "Information about a single PDS"
}
pdsStats object

PDS registry statistics

Properties

healthy integer Optional

Number of healthy PDSes

items array of ref#pdsInfo Required

Individual PDS entries

total integer Required

Total known PDSes

unhealthy integer Optional

Number of unhealthy PDSes

withRecords integer Optional

PDSes with indexed records

View raw schema
{
  "type": "object",
  "required": [
    "total",
    "items"
  ],
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "ref": "#pdsInfo",
        "type": "ref"
      },
      "description": "Individual PDS entries"
    },
    "total": {
      "type": "integer",
      "description": "Total known PDSes"
    },
    "healthy": {
      "type": "integer",
      "description": "Number of healthy PDSes"
    },
    "unhealthy": {
      "type": "integer",
      "description": "Number of unhealthy PDSes"
    },
    "withRecords": {
      "type": "integer",
      "description": "PDSes with indexed records"
    }
  },
  "description": "PDS registry statistics"
}

Lexicon Garden

@