---
title: "Bulk update assets"
method: POST
path: "/assets/bulk-update"
tags: ["Assets"]
---

# Bulk update assets

`POST /assets/bulk-update`

## Request

- Base URL: `https://public.escape.tech/v3`
- URL: `https://public.escape.tech/v3/assets/bulk-update`
- Auth: API key in header `X-ESCAPE-API-KEY`

Update tags, projects, or status of multiple assets matching a filter predicate.

## Request body

- object
  - `where` object, required: Filter predicate for assets
    - `assetIds` string[]: Filter by asset IDs
    - `search` string: Search term to filter assets by name or description
    - `types` string[]: Filter by type
    - `statuses` string[]: Filter by status
    - `projectIds` union: Filter by any of the listed project IDs
      - string
      - string[]
    - `tagIds` union: Filter by any of the listed tag IDs
      - string
      - string[]
    - `classes` string[]: Filter by class
    - `environments` string[]: Filter by environment
    - `domains` union: Filter by domain
      - string
      - string[]
    - `integrationIds` union: Filter by source integration ID
      - string
      - string[]
    - `ownerEmails` union: Filter by owner email
      - string
      - string[]
    - `technologyKeys` union: Filter by technology key
      - string
      - string[]
    - `ports` union: Filter by port number
      - string
      - union[]
        - union
          - string
          - number
    - `severities` string[]: Filter by severity
    - `risks` string[]: Filter by risk
    - `frameworks` string[]: Filter by framework
    - `manuallyCreated` boolean: Filter by manually created
  - `tagIds` string[]: Tag IDs to assign
  - `projectIds` string[]: Project IDs to assign
  - `status` 'DEPRECATED' | 'FALSE_POSITIVE' | 'MONITORED' | 'OUT_OF_SCOPE' | 'THIRD_PARTY': New status to apply

## Response `200`

OK

- object
  - `success` boolean, required

## Other responses

- `400`: Bad Request

---

[API](https://skmtc.dev/escape/apis/escape-public-api.md) - [All operations](https://skmtc.dev/escape/apis/escape-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/escape/apis/escape-public-api/revisions/2eab35df40c7?raw)