Recompute component labels

POST

/components:recomputeLabels

const url = 'https://example.com/api/v1/components:recomputeLabels';
const options = {method: 'POST'};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request POST \
  --url https://example.com/api/v1/components:recomputeLabels

Applies what :previewLabels describes, over the rows in the caller’s read and update scope, and returns exactly what it changed. Idempotent: a second call changes nothing. A label an operator typed by hand is left alone, and clearing that label by hand is how it is handed back to the platform. Recorded as ONE audit row for the operation, naming the rule tier and the affected count, rather than one row per changed entity. Gated by component:update.

Responses

200

application/json

object

$schema

A URL to the JSON Schema for this object.

string format: uri

changed

required

Every row, one entry each. Bounded by the fleet, not paginated: this is the whole blast radius by design

Array<object> | null

object

from

required

The label as stored now; empty when the entity has none

string

required

The entity’s uuid

string

kind

required

The entity kind this row belongs to: component, system, or location

string

name

required

The entity’s name, for display

string

required

The label its rules produce; empty when the rule renders nothing

string

count

required

How many rows changed, or would change

integer format: int64

Example

{
  "$schema": "/api/v1/schemas/LabelRecomputeOutputBody.json"
}

default

Error

application/problem+json

object

$schema

A URL to the JSON Schema for this object.

string format: uri

detail

A human-readable explanation specific to this occurrence of the problem.

string

errors

Optional list of individual error details

Array<object> | null

object

location

Where the error occurred, e.g. ‘body.items[3].tags’ or ‘path.thing-id’

string

message

Error message text

string

value

The value at the given location

instance

A URI reference that identifies the specific occurrence of the problem.

string format: uri

status

HTTP status code

integer format: int64

title

A short, human-readable summary of the problem type. This value should not change between occurrences of the error.

string

type

A URI reference to human-readable documentation for the error.

string format: uri

default: about:blank

Example

{
  "$schema": "/api/v1/schemas/ErrorModel.json",
  "detail": "Property foo is required but is missing.",
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "about:blank"
}