---
updatedAt: 2026-09-04T07:34:08.000Z
agentTools:
  projectIndex: https://developers.cloudbeds.com/llms.txt
---

# Rename or restyle a category

# OpenAPI definition

```json
{
  "openapi": "3.0.3",
  "info": {
    "title": "Attribute Tagging Service API",
    "description": "API for managing attribute tagging functionality in Cloudbeds.\n\nPublic API base path: `/attribute-tagging/v1`\n\n## Base URL\n\nUse `https://api.cloudbeds.com/attribute-tagging/v1` for every property and organization. Cloudbeds hosts each property in one region (island), `us1` or `us2`, and the gateway sends each request to the region that hosts the property or organization it names, so one base URL works for all of them.\n\nThe regional base URLs keep working and route the same way:\n\n- `https://api.us1.cloudbeds.com/attribute-tagging/v1` (us1)\n- `https://api.us2.cloudbeds.com/attribute-tagging/v1` (us2)\n\nSend one region per request: when `x-property-id` lists properties from both regions, a property hosted in another region than the one serving the request is rejected with `421 WRONG_REGION`, and the error message names the base URL to use for it.\n\nBoth regions accept partner API keys (`cbat_…`) and Okta JWTs as `Authorization: Bearer <token>`.\n\nDownload OpenAPI specification: [JSON](https://api.cloudbeds.com/attribute-tagging/v1/docs/json) | [YAML](https://api.cloudbeds.com/attribute-tagging/v1/docs/yaml)",
    "version": "v1"
  },
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "JWT",
        "description": "Enter your JWT token (without the word \"Bearer\")"
      }
    }
  },
  "paths": {
    "/attribute-tagging/v1/categories/{id}": {
      "patch": {
        "summary": "Rename or restyle a category",
        "tags": [
          "Categories"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "label": {
                    "nullable": true,
                    "type": "string",
                    "minLength": 1
                  },
                  "description": {
                    "nullable": true,
                    "type": "string"
                  },
                  "icon": {
                    "nullable": true,
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 64
                  },
                  "color": {
                    "nullable": true,
                    "type": "string",
                    "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$"
                  }
                },
                "additionalProperties": false
              }
            }
          }
        },
        "parameters": [
          {
            "schema": {
              "type": "string",
              "pattern": "^\\d+$"
            },
            "in": "path",
            "name": "id",
            "required": true
          },
          {
            "schema": {
              "type": "string",
              "pattern": "^\\d+$"
            },
            "in": "header",
            "name": "x-organization-id",
            "required": true,
            "description": "Organization ID"
          }
        ],
        "responses": {
          "200": {
            "description": "Default Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "pattern": "^\\d+$"
                    },
                    "organizationId": {
                      "type": "string",
                      "pattern": "^\\d+$"
                    },
                    "key": {
                      "nullable": true,
                      "type": "string"
                    },
                    "label": {
                      "nullable": true,
                      "type": "string",
                      "minLength": 1
                    },
                    "description": {
                      "nullable": true,
                      "type": "string"
                    },
                    "icon": {
                      "nullable": true,
                      "type": "string"
                    },
                    "color": {
                      "nullable": true,
                      "type": "string"
                    },
                    "position": {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    "isSystem": {
                      "type": "boolean"
                    },
                    "archivedAt": {
                      "nullable": true,
                      "type": "string",
                      "format": "date-time",
                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
                    }
                  },
                  "required": [
                    "id",
                    "organizationId",
                    "key",
                    "label",
                    "description",
                    "icon",
                    "color",
                    "position",
                    "isSystem",
                    "archivedAt"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "400": {
            "description": "Default Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "string"
                    },
                    "message": {
                      "type": "string"
                    },
                    "errors": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "field": {
                            "type": "string"
                          },
                          "message": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "field",
                          "message"
                        ],
                        "additionalProperties": false
                      }
                    }
                  },
                  "required": [
                    "code",
                    "message"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "404": {
            "description": "Default Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "string"
                    },
                    "message": {
                      "type": "string"
                    },
                    "errors": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "field": {
                            "type": "string"
                          },
                          "message": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "field",
                          "message"
                        ],
                        "additionalProperties": false
                      }
                    }
                  },
                  "required": [
                    "code",
                    "message"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "409": {
            "description": "Default Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "string"
                    },
                    "message": {
                      "type": "string"
                    },
                    "errors": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "field": {
                            "type": "string"
                          },
                          "message": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "field",
                          "message"
                        ],
                        "additionalProperties": false
                      }
                    }
                  },
                  "required": [
                    "code",
                    "message"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "421": {
            "description": "The property or organization in the headers is hosted in another region; the message names the base URL to use.",
            "content": {
              "application/json": {
                "schema": {
                  "description": "The property or organization in the headers is hosted in another region; the message names the base URL to use.",
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "string"
                    },
                    "message": {
                      "type": "string"
                    },
                    "errors": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "field": {
                            "type": "string"
                          },
                          "message": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "field",
                          "message"
                        ],
                        "additionalProperties": false
                      }
                    }
                  },
                  "required": [
                    "code",
                    "message"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "503": {
            "description": "Default Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "string"
                    },
                    "message": {
                      "type": "string"
                    },
                    "errors": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "field": {
                            "type": "string"
                          },
                          "message": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "field",
                          "message"
                        ],
                        "additionalProperties": false
                      }
                    }
                  },
                  "required": [
                    "code",
                    "message"
                  ],
                  "additionalProperties": false
                }
              }
            }
          }
        }
      }
    }
  },
  "servers": [
    {
      "url": "https://api.cloudbeds.com"
    }
  ],
  "security": [
    {
      "bearerAuth": []
    }
  ]
}
```