Skip to main content
API Explorer|API Explorer
Infrastructure/Assets
POSTInfrastructureSince 1.0SynchronousAuth Required

BatchAssetLabels

Apply label changes to multiple assets of the same type in a single request.

Execution Availability

Try It Out

Submit a mock request using the current auth context and example-driven inputs.

Path Parameters

Request Inputs

Path Parameters

  • assetTypeStringRequired

    Type of the assets to apply labels to (e.g. vm, host, volume)

Body Fields

  • assetUuidsListRequired

    Asset uuids

    Example: item1,item2

  • modeStringRequired

    Label application mode: append adds new labels, overwrite replaces all existing labels

    Example: append

  • labelsObjectRequired

    Key-value labels attached to this resource

    Example: (nested object)

Responses

200 OK

On success, this API returns the following response structure.

  • dataObject

    The data value

    Example: (nested object)

Endpoint

POST/api/v1/assets/{assetType}/batch-labels

/api/v1/assets/{assetType}/batch-labels

Operation ID

BatchAssetLabels

Permalink

Request Example

curl -X POST '{host}/api/v1/assets/{assetType}/batch-labels' -H 'Authorization: Bearer {token}' -H 'Content-Type: application/json' -d '{"assetUuids":"item1,item2","mode":"append","labels":"(nested object)"}'

Response Example

200
{
  "data": null
}

Change History

This API has no change history records yet.

View all change history