Zid Docs
Merchant APIs
Theme Docs
Zid Docs
  • Start Here 🚀
  • Overview to Zid Apps
  • Create your First App
  • Authorization
  • Responses
  • Embedded Apps
  • Webhooks
  • App Scripts
  • Rate Limiting
  • APIs
    • Orders
    • Products
      • Managing Products
      • Digital Vouchers
      • Product Categories
        • Get Single Category DetailsGET
        • Get all categoriesGET
        • Create Store CategoryPOST
        • Update a Store CategoryPOST
        • Add a product to a certain categoryPOST
        • Publish/Unpublish a CategoryPUT
        • Detach Category from All ProductsDELETE
        • Remove Category from ProductDELETE
      • Product Badge
      • Product Attributes
      • Product Attribute Presets
      • Product Customizations
      • Product Manual Sorting
      • Product Images
      • Product Notifications
      • Product Import
      • Product Stock (Multi-Inventory)
      • Product Questions & Answers
      • Product Reviews
      • Digital Products
    • Inventories
    • Shipping
    • Marketing
    • Customers
    • Store Settings
    • Countries and Cities
    • Webhooks
    • App Scripts
  • Webhook Events
logoPowered by Apidog
  1. APIs
  2. Products
  3. Product Categories

Detach Category from All Products

DELETEv1/managers/store/categories/{category_id}/products/delete

Detach a specified category from all products in the store. This essentially
disassociates the category from all products it was linked to, but does not delete the category itself.

Request

Path Params
category_id
string 
required
Example:
540
Header Params
Access-Token
string 
required

An Access Token is a unique string that represents the authorization granted to a client (Partner application) by a user (Merchant or Store Manager) to access their protected resources. It is part of the OAuth 2.0 standard and is used to authenticate API requests on behalf of the user. Access Tokens have a limited lifespan and must be used within their validity period. Once expired, a new Access Token can be obtained using a Refresh Token. Access Tokens should be treated as sensitive information and must be kept secure to prevent unauthorized access to the user's data. If you do not have an Access-Token, but have the older alternative instead, i.e., the X-Manager-Token, then see the instructions here on how to obtain the Access-Token.

Example:
eyJpdiI6Imh3L2dGbmJmRnVCOUY4WW5WQ2s3RFE9PSIsInZhbHVlIjoiZklpRnJyVGV1OWcrZUJBNk44bVp5SjZzSS92V3czcTJjbnJ2dFYvenZ3SFBtWHNSMFU3ZEMzZ0ZJNnpucVE4Ui9rNFdicUduOGpKUlg1VXdGOFFIaVUzZjZyUUZybWx3R0tNY3orUmxoUUUxQ29wSkEyVDZTVnVYb2dlUXJSVzBYVkdESjBpS0xiN05Hbndzc2wzV2N0YitGM1NEdkk4ckZZOTZsTFdEL1ZQRlJJTE5FQmttZng2elpwL1RCeXFRdUd1U3JTc0FHV1kySS80RFJaWlIyZ3gwM2FsQVRFbkt3VWtFOUQyKzdGOD0iLCJtYWMiOiJmZDQ0YzM4ODE0OWQxOWRhYWU0NDhhYmIzYzQ1MDAxMDAzODZjZGM3ZGM4NGJhMGNkMDEyYWZlM2UzYjAxMTI4IiwidGFnIjoiIn0=
Authorization
string 
required

The Authorization token is a unique key given to the third-party application (Partner) by Zid. It is used to authenticate the API requests made by the Partner application. The token verifies the partner's identity and ensures they have permission to access Zid's API but does not provide any specific user or store information. It should be included in the header of API requests when the partner application needs to access Zid's API.

Example:
Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiIxMTciLCJqdGkiOiJhMTg5ZTg3MmYxMzhkMWVhYjU5MjVkMDkyMGE5NmI0YjliNjg0Y2E2ZTdmM2M2MjljZWYxNmQ4NDJjMmJlYmVhMjI4YTdmMTA0ZWQ4NWE5NCIsImlhdCI6MTY3OTU3Njk5OS41NjY4NzcsIm5iZiI6MTY3OTU3Njk5OS41NjY4OCwiZXhwIjoxNzExMTk5Mzk5LjQ4NjE1Mywic3ViIjoiMTgyNDc1Iiwic2NvcGVzIjpbInRoaXJkLXBhcnRpZXMtYXBpcyJdfQ.i07ef09nVNXGZF-g-QXpNoS2vlFQK_zntAqAMS4Az2XD2EyMLhxLZZRL-QlR11zUPqMmXjMAl_4ooKa3M3zkfZQ6Ga6qStvamk8RnC_39VUx0lfN2A4k65ERZpqwrMy6-t3dE99zay3aicIdNvbgi0zeuMSE5Tn99u-2AtSRa8ffbfAcYPPXacHrhdmlYzdiZS_x_skovFEow1E-nDjdL1WHqO92XdZ7RfNLkiYFTjZlZmM_UruvioaR3q6TXJbqRK_ZrziivezL8ohIQ2SBosUp58I29rlKzvlw_R2j0rKKYZbdxYDaxAHOISmOFKAlO66k7dNevAHI3s4uGIjoGA6ZXHknccWPLLLiaAQ0r64HV8GowW5dg2rhZNurJGDTnLlBQ6F-ql42ptHzSAfzzi576CEoN3gMVpgXcbntUY3reETkFsTBPUjeSuMpANMioXAA0GRp3Ut-84fTnrWxqsCW1WVUIx33HvmfCGPXIdkaCCWoA6G6KXo04MtFbKXQmXkK9esQWI-rqdVnMD3zSR3g3yFHZSL1U-mZeNja03706Rav1ordsRNOtRwtLuoRRbk9KasbUpEwqq4Ao9lqZZwRIjdEw-pQtnUT8V53fhmuuRIefCLFO7eGEtGUnh9o6Uh_pgi6AB6uSlnN9GEMGgI1alqvMmTjxvC-HHt0V-Y
Store-Id
number 
required
Example:
37213
Role
enum<string> 
required

