social.colibri.beta.community.transferOwnership

colibri.social

Documentation

Hands the community's protected owner role from the caller to another member. The subject gains every protected role the caller holds, then the caller loses them. The caller keeps their other roles.

main procedure

Hands the community's protected owner role from the caller to another member. The subject gains every protected role the caller holds, then the caller loses them. The caller keeps their other roles.

Input

Encodingapplication/json
community stringdid Required

The community whose ownership is transferred.

subject stringdid Required

The member who becomes the owner.

Output

Encodingapplication/json

Errors

AuthRequired The request is missing, malformed, or unverifiable service auth.
Forbidden The caller does not hold a protected owner role in this community.
CommunityNotFound No community exists with that DID.
MemberNotFound The subject does not hold a member record in this community.
Banned The subject is banned from this community.
AlreadyOwner The subject already holds a protected owner role.
CredentialsUnavailable The AppView's stored credentials for this community are missing or unusable.
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": "Hands the community's protected owner role from the caller to another member. The subject gains every protected role the caller holds, then the caller loses them. The caller keeps their other roles.",
  "errors": [
    {
      "description": "The request is missing, malformed, or unverifiable service auth.",
      "name": "AuthRequired"
    },
    {
      "description": "The caller does not hold a protected owner role in this community.",
      "name": "Forbidden"
    },
    {
      "description": "No community exists with that DID.",
      "name": "CommunityNotFound"
    },
    {
      "description": "The subject does not hold a member record in this community.",
      "name": "MemberNotFound"
    },
    {
      "description": "The subject is banned from this community.",
      "name": "Banned"
    },
    {
      "description": "The subject already holds a protected owner role.",
      "name": "AlreadyOwner"
    },
    {
      "description": "The AppView's stored credentials for this community are missing or unusable.",
      "name": "CredentialsUnavailable"
    }
  ],
  "input": {
    "encoding": "application/json",
    "schema": {
      "properties": {
        "community": {
          "description": "The community whose ownership is transferred.",
          "format": "did",
          "type": "string"
        },
        "subject": {
          "description": "The member who becomes the owner.",
          "format": "did",
          "type": "string"
        }
      },
      "required": [
        "community",
        "subject"
      ],
      "type": "object"
    }
  },
  "output": {
    "encoding": "application/json",
    "schema": {
      "properties": {
        "owner": {
          "description": "The new owner, with their updated roles.",
          "ref": "social.colibri.beta.community.defs#memberView",
          "type": "ref"
        },
        "previousOwner": {
          "description": "The caller, with their updated roles.",
          "ref": "social.colibri.beta.community.defs#memberView",
          "type": "ref"
        }
      },
      "required": [
        "owner",
        "previousOwner"
      ],
      "type": "object"
    }
  },
  "type": "procedure"
}

Lexicon Garden

@