app.tempomusic.staff.grantStaffRole

lexicons.tempomusic.fan

Documentation

Add a DID to the moderators allowlist with the given role. Requires the caller to have the `superAdmin` role. Writes a `moderatorGranted` audit row only when a new row is inserted or a revoked row is reactivated. Idempotent: granting a DID that already holds the same active role returns 200 with `granted: false` and no audit row.

main procedure

Add a DID to the moderators allowlist with the given role. Requires the caller to have the `superAdmin` role. Writes a `moderatorGranted` audit row only when a new row is inserted or a revoked row is reactivated. Idempotent: granting a DID that already holds the same active role returns 200 with `granted: false` and no audit row.

Input

Encodingapplication/json
did stringdid Required

A decentralized identifier (DID).

reason string Optional

No description available.

maxLength: 1000 bytes

Output

Encodingapplication/json
auditEntryId integer Optional

Present only when granted=true.

granted boolean Required

True when a new row was inserted or a revoked row was reactivated. False when the DID already held the requested active role (idempotent no-op).

Errors

Forbidden The caller is not a super-admin.
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 
{
  "description": "Add a DID to the moderators allowlist with the given role. Requires the caller to have the `superAdmin` role. Writes a `moderatorGranted` audit row only when a new row is inserted or a revoked row is reactivated. Idempotent: granting a DID that already holds the same active role returns 200 with `granted: false` and no audit row.",
  "errors": [
    {
      "description": "The caller is not a super-admin.",
      "name": "Forbidden"
    }
  ],
  "input": {
    "encoding": "application/json",
    "schema": {
      "properties": {
        "did": {
          "format": "did",
          "type": "string"
        },
        "reason": {
          "maxLength": 1000,
          "type": "string"
        },
        "role": {
          "ref": "app.tempomusic.staff.defs#staffRole",
          "type": "ref"
        }
      },
      "required": [
        "did",
        "role"
      ],
      "type": "object"
    }
  },
  "output": {
    "encoding": "application/json",
    "schema": {
      "properties": {
        "auditEntryId": {
          "description": "Present only when granted=true.",
          "minimum": 1,
          "type": "integer"
        },
        "granted": {
          "description": "True when a new row was inserted or a revoked row was reactivated. False when the DID already held the requested active role (idempotent no-op).",
          "type": "boolean"
        }
      },
      "required": [
        "granted"
      ],
      "type": "object"
    }
  },
  "type": "procedure"
}

Lexicon Garden

@