Update Category

PUT

https://api.zid.sa/v1/managers/store/categories/{category}/update

Updates a specific product category, including its localized name, description, SEO metadata, image alt text, URL slug, and parent category.

🔑Scopes

third_categories_write - third_categories_write

Request

Path Params

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200Success

application/json

Bodyapplication/json

🟠401Unauthorized

🔴500Internal Server error

🟠403Forbidden

🟠400Bad Request

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PUT 'https://api.zid.sa/v1/managers/store/categories/123/update' \
--header 'Authorization: {{Autherization}}' \
--header 'Store-ID: {{StoreId}}' \
--header 'Content-Type: application/json' \
--data '{
    "name": {
        "ar": "الإلكترونيات",
        "en": "Electronics"
    },
    "description": {
        "ar": "منتجات وأجهزة إلكترونية.",
        "en": "Electronic products and devices."
    },
    "imgAltText": {
        "ar": "صورة قسم الإلكترونيات",
        "en": "Electronics category image"
    },
    "categoryURL": "electronics",
    "categoryTitle": {
        "ar": "الإلكترونيات",
        "en": "Electronics"
    },
    "categoryDescription": {
        "ar": "تسوق أفضل المنتجات الإلكترونية.",
        "en": "Shop the best electronic products."
    },
    "parent_id": 10
}'

Response Example

200 - Example 1

{
    "category": {
        "id": 1,
        "name": {
            "ar": "الإلكترونيات",
            "en": "Electronics"
        },
        "slug": "electronics",
        "description": {},
        "image": {
            "path": "https://cdn.zid.sa/category.jpg",
            "thumbnail": "https://cdn.zid.sa/category-thumbnail.jpg"
        },
        "parent_id": null,
        "children": [],
        "products_count": 0
    }
}

Modified at 2026-09-09 08:36:13

Upload Category Image

Product Badge