Skip to main content
API Explorer|API Explorer
Infrastructure/Agents
POSTAgentSince 1.0SynchronousAuth Required

ApplyLabelTemplate

Apply a label template to a selection of agents with optional dry run support

Execution Availability

Try It Out

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

Path Parameters

Request Inputs

Path Parameters

  • idStringRequired

    UUID of the label template to apply

Body Fields

  • selectorObjectRequired

    Selector for this resource

    • uuidsList

      Uuids for this resource

      Example: item1,item2

    • typeString

      Filter agents by type

      Example: log

    • regionString

      Filter agents by deployment region

      Example: us-east-1

    • labelMatchLinkedHashMap

      Label matching criteria for agent selection

      Example: (nested object)

  • dryRunBooleanRequired

    If true, simulate the operation without persisting changes

    Example: false

Responses

200 OK

On success, this API returns the following response structure.

  • affectedCountInteger

    Number of agents that received the template labels

    Example: 30

  • affectedUuidsList

    Affected uuids

    Example: item1,item2

  • dryRunBoolean

    Whether this was a dry run without actual persistence

    Example: false

  • errorsList

    Errors for this resource

    Example: (nested array)

    • agentUuidString

      UUID of the agent where the label operation failed

      Example: agent-abc123-def456

    • errorString

      Description of the error that occurred

      Example: agent not found

Endpoint

POST/api/v1/agent/label-templates/{id}/apply

/api/v1/agent/label-templates/{id}/apply

Operation ID

ApplyLabelTemplate

Permalink

Request Example

curl -X POST '{host}/api/v1/agent/label-templates/{id}/apply' -H 'Authorization: Bearer {token}' -H 'Content-Type: application/json' -d '{"selector":{"uuids":"item1,item2","type":"log","region":"us-east-1","labelMatch":"(nested object)"},"dryRun":false}'

Response Example

200
{
  "affectedCount": 30,
  "affectedUuids": [],
  "dryRun": false,
  "errors": [
    {}
  ]
}

Change History

This API has no change history records yet.

View all change history