v6

latestSwagger 2.02026-07-1342142196.4 KB
Assets

Update labels on assets matching the provided filter.

post/assets

Query parameters

api-versionstring required

The API version to use for this operation.

filterstring required

An expression on the resource type that selects the resources to be returned.

Request body

state'candidate' | 'confirmed' | 'dismissed' | 'candidateInvestigate' | 'associatedPartner' | 'associatedThirdparty'

The state to update the asset to.

externalIdstring

A string which can be used to identify the asset in external systems.

labelsobject

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.

Response

The request has succeeded.

idstring required

The unique identifier of the task.

startedAtstring date-time

The time the task started.

completedAtstring date-time

The time the task completed.

lastPolledAtstring 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.

reasonstring

The reason the task was moved into its current state, if the task wasn't completed.

metadataobject

Attributes unique to the task. This differs by task type.