---
title: "Create mass edit job request"
slug: "create-mass-edit-job-request"
abstract: "Overview and example of the Create Edit Job Request Object."
---
# Create mass edit job request

A Create Mass Edit Job Request object is used to request the creation of a new Mass Edit Job. The following properties are present:

| Name | Type | Description |
| --- | --- | --- |
| `state_description` | [Labels](https://doc.sitecore.com/ch/en/developers/cloud-dev/labels.html) | A description of the current state of the Mass Edit Job. |
| `collection` | Collection | The details of the relation to navigate to determine the entities that must be processed. |
| `operations` | Array | The list of operations that must be performed on the entities in the collection. |

## Collection

The **collection** property determines which entities are processed. This property contains an object that has the following properties:

| Name | Type | Description |
| --- | --- | --- |
| `relation` | [Link](https://doc.sitecore.com/ch/en/developers/cloud-dev/link.html) | The link to the relation to navigate. |
| `role` | String | The type of role to navigate on the relation. This can be either "Parent" or "Child". |

The **role** property specifies the role of the relation on the side of the collection entity. If the **role** property is set to "Parent", the child entities of the relation are navigated. Likewise, if the **role** property is set to "Child", the parent entities of the relation are navigated.

## Operations

Each operation in the list is an Object that describes what that operation must do.

## Set Property Operation Object

Sets the value of a property, optionally for a specific culture. If no culture is specified, the value must consist of a [Labels](https://doc.sitecore.com/ch/en/developers/cloud-dev/labels.html "Labels") object with the values to set for multiple cultures at once. This object has the following properties.

| Name | Type | Description |
| --- | --- | --- |
| `type` | String | Set to "SetProperty" |
| `property` | String | The name of the property to set |
| `culture` | String | Optionally, the name of the culture for which to set the value in a multilanguage field. |
| `value` | Value | The value to set. |

## Append Property Operation Object

Appends the value of a property, optionally for a specific culture. This object has the following properties.

| Name | Type | Description |
| --- | --- | --- |
| `type` | String | Set to "AppendProperty" |
| `property` | String | The name of the property to append |
| `culture` | String | Optionally, the name of the culture for which to append the value in a multilanguage field. |
| `value` | Value | The value to append. |

## Clear Relation Operation Object

Sets the related members for a specific relation on the entity. The relation is cleared before this is done. This is the only operation that garantuees that the order of related entities is preserved. This object has the following properties.

| Name | Type | Description |
| --- | --- | --- |
| `type` | String | Set to "ClearRelation" |
| `relation` | String | The name of the relation to clear. |
| `role` | String | The type of role to change. Either 'Child' or 'Parent'. |

The role refers to the main entity. So in the case of the 'Child' role, the related entities are the parent or parents, and vice versa.

## Add Relation Operation Object

Adds a set of related members to a specific relation on the entity. Entities that are already related are not affected. This object has the following properties.

| Name | Type | Description |
| --- | --- | --- |
| `type` | String | Set to "AddRelation" |
| `relation` | String | The name of the relation to change. |
| `role` | String | The type of role to change. Either 'Child' or 'Parent'. |
| `value` | [Link](https://doc.sitecore.com/ch/en/developers/cloud-dev/link.html) or Array | A [Link](https://doc.sitecore.com/ch/en/developers/cloud-dev/link.html) object or array of [Link](https://doc.sitecore.com/ch/en/developers/cloud-dev/link.html) objects referring to the entities to add to the relation. |

The role refers to the main entity. So in the case of the 'Child' role, the related entities are the parent or parents, and vice versa.

## Remove Relation Operation Object

Removes a set of related members from a specific relation on the entity. Entities that are not part of the relation don't affect the operation. This object has the following properties.

| Name | Type | Description |
| --- | --- | --- |
| `type` | String | Set to "RemoveRelation" |
| `relation` | String | The name of the relation to change. |
| `role` | String | The type of role to change. Either 'Child' or 'Parent'. |
| `value` | [Link](https://doc.sitecore.com/ch/en/developers/cloud-dev/link.html) or Array | A [Link](https://doc.sitecore.com/ch/en/developers/cloud-dev/link.html) object or array of [Link](https://doc.sitecore.com/ch/en/developers/cloud-dev/link.html) objects referring to the entities to add to the relation. |

The role refers to the main entity. So in the case of the 'Child' role, the related entities are the parent or parents, and vice versa.

## Submit Operation Object

**TBD**

The presence of this type of operation automatically disables the normal flow of operations. This object has the following property.

| Name | Type | Description |
| --- | --- | --- |
| `type` | String | Set to "Submit" |

## Approve Operation Object

**TBD**

The presence of this type of operation automatically disables the normal flow of operations. This object has the following property.

| Name | Type | Description |
| --- | --- | --- |
| `type` | String | Set to "Approve" |

## Reject Operation Object

**TBD**

The presence of this type of operation automatically disables the normal flow of operations. This object has the following property.

| Name | Type | Description |
| --- | --- | --- |
| `type` | String | Set to "Reject" |

## Delete Entity Operation Object

Deletes the entity. The presence of this type of operation automatically disables the normal flow of operations and the entity is deleted immediately. This object has the following property.

| Name | Type | Description |
| --- | --- | --- |
| `type` | String | Set to "DeleteEntity" |

## Example

```json
{
  "stateDescription":"In progress",
  "collection":{
    "relation":{
      "href":"http://server/api/entities/23/CollectionToAsset"
    },
    "role":"Parent"
  },
  "operations":[
    {
      "type":"SetProperty",
      "property":"AssetName",
      "culture":"en-US",
      "value":"New name for this asset."
    },
    {
      "type":"SetProperty",
      "property":"AssetTitle",
      "value":{
        "en-US":"New name for this asset.",
        "nl-BE":"De naam voor dit nieuwe asset."
      }
    },
    {
      "type":"ClearRelation",
      "relation":"AssetToAssetType",
      "role":"Child"
    },
    {
      "type":"AddRelation",
      "relation":"AssetToAssetType",
      "role":"Child",
      "value":[
        {
          "href":"http://server/api/entities/14"
        },
        {
          "href":"http://server/api/entities/14"
        }
      ]
    },
    {
      "type":"RemoveRelation",
      "relation":"AssetToAssetType",
      "role":"Child",
      "value":[
        {
          "href":"http://server/api/entities/14"
        }
      ]
    }
  ]
}

```