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 | Code | Description |

Code	Description
`1002`	Category or asset not found
`10156`	Category name is invalid (empty or missing 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     "config": {
9       "en": {
10         "title": "Updated Electronics"
11       }
12     }
13   })
14 });
15 const data = await response.json();

1 require "uri"
2 require "net/http"
3 require "json"
4 
5 url = URI("https://api.tamio.com/v2/categories/update/{uuid}")
6 
7 https = Net::HTTP.new(url.host, url.port)
8 https.use_ssl = true
9 
10 request = Net::HTTP::Post.new(url)
11 request["Accept"] = "application/json"
12 request["Authorization"] = "Bearer YOUR_API_KEY"
13 request["Content-Type"] = "application/json"
14 request.body = {
15   config: {
16     en: {
17       title: "Updated Electronics"
18     }
19   }
20 }.to_json
21 
22 response = https.request(request)
23 puts response.read_body

Responses

{
  "status": 200,
  "category": {
    "id": "c3d4e5f6-a1b2-7890-cdef-1234567890ab",
    "parent_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "slug": "electronics",
    "icon": "laptop",
    "status": true,
    "object": "category",
    "name": "Electronics",
    "created_at": 1709500800,
    "asset_id": "f0e1d2c3-b4a5-6789-0abc-def123456789",
    "children": [
      "d4e5f6a1-b2c3-7890-abcd-ef1234567890",
      "e5f6a1b2-c3d4-7890-abcd-ef1234567890"
    ],
    "config": {
      "en": {
        "title": "Electronics",
        "seo_title": "Buy Electronics Online",
        "description": "All electronic products",
        "seo_description": "Shop the best electronics at great prices",
        "slug": "electronics"
      },
      "de": {
        "title": "Elektronik",
        "seo_title": "Elektronik Online Kaufen",
        "description": "Alle elektronischen Produkte",
        "seo_description": "Die besten Elektronikprodukte zu günstigen Preisen",
        "slug": "elektronik"
      }
    },
    "number_of_subcategories": 3,
    "number_of_products": 50,
    "number_of_sites": 2,
    "path": "a1b2c3d4-e5f6-7890-abcd-ef1234567890/c3d4e5f6-a1b2-7890-cdef-1234567890ab",
    "label_path": "Electronics/Laptops",
    "image": {
      "public_url": "https://pub.ox31.com/uploads/12345/category-image.jpg",
      "alt_text": "Electronics category banner",
      "asset_id": "f0e1d2c3-b4a5-6789-0abc-def123456789"
    }
  }
}

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	"config": {
9	"en": {
10	"title": "Updated Electronics"
11	}
12	}
13	})
14	});
15	const data = await response.json();

1	require "uri"
2	require "net/http"
3	require "json"
4
5	url = URI("https://api.tamio.com/v2/categories/update/{uuid}")
6
7	https = Net::HTTP.new(url.host, url.port)
8	https.use_ssl = true
9
10	request = Net::HTTP::Post.new(url)
11	request["Accept"] = "application/json"
12	request["Authorization"] = "Bearer YOUR_API_KEY"
13	request["Content-Type"] = "application/json"
14	request.body = {
15	config: {
16	en: {
17	title: "Updated Electronics"
18	}
19	}
20	}.to_json
21
22	response = https.request(request)
23	puts response.read_body