---
title: "Bulk update assets."
method: POST
path: "/api/apps/{app}/assets/bulk"
tags: ["Assets"]
---

# Bulk update assets.

`POST /api/apps/{app}/assets/bulk`

## Path parameters

- `app` string, required

## Request body

- BulkUpdateAssetsDto
  - `jobs` BulkUpdateAssetsJobDto[], nullable — The contents to update or insert.
    - `id` string — An optional ID of the asset to update.
    - `type` 'Annotate' | 'Move' | 'Delete'
    - `parentId` string — The parent folder id.
    - `fileName` string, nullable — The new name of the asset.
    - `slug` string, nullable — The new slug of the asset.
    - `isProtected` boolean, nullable — True, when the asset is not public.
    - `tags` string[], nullable — The new asset tags.
    - `metadata` object, nullable — The asset metadata.
    - `permanent` boolean — True to delete the asset permanently.
    - `expectedVersion` integer — The expected version.
  - `checkReferrers` boolean — True to check referrers of deleted assets.
  - `optimizeValidation` boolean — True to turn off costly validation: Folder checks. Default: true.
  - `doNotScript` boolean — True to turn off scripting for faster inserts. Default: true.

## Response `200`

Assets created, update or delete.

- BulkResultDto[]
  - `error` ErrorDto
    - `message` string, required — Error message.
    - `errorCode` string, nullable — The error code.
    - `traceId` string, nullable — The optional trace id.
    - `type` string, nullable — Link to the error details.
    - `details` string[], nullable — Detailed error messages.
    - `statusCode` integer, required — Status code of the http response.
  - `jobIndex` integer, required — The index of the bulk job where the result belongs to. The order can change.
  - `id` string, nullable — The ID of the entity that has been handled successfully or not.
  - `contentId` string, nullable — The ID of the entity that has been handled successfully or not.

## Other responses

- `400` — Assets request not valid.
- `404` — App not found.
- `500` — Operation failed.

---

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