Update a category

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

Updates an existing category. Requires both the category uuid (in the path) and the new config object in the request body.

The config replaces the existing multilingual configuration. All other fields (asset_id, status, icon) are optional and only update when provided.

Path Parameters

uuid string*

UUID of the category to update.

Body Parameters

asset_id string

UUID of the image asset to associate with this category.

status boolean

Whether the category is active and visible.

icon string

Icon data or URL for category display. Set to null to clear.

config object*

Multilingual configuration keyed by language code (e.g. en, de, es). Must contain between 1 and 10 language entries. Language codes must match the languages enabled on your account.

Example

{
  "config": {
    "en": {
      "title": "Updated Electronics"
    }
  }
}

Responses

200 Category updated successfully

Category updated successfully

status integer

category Category

400 Validation or business logic error. Returned when:

Validation or business logic error. Returned when:

Missing required config field
Missing or invalid uuid (path parameter)
Missing required title within a language config
Invalid UUID format for asset_id
Unsupported language code in config keys
Field length violations (e.g. title shorter than 2 or longer than 240 characters)
Invalid slug pattern (spaces, special characters, or system- prefix)
Additional/unknown properties in the request body
Type mismatches (e.g. status sent as string instead of boolean)

Error codes:

Code	Description
1002	Category or asset not found
10156	Category name invalid (empty, missing, or nil title)

status integer

error string

error_code integer

401 Unauthorized – invalid or missing Bearer token

Create a category

Delete a category

/categories/update/{uuid}

1 const response = await fetch("https://api.tamio.com/v2/categories/update/{uuid}", {
2   method: "POST",
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/update/{uuid}")
5 
6 https = Net::HTTP.new(url.host, url.port)
7 https.use_ssl = true
8 
9 request = Net::HTTP::Post.new(url)
10 request["Accept"] = "application/json"
11 request["Authorization"] = "Bearer YOUR_API_KEY"
12 request["Content-Type"] = "application/json"
13 request.body = %Q{
14   // ... request body
15 }
16 
17 response = https.request(request)
18 puts response.read_body

Responses

{
  "status": 200,
  "category": {
    "id": "c3d4e5f6-a1b2-7890-cdef-1234567890ab",
    "parent_id": "string",
    "slug": "electronics",
    "icon": "string",
    "status": true,
    "object": "category",
    "integer_id": 42,
    "name": "Electronics",
    "created_at": 1709500800,
    "asset_id": "string",
    "children": [],
    "config": {},
    "number_of_subcategories": 3,
    "number_of_products": 50,
    "number_of_sites": 2,
    "path": "string",
    "label_path": "string",
    "image": {}
  }
}

1	const response = await fetch("https://api.tamio.com/v2/categories/update/{uuid}", {
2	method: "POST",
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/update/{uuid}")
5
6	https = Net::HTTP.new(url.host, url.port)
7	https.use_ssl = true
8
9	request = Net::HTTP::Post.new(url)
10	request["Accept"] = "application/json"
11	request["Authorization"] = "Bearer YOUR_API_KEY"
12	request["Content-Type"] = "application/json"
13	request.body = %Q{
14	// ... request body
15	}
16
17	response = https.request(request)
18	puts response.read_body