pub.chive.governance.grantDelegation

chive.pub

Documentation

Grant PDS delegation to a trusted editor. Only accessible to administrators. Delegation allows the user to write records to the Governance PDS.

main procedure

Grant PDS delegation to a trusted editor. Only accessible to administrators. Delegation allows the user to write records to the Governance PDS.

Input

Encodingapplication/json
collections array Required

NSID collections the delegation covers

minLength: 1 items
daysValid integer Required

Number of days the delegation is valid

minimum: 1maximum: 365
delegateDid stringdid Required

DID of the user to delegate to

maxRecordsPerDay integer Optional

Maximum records delegate can create per day

minimum: 1maximum: 1000

Output

Encodingapplication/json
Schema#delegationResult

Errors

AuthenticationRequired
Unauthorized
InvalidRequest
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://bsky.social)
Enter valid JSON for the request body
View raw schema 
{
  "type": "procedure",
  "input": {
    "schema": {
      "type": "object",
      "required": [
        "delegateDid",
        "collections",
        "daysValid"
      ],
      "properties": {
        "daysValid": {
          "type": "integer",
          "default": 365,
          "maximum": 365,
          "minimum": 1,
          "description": "Number of days the delegation is valid"
        },
        "collections": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "minLength": 1,
          "description": "NSID collections the delegation covers"
        },
        "delegateDid": {
          "type": "string",
          "format": "did",
          "description": "DID of the user to delegate to"
        },
        "maxRecordsPerDay": {
          "type": "integer",
          "default": 100,
          "maximum": 1000,
          "minimum": 1,
          "description": "Maximum records delegate can create per day"
        }
      }
    },
    "encoding": "application/json"
  },
  "errors": [
    {
      "name": "AuthenticationRequired"
    },
    {
      "name": "Unauthorized"
    },
    {
      "name": "InvalidRequest"
    }
  ],
  "output": {
    "schema": {
      "ref": "#delegationResult",
      "type": "ref"
    },
    "encoding": "application/json"
  },
  "description": "Grant PDS delegation to a trusted editor. Only accessible to administrators. Delegation allows the user to write records to the Governance PDS."
}
delegationResult object

Result of delegation operation

Properties

delegationId string Optional

Delegation ID (if created)

message string Required

Human-readable result message

success boolean Required

Whether the operation succeeded

View raw schema 
{
  "type": "object",
  "required": [
    "success",
    "message"
  ],
  "properties": {
    "message": {
      "type": "string",
      "description": "Human-readable result message"
    },
    "success": {
      "type": "boolean",
      "description": "Whether the operation succeeded"
    },
    "delegationId": {
      "type": "string",
      "description": "Delegation ID (if created)"
    }
  },
  "description": "Result of delegation operation"
}

Lexicon Garden

@