Skip to main content
POST
/
collections
/
actions
/
copy-category
Copy Category to Collections
curl --request POST \
  --url https://api.fabric.inc/v3/collections/actions/copy-category \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "parentCollectionId": "64184766610c0e32a86d8758",
  "categoryId": "917329dfd5288b0011332300"
}
'
{
  "id": "53184766610c0e32a86d875",
  "name": "Color",
  "localizedProperties": {
    "en-US": {
      "name": "Color"
    },
    "en-IN": {
      "name": "Colour"
    }
  },
  "isLocalizable": true,
  "isRoot": true,
  "isLeaf": false,
  "categoryAttributes": [
    {
      "id": "64184766610c0e32a86d8758",
      "name": "color",
      "localizedProperties": {
        "en-US": {
          "name": "Color"
        },
        "en-IN": {
          "name": "Colour"
        }
      },
      "isLocalizable": true,
      "isInherited": true,
      "type": "TEXT",
      "validation": {
        "dateFormat": "MM-DD-YYYY"
      },
      "value": "blue"
    }
  ],
  "productAttributes": [
    {
      "id": "33184766610c0e32a86d8759",
      "name": "Color",
      "localizedProperties": {
        "en-US": {
          "name": "Color"
        },
        "en-IN": {
          "name": "Colour"
        }
      },
      "isLocalizable": true,
      "isInherited": true,
      "type": "TEXT",
      "isMandatory": true
    }
  ],
  "productIds": [
    "64184766610c0e32a86d8758"
  ],
  "children": [
    {
      "id": "33184766610c0e32a86d8759",
      "name": "Color",
      "localizedProperties": {
        "en-US": {
          "name": "Color"
        },
        "en-IN": {
          "name": "Colour"
        }
      },
      "isLocalizable": true,
      "isLeaf": false
    }
  ],
  "updatedBy": "[email protected]",
  "updatedAt": "2023-04-20T10:24:36.162Z",
  "createdAt": "2021-04-20T10:24:36.162Z"
}

Authorizations

​
Authorization
string
header
required

S2S access token (JWT) from fabric Identity service (during Login)

Headers

​
x-fabric-tenant-id
string

A header used by fabric to identify the tenant making the request. You must include tenant id in the authentication header for an API request to access any of fabric’s endpoints. You can retrieve the tenant id , which is also called account id, from Copilot. This header is required.

Example:

"517fa9dfd42d8b00g1o3k312"

​
x-fabric-request-id
string

Unique request ID

Example:

"263e731c-45c8-11ed-b878-0242ac120002"

Body

application/json

Request body for copy

​
parentCollectionId
string
required

24-character system-generated parent category ID

Example:

"64184766610c0e32a86d8758"

​
categoryId
string
required

24-character system-generated category ID

Example:

"917329dfd5288b0011332300"

Response

OK

Category details

​
id
string

24-character system-generated category ID

Example:

"53184766610c0e32a86d875"

​
name
string

Non-localized category name

Example:

"Color"

​
localizedProperties
object

Localized properties of category

Example:
{
  "en-US": { "name": "Color" },
  "en-IN": { "name": "Colour" }
}
​
isLocalizable
boolean

true: Category name is translated into different languages or localized for different regions
false: Category name isn't localized Note: Refer to localizedProperties to get relevant details based on locale

Example:

true

​
isRoot
boolean

true: This is a root category
false: This isn't a root category

Example:

true

​
isLeaf
boolean

true: This is the last category of the branch with no further children categories
false: This isn't the last category of the branch and has children categories

Example:

false

​
categoryAttributes
object[]

Attributes assigned to the specified category

​
productAttributes
object[]

Attributes assigned for all products in the specified category.

​
productIds
string[]

System-generated 24-character product IDs associated with a category

​
children
object[]

Immediate children of the specified category

​
updatedBy
string

Email of user who last update the category

Example:

"[email protected]"

​
updatedAt
string

Time of last update to category

Example:

"2023-04-20T10:24:36.162Z"

​
createdAt
string

Time of category creation

Example:

"2021-04-20T10:24:36.162Z"