younifyd
Menu

deleteCategory

Delete a category (requires its current version).

Use it in a workflow

  1. Add a step and choose the Commercetools connector.
  2. Pick the deleteCategory action (under Delete).
  3. Fill in the fields below, then reference the result from later steps as {{deletecategory.response.data}}.

Query

This is the mutation the action sends by default. Edit it in the step's Query field to change which fields come back.

graphql
mutation DeleteCategory($version: Long!, $id: String, $key: String) {
  deleteCategory(version: $version, id: $id, key: $key) {
    id
    key
    version
    nameAllLocales {
      locale
      value
    }
    descriptionAllLocales {
      locale
      value
    }
    slugAllLocales {
      locale
      value
    }
    ancestorsRef {
      typeId
      id
    }
    ancestors
    parentRef {
      typeId
      id
    }
    parent
    orderHint
    externalId
    metaTitleAllLocales {
      locale
      value
    }
    metaKeywordsAllLocales {
      locale
      value
    }
    metaDescriptionAllLocales {
      locale
      value
    }
    stagedProductCount
    childCount
    children
    createdAt
    lastModifiedAt
    assets {
      id
      key
      sources {
        uri
        key
        dimensions
        contentType
      }
      nameAllLocales {
        locale
        value
      }
      descriptionAllLocales {
        locale
        value
      }
      tags
      custom {
        typeRef
        type
      }
    }
    custom {
      typeRef {
        typeId
        id
      }
      type {
        key
        nameAllLocales
        descriptionAllLocales
        resourceTypeIds
        id
        version
        createdAt
        lastModifiedAt
        createdBy
        lastModifiedBy
      }
    }
    createdBy {
      isPlatformClient
      clientId
      externalUserId
      anonymousId
      customerRef {
        typeId
        id
      }
      userRef {
        typeId
        id
      }
      associateRef {
        typeId
        id
      }
      attributedTo {
        clientId
        source
        userRef
      }
    }
    lastModifiedBy {
      isPlatformClient
      clientId
      externalUserId
      anonymousId
      customerRef {
        typeId
        id
      }
      userRef {
        typeId
        id
      }
      associateRef {
        typeId
        id
      }
      attributedTo {
        clientId
        source
        userRef
      }
    }
  }
}

Variables

Pass these as a JSON object in the step's Variables field.

versionstringrequired
idstring

Queries with specified ID

keystring

Queries with specified key

json
{
  "version": "string",
  "id": "string",
  "key": "string"
}

Response

Read the result with {{deletecategory.response.data.data.deleteCategory}}. If the API returns errors, the step fails and they are at {{deletecategory.response.data.errors}}.

idstring
keystring
versionstring
nameAllLocalesarray<object>
localeobject
valueobject
descriptionAllLocalesarray<object>
localeobject
valueobject
slugAllLocalesarray<object>
localeobject
valueobject
ancestorsRefarray<object>
typeIdobject
idobject
ancestorsarray<object>
parentRefobject
typeIdstring
idstring
parentobject

Recursive reference to Category, not further expanded.

orderHintstring
externalIdstring
metaTitleAllLocalesarray<object>
localeobject
valueobject
metaKeywordsAllLocalesarray<object>
localeobject
valueobject
metaDescriptionAllLocalesarray<object>
localeobject
valueobject
stagedProductCountnumber
childCountnumber
childrenarray<object>
createdAtstring
lastModifiedAtstring
assetsarray<object>
idobject
keyobject
sourcesobject
nameAllLocalesobject
descriptionAllLocalesobject
tagsobject
customobject
customobject
typeRefobject2 fields
typeobject10 fields
createdByobject
isPlatformClientboolean
clientIdstring
externalUserIdstring
anonymousIdstring
customerRefobject2 fields
userRefobject2 fields
associateRefobject2 fields
attributedToobject3 fields
lastModifiedByobject
isPlatformClientboolean
clientIdstring
externalUserIdstring
anonymousIdstring
customerRefobject2 fields
userRefobject2 fields
associateRefobject2 fields
attributedToobject3 fields

Need more? See the Commercetools guide for connection setup and behaviour shared by every action.

deleteCategory — Commercetools — Documentation