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 Validation or business logic error. Returned when:

Validation or business logic error. Returned when:

uuid is missing or not a valid UUID format

Error codes:

Code	Description
1002	Category not found
10299	Category is associated with 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     "Content-Type": "application/json"
6   },
7   body: JSON.stringify({
8     // ... request body
9   })
10 });
11 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	"Content-Type": "application/json"
6	},
7	body: JSON.stringify({
8	// ... request body
9	})
10	});
11	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