POST:categories.json

Description

Modify one category.

At the moment modification is limited to single category at a time due to implementation complexity. E.g. it's possible to re-parent categories, doing a transactional re-parenting of multiple categories is complicated and error prone.

Permission bit: "categories.modify"

Topic: Categories

Query Parameters

ids: Comma-separated array of String, required

List of category ids. See also: Unique Identifiers

Example: ?ids=ca_EQzGqWoY,ca_EQzGqWoY

shop_id: String, required

Unique shop identifier. See also: Unique Identifiers

Example: ?shop_id=sh_EQzGqWoY

Request Body

Array of CategoryModify

Copy
[
  {
    "custom_fields": [
      {
        "name": "",
        "value": ""
      }
    ],
    "featured": false,
    "handle": "ipods",
    "image_file_ids": [
      ""
    ],
    "meta_description": "",
    "meta_title": "",
    "parent_id": "ca_EQzGqWoY",
    "published": false,
    "published_at": "2014-09-04T12:23:34Z",
    "raw_content": "{}",
    "sort_order": "created_at_asc",
    "title": "IPods"
  }
]

Response Body

Array of Category

Response Body Type

Loading module