---
title: "Batch edit"
method: POST
path: "/batcheditfields_4FQ_v1"
---

# Batch edit

`POST /batcheditfields_4FQ_v1`

Edit multiple assets simultaneously

## Request body

- object
  - `documents` string[], required — The assets’ <a href="https://developer.orangelogic.com/reference/assets#unique-identifiers">Unique Identifier</a> or <a href="https://developer.orangelogic.com/reference/assets#record-id">Media Encrypted Identifier (RecordID)</a>, separated by commas.
  - `fieldAssignments` object[], required — The values to assign to each edited asset.
    - `field` string — The <a href="https://developer.orangelogic.com/reference/metadata-field-identifiers#api-name">API Name</a> of the metadata field to be edited, such as <code>CoreField.Title</code> or <code>CoreField.OriginalFileName</code>.
    - `value` string — The field’s new value.
    - `batchsettings` object — How to apply the value to the field. These options are similar to the <a href="https://link.orangelogic.com/CMS4/Permalinks/2P7YOHKMYWRT" target="_blank">Batch Edit methods</a> available in the Orange Logic interface.
      - `batchOption` 'None' | 'Append' | 'Prepend' | 'FindAndReplace' | 'RemoveFromValues' | 'AugmentAuthorityListsOnTheFly' — You have the following options for single- and multi-valued fields: <ul> <li><code>None</code>: Replace the whole value or list of values with the new value.</li> <li><code>Append</code>: Append the new value to the existing value or list of values.</li> <li><code>Prepend</code>: Prepend the new value to the existing value or list of values.</li> <li><code>FindAndReplace</code>: Find a value in the existing value or list of values in the field and replace it with the new value.</li> </ul> For multi-valued fields you can also choose: <ul> <li><code>RemoveFromValues</code>: Remove the value from the list of Tags in the authority list. </li> <li><code>AugmentAuthorityListsOnTheFly</code>: Create a new value and add it to the field’s authority list.</li> </ul>
      - `valueToFindAndReplace` string — If you selected <code>FindAndReplace</code> in <code>batchOptions</code>, include the value to find and replace. This value cannot be null or an empty string. <br></br> <strong>Note</strong>: The API cannot perform searches to replace values based on whether a field is either empty or filled. This functionality is available only in the Orange Logic interface.
  - `ignoreNotEditableDocuments` boolean — <ul><li>When <code>true</code>, the call edits all assets you have Permissions to edit and ignores any assets you don’t have Permissions to edit. The call returns an error for each asset you can’t edit.</li><li>When <code>false</code>, if you attempt to edit any assets you do not have Permissions to edit, the call returns a 400 error and does not perform any edits.</li></ul>
  - `ignoreInvalidDocuments` boolean — <ul><li>When <code>true</code>, the call edits assets that have valid identifiers and ignores any assets with invalid identifiers. The call returns an error for each asset with an invalid identifier.</li><li>When <code>false</code>, if you attempt to edit any assets with invalid identifiers, the call returns a 400 error and does not perform any edits.</li></ul>

## Response `200`

200

---

[API](https://skmtc.net/orangelogic/apis/security.md) · [All operations](https://skmtc.net/orangelogic/apis/security/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/orangelogic/security/versions/c8e945426c5e/schema)