Delete a category

DELETE https://api.tamio.com/v2/categories/{uuid}

Deletes a category and all its descendants (children, grandchildren, etc.). Associated product links and jobs are cleaned up automatically.

Deletion will fail if the category or any of its descendants are associated with a site. Remove site associations first before deleting.

Path Parameters

uuid string*

UUID of the category to delete.

Responses

200 Category deleted successfully

Category deleted successfully

status integer

id string

UUID of the deleted category.

400 | Code | Description |

Code	Description
`1002`	Category not found
`10299`	Category is associated with one or more sites
`10353`	Category descendants are associated with sites

status integer

error string

error_code integer

401 Unauthorized – invalid or missing Bearer token

Update a category

Attach products to a category

/categories/{uuid}

1 const response = await fetch("https://api.tamio.com/v2/categories/{uuid}", {
2   method: "DELETE",
3   headers: {
4     "Authorization": "Bearer YOUR_API_KEY",
5     "Accept": "application/json"
6   }
7 });
8 const data = await response.json();

1 require "uri"
2 require "net/http"
3 
4 url = URI("https://api.tamio.com/v2/categories/{uuid}")
5 
6 https = Net::HTTP.new(url.host, url.port)
7 https.use_ssl = true
8 
9 request = Net::HTTP::Delete.new(url)
10 request["Accept"] = "application/json"
11 request["Authorization"] = "Bearer YOUR_API_KEY"
12 
13 response = https.request(request)
14 puts response.read_body

Responses

{
  "status": 200,
  "id": "c3d4e5f6-a1b2-7890-cdef-1234567890ab"
}

1	const response = await fetch("https://api.tamio.com/v2/categories/{uuid}", {
2	method: "DELETE",
3	headers: {
4	"Authorization": "Bearer YOUR_API_KEY",
5	"Accept": "application/json"
6	}
7	});
8	const data = await response.json();

1	require "uri"
2	require "net/http"
3
4	url = URI("https://api.tamio.com/v2/categories/{uuid}")
5
6	https = Net::HTTP.new(url.host, url.port)
7	https.use_ssl = true
8
9	request = Net::HTTP::Delete.new(url)
10	request["Accept"] = "application/json"
11	request["Authorization"] = "Bearer YOUR_API_KEY"
12
13	response = https.request(request)
14	puts response.read_body