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

# POST /assets

`POST /assets`

Update labels on assets matching the provided filter.

## Query parameters

- `api-version` string, required
- `filter` string, required

## Request body

- AssetUpdateData — A request body used to update an asset.
  - `state` 'candidate' | 'confirmed' | 'dismissed' | 'candidateInvestigate' | 'associatedPartner' | 'associatedThirdparty' — The state to update the asset to.
  - `externalId` string — A string which can be used to identify the asset in external systems.
  - `labels` object — Any Labels to update the asset with.
  - `transfers` 'as' | 'contact' | 'domain' | 'host' | 'ipAddress' | 'ipBlock' | 'page' | 'sslCert' — A list of asset types to cascade the updates to.
  - `remediations` ObservationRemediationItem[] — A list of observation remediations to apply to the asset.
    - `kind` 'cve' | 'insight', required — A list of observation types
    - `name` string, required — The name of the observation to remediate.
    - `state` 'active' | 'nonApplicable', required — A list of observation states

## Response `200`

The request has succeeded.

- Task
  - `id` string, required — The unique identifier of the task.
  - `startedAt` string, date-time — The time the task started.
  - `completedAt` string, date-time — The time the task completed.
  - `lastPolledAt` string, date-time — The last time the status of the task was updated.
  - `state` 'pending' | 'running' | 'paused' | 'complete' | 'incomplete' | 'failed' | 'warning' — The state the task is in.
  - `phase` 'running' | 'polling' | 'complete' — The phase the task is in.
  - `reason` string — The reason the task was moved into its current state, if the task wasn't completed.
  - `metadata` object — Attributes unique to the task. This differs by task type.

## Other responses

- `default` — An unexpected error response.

---

[API](https://skmtc.net/azure/apis/riskiq-microsoft-easm.md) · [All operations](https://skmtc.net/azure/apis/riskiq-microsoft-easm/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/riskiq-microsoft-easm/revisions/5865b52c51a3/schema)