pub.chive.governance.listDelegations

chive.pub View official

Documentation

List active PDS delegations. Only accessible by administrators.

main query

List active PDS delegations. Only accessible by administrators.

Parameters

cursor string Optional

Pagination cursor for next page

limit integer Optional

Maximum number of results to return

Output

Encodingapplication/json
cursor string Optional

Cursor for next page

delegations array Required

List of delegations

total integer Required

Total number of delegations

Errors

AuthenticationRequired
Unauthorized
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
Pagination cursor for next page
Maximum number of results to return
View raw schema 
{
  "description": "List active PDS delegations. Only accessible by administrators.",
  "errors": [
    {
      "name": "AuthenticationRequired"
    },
    {
      "name": "Unauthorized"
    }
  ],
  "output": {
    "encoding": "application/json",
    "schema": {
      "properties": {
        "cursor": {
          "description": "Cursor for next page",
          "type": "string"
        },
        "delegations": {
          "description": "List of delegations",
          "items": {
            "ref": "#delegation",
            "type": "ref"
          },
          "type": "array"
        },
        "total": {
          "description": "Total number of delegations",
          "type": "integer"
        }
      },
      "required": [
        "delegations",
        "total"
      ],
      "type": "object"
    }
  },
  "parameters": {
    "properties": {
      "cursor": {
        "description": "Pagination cursor for next page",
        "type": "string"
      },
      "limit": {
        "default": 20,
        "description": "Maximum number of results to return",
        "maximum": 100,
        "minimum": 1,
        "type": "integer"
      }
    },
    "type": "params"
  },
  "type": "query"
}
delegation object

PDS delegation record

Properties

active boolean Required

Whether the delegation is currently active

collections array of string Required

NSID collections the delegation covers

delegateDid string did Required

DID of the delegate

displayName string Optional

Delegate display name

expiresAt integer Required

Expiration timestamp

grantedAt integer Required

Timestamp when delegation was granted

grantedBy string did Required

DID of admin who granted the delegation

handle string Optional

Delegate handle

id string Required

Delegation identifier

maxRecordsPerDay integer Required

Maximum records delegate can create per day

minimum: 0
recordsCreatedToday integer Required

Records created today under this delegation

minimum: 0
View raw schema 
{
  "description": "PDS delegation record",
  "properties": {
    "active": {
      "description": "Whether the delegation is currently active",
      "type": "boolean"
    },
    "collections": {
      "description": "NSID collections the delegation covers",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "delegateDid": {
      "description": "DID of the delegate",
      "format": "did",
      "type": "string"
    },
    "displayName": {
      "description": "Delegate display name",
      "type": "string"
    },
    "expiresAt": {
      "description": "Expiration timestamp",
      "type": "integer"
    },
    "grantedAt": {
      "description": "Timestamp when delegation was granted",
      "type": "integer"
    },
    "grantedBy": {
      "description": "DID of admin who granted the delegation",
      "format": "did",
      "type": "string"
    },
    "handle": {
      "description": "Delegate handle",
      "type": "string"
    },
    "id": {
      "description": "Delegation identifier",
      "type": "string"
    },
    "maxRecordsPerDay": {
      "description": "Maximum records delegate can create per day",
      "minimum": 0,
      "type": "integer"
    },
    "recordsCreatedToday": {
      "description": "Records created today under this delegation",
      "minimum": 0,
      "type": "integer"
    }
  },
  "required": [
    "id",
    "delegateDid",
    "collections",
    "expiresAt",
    "maxRecordsPerDay",
    "recordsCreatedToday",
    "grantedAt",
    "grantedBy",
    "active"
  ],
  "type": "object"
}

Lexicon Garden

@