Update Category

PATCH

api

{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>",
              "value": "<string>"
            }
          ],
          "name": [
            {
              "id": "<string>",
              "locale": "<string>",
              "value": "<string>"
            }
          ]
        },
        "updated_at": "<string>",
        "values": {}
      }
    ],
    "children": "<array>",
    "cover_url": "<string>",
    "created_at": "<string>",
    "google_product_category_id": "<string>",
    "id": "<string>",
    "name": "<string>",
    "parent_id": "<string>",
    "redirects": [
      {
        "id": "<string>",
        "item_id": "<string>",
        "locale": "<string>",
        "new_slug": "<string>",
        "old_slug": "<string>"
      }
    ],
    "slug": "<string>",
    "sort_order": 123,
    "status": "<string>",
    "translations": {
      "name": [
        {
          "id": "<string>",
          "locale": "<string>",
          "value": "<string>"
        }
      ],
      "slug": [
        {
          "id": "<string>",
          "locale": "<string>",
          "value": "<string>"
        }
      ]
    },
    "updated_at": "<string>",
    "uri": "<string>"
  },
  "details": [
    "<string>"
  ],
  "success": true
}

{
  "details": [
    "<string>"
  ],
  "message": "<string>",
  "success": true
}

{
  "details": [
    "<string>"
  ],
  "message": "<string>",
  "success": true
}

{
  "details": [
    "<string>"
  ],
  "message": "<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

cover_id

string

CoverID controls the category's cover image. When omitted, the cover is not changed. When set to a UUID, the image is validated and assigned. When set to null, the cover is removed.

google_product_category_id

string

related google product category in https://www.google.com/basepages/producttype/taxonomy-with-ids.en-US.txt

name

string

parent_id

string

slug

string

sort_order

integer

Required range: x >= 0

status

enum<string>

Available options:

active,

draft,

inactive

translations

object

Show child attributes

Response

The category

data

object

Show child attributes

details

string[]

Additional contextual information about the response. Used to provide supplementary details beyond the main data payload, such as validation warnings or processing notes

success

boolean

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>",
              "value": "<string>"
            }
          ],
          "name": [
            {
              "id": "<string>",
              "locale": "<string>",
              "value": "<string>"
            }
          ]
        },
        "updated_at": "<string>",
        "values": {}
      }
    ],
    "children": "<array>",
    "cover_url": "<string>",
    "created_at": "<string>",
    "google_product_category_id": "<string>",
    "id": "<string>",
    "name": "<string>",
    "parent_id": "<string>",
    "redirects": [
      {
        "id": "<string>",
        "item_id": "<string>",
        "locale": "<string>",
        "new_slug": "<string>",
        "old_slug": "<string>"
      }
    ],
    "slug": "<string>",
    "sort_order": 123,
    "status": "<string>",
    "translations": {
      "name": [
        {
          "id": "<string>",
          "locale": "<string>",
          "value": "<string>"
        }
      ],
      "slug": [
        {
          "id": "<string>",
          "locale": "<string>",
          "value": "<string>"
        }
      ]
    },
    "updated_at": "<string>",
    "uri": "<string>"
  },
  "details": [
    "<string>"
  ],
  "success": true
}

{
  "details": [
    "<string>"
  ],
  "message": "<string>",
  "success": true
}

{
  "details": [
    "<string>"
  ],
  "message": "<string>",
  "success": true
}

{
  "details": [
    "<string>"
  ],
  "message": "<string>",
  "success": true
}

Management API

Shopper API

Customers API

Digital Assets Management API

Path Parameters

Body

Response