Update Category

Update category name, description, or metadata.

Endpoint

PUT /v1/workspaces/{workspaceId}/category/{categoryId}

Request

curl -X PUT \
  'https://api.sharely.ai/v1/workspaces/{workspaceId}/category/{categoryId}' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'organizationid: your-organization-id' \
  -d '{
    "name": "Updated Name",
    "description": "Updated description",
    "metadata": {
      "color": "green"
    }
  }'

Body Parameters

ParameterTypeRequiredDescription
namestringNoUpdated category name
descriptionstringNoUpdated description
metadataobjectNoUpdated metadata (merged with existing)

Response

{
  "id": "category-uuid",
  "name": "Updated Name",
  "description": "Updated description",
  "updatedAt": "2024-11-14T16:30:00Z"
}

Related Endpoints