Role of the user.

Allowed value:
Manager
Example:
Manager
X-Manager-Token
string 
required

This token is used to authenticate and access information related to the store. It is obtained through an OAuth mechanism and is required to perform operations on the store's data. The X-Manager-Token should be included in the header of API requests that require store-related information.

Example:
eyJpdiI6Imh3L2dGbmJmRnVCOUY4WW5WQ2s3RFE9PSIsInZhbHVlIjoiZklpRnJyVGV1OWcrZUJBNk44bVp5SjZzSS92V3czcTJjbnJ2dFYvenZ3SFBtWHNSMFU3ZEMzZ0ZJNnpucVE4Ui9rNFdicUduOGpKUlg1VXdGOFFIaVUzZjZyUUZybWx3R0tNY3orUmxoUUUxQ29wSkEyVDZTVnVYb2dlUXJSVzBYVkdESjBpS0xiN05Hbndzc2wzV2N0YitGM1NEdkk4ckZZOTZsTFdEL1ZQRlJJTE5FQmttZng2elpwL1RCeXFRdUd1U3JTc0FHV1kySS80RFJaWlIyZ3gwM2FsQVRFbkt3VWtFOUQyKzdGOD0iLCJtYWMiOiJmZDQ0YzM4ODE0OWQxOWRhYWU0NDhhYmIzYzQ1MDAxMDAzODZjZGM3ZGM4NGJhMGNkMDEyYWZlM2UzYjAxMTI4IiwidGFnIjoiIn0=

Request samples

Responses

The operation was successful. The category has been removed from all products.(200)
The operation was successful. The category has been removed from all products.
HTTP Code: 200
Content Type : JSONapplication/json
Data Schema
status
string 
optional
Example:
object
category
object (ProductCategory) 
optional
id
integer 
optional

Unique identifier for the category

Example:
875210
name
string 
optional

Name of the category

Example:
Sport Shoes
slug
string 
optional

URL-friendly version of the category name

Example:
sport-shoes
SEO_category_title
string 
optional

SEO optimized title for the category

Example:
Sport Shoes - Run with Comfort
SEO_category_description
string 
optional

SEO optimized description for the category

Example:
Our selection of sport shoes offers the best in comfort and performance for your athletic needs.
names
object 
optional

Category names in different languages

description
object 
optional

Category descriptions in different languages

url
string 
optional

URL of the category on the web store

Example:
https://example.zid.store/categories/875210/sport-shoes
image
string 
optional

URL of the category's image (thumbnail size)

Example:
https://media.zid.store/example-store/75decdde-4e94-45fe-8eb1-1edf4ead3ff0-260x260.png
image_full_size
string 
optional

URL of the category's image (full size)

Example:
https://media.zid.store/example-store/75decdde-4e94-45fe-8eb1-1edf4ead3ff0.png
img_alt_text
string 
optional

Alternative text for the image for accessibility and SEO

Example:
Sport shoes collection
cover_image
string 
optional

URL of the category's cover image

Example:
https://media.zid.store/example-store/94b62e84-4ee3-4bfb-9833-6de53e2b8e1a.png
image_full
string 
optional

Full sized category image

Example:
https://media.zid.store/example-store/75decdde-4e94-45fe-8eb1-1edf4ead3ff0.png
products_count
integer 
optional

Number of products under the category

Example:
120
sub_categories
array[object (ProductCategory) {18}] 
optional

List of sub-categories under this category. Empty if no sub-categories exist.

parent_id
integer  | null 
optional

ID of the parent category. Null if this is a top-level category.

Example:
null
flat_name
string 
optional

Flat representation of the category name

Example:
Sport Shoes
is_published
boolean 
optional

Flag indicating if the category is currently published and visible on the store

Example:
true
message
object 
optional
type
string 
optional
Example:
object
code
string  | null 
optional
Example:
null
name
string  | null 
optional
Example:
null
description
string  | null 
optional
Example:
null
Example
Not configured
Last modified: 2 months ago