social.colibri.beta.community.reorderCategories Documentation (EN)

main procedure

Sets the complete display order of a community's categories.

Input

Encodingapplication/json

categories array Required

The complete new display order of the community's categories.

community stringdid Required

The community whose categories are being reordered.

Output

Encodingapplication/json

Errors

AuthRequired The request is missing, malformed, or unverifiable service auth.

Forbidden The requesting user lacks the category.update permission.

CommunityNotFound No community exists with that DID.

InvalidRequest The supplied categories do not match the community's existing set.

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.

Service Endpoint Base URL for XRPC calls (e.g., https://bsky.social)

Request Body (JSON) Enter valid JSON for the request body

View raw schema

{
  "type": "procedure",
  "input": {
    "schema": {
      "type": "object",
      "required": [
        "community",
        "categories"
      ],
      "properties": {
        "community": {
          "type": "string",
          "format": "did",
          "description": "The community whose categories are being reordered."
        },
        "categories": {
          "type": "array",
          "items": {
            "type": "string",
            "format": "record-key",
            "description": "A category."
          },
          "description": "The complete new display order of the community's categories."
        }
      }
    },
    "encoding": "application/json"
  },
  "errors": [
    {
      "name": "AuthRequired",
      "description": "The request is missing, malformed, or unverifiable service auth."
    },
    {
      "name": "Forbidden",
      "description": "The requesting user lacks the category.update permission."
    },
    {
      "name": "CommunityNotFound",
      "description": "No community exists with that DID."
    },
    {
      "name": "InvalidRequest",
      "description": "The supplied categories do not match the community's existing set."
    },
    {
      "name": "CredentialsUnavailable",
      "description": "The AppView's stored credentials for this community are missing or unusable."
    }
  ],
  "output": {
    "schema": {
      "type": "object",
      "required": [],
      "properties": {}
    },
    "encoding": "application/json"
  },
  "description": "Sets the complete display order of a community's categories."
}