Skip to main content
PATCH
/
api
/
v1
/
:team_slug
/
:app_slug
/
categories
/
:category_id
Error
A valid request URL is required to generate request examples
{
  "data": {
    "attributes": [
      {
        "created_at": "<string>",
        "description": "<string>",
        "filterable": true,
        "id": "<string>",
        "key": "<string>",
        "name": "<string>",
        "template_key": "<string>",
        "template_name": "<string>",
        "translatable": true,
        "translations": {
          "description": [
            {
              "id": "<string>",
              "locale": "<string>",
              "omni_channel_translations": [
                {
                  "id": "<string>",
                  "market_id": "<string>",
                  "store_group_id": "<string>",
                  "value": "<string>"
                }
              ],
              "value": "<string>"
            }
          ],
          "name": [
            {
              "id": "<string>",
              "locale": "<string>",
              "omni_channel_translations": [
                {
                  "id": "<string>",
                  "market_id": "<string>",
                  "store_group_id": "<string>",
                  "value": "<string>"
                }
              ],
              "value": "<string>"
            }
          ]
        },
        "updated_at": "<string>",
        "values": {}
      }
    ],
    "children": "<array>",
    "created_at": "<string>",
    "id": "<string>",
    "name": "<string>",
    "parent_id": "<string>",
    "redirects": [
      {
        "id": "<string>",
        "item_id": "<string>",
        "locale": "<string>",
        "new_slug": "<string>",
        "old_slug": "<string>",
        "type": "product"
      }
    ],
    "slug": "<string>",
    "sort_order": 123,
    "status": "<string>",
    "translations": {
      "name": [
        {
          "id": "<string>",
          "locale": "<string>",
          "omni_channel_translations": [
            {
              "id": "<string>",
              "market_id": "<string>",
              "store_group_id": "<string>",
              "value": "<string>"
            }
          ],
          "value": "<string>"
        }
      ],
      "slug": [
        {
          "id": "<string>",
          "locale": "<string>",
          "omni_channel_translations": [
            {
              "id": "<string>",
              "market_id": "<string>",
              "store_group_id": "<string>",
              "value": "<string>"
            }
          ],
          "value": "<string>"
        }
      ]
    },
    "updated_at": "<string>",
    "uri": "<string>"
  },
  "details": [
    "<string>"
  ],
  "success": true
}

Path Parameters

​
app_slug
string
required

App slug

​
team_slug
string
required

Team slug

​
category_id
string
required

Category ID

Body

application/json

Category data

​
childless
boolean
​
name
string
​
parent_id
string

Note: Always send in parent id even if you don't want to update it. Sending in parent_id without value will remove the parent_id

​
slug
string

Example "hello-world"

​
sort_order
integer
Required range: x >= 0
​
status
enum<string>
Available options:
active,
draft,
inactive
​
translations
object

Response

The category

​
data
object
​
details
string[]

Other information which can be relative to the response. This field is used to give additional information then the main data we want to return. For instance if a product do not match the publishing rules will the product status be set to Incomplete and this field will include why

​
success
boolean