> ## Documentation Index
> Fetch the complete documentation index at: https://densify-sync-changelog-2.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Modify System Attributes

> Modifies attribute values for a system. For existing attributes, updates their values.
For non-existent attributes, adds the `[name, value]` tuple.

For multi-value attributes, adding a `[name, value]` not present will append a new entry.
To overwrite a multi-value attribute value, delete the existing value first.




## OpenAPI

````yaml /openapi/systems.yaml PUT /systems/{id}/attributes
openapi: 3.0.3
info:
  title: Kubex Systems API
  version: 1.0.0
  description: >
    Endpoints for retrieving and managing systems discovered via Kubex data
    collection.


    Notes:

    - Returned element values match those shown in Kubex Analysis Console (DSE >
    System Summary / Attributes).

    - Filtering supports element filters and advanced attribute filters (see
    query parameters on `GET /systems`).

    - Some fields appear only when `details=true` is requested.
servers:
  - url: https://{host}
    variables:
      host:
        default: api.example.com
        description: Replace with your Kubex API host
security:
  - bearerAuth: []
tags:
  - name: Systems
    description: Systems collection and single-system resources
paths:
  /systems/{id}/attributes:
    put:
      tags:
        - Systems
      summary: Modify System Attributes
      description: >
        Modifies attribute values for a system. For existing attributes, updates
        their values.

        For non-existent attributes, adds the `[name, value]` tuple.


        For multi-value attributes, adding a `[name, value]` not present will
        append a new entry.

        To overwrite a multi-value attribute value, delete the existing value
        first.
      operationId: modifySystemAttributes
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
          description: Kubex unique system ID
      requestBody:
        required: true
        description: Array of attributes to set/add
        content:
          application/json:
            schema:
              type: array
              items:
                type: object
                required:
                  - name
                  - value
                properties:
                  name:
                    type: string
                  value:
                    type: string
            examples:
              modifyExample:
                value:
                  - name: Observed Uptime
                    value: '0.33'
                  - name: Cost
                    value: '17'
      responses:
        '200':
          description: System with attributes modified
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/System'
        '400':
          description: Invalid attribute payload
        '401':
          description: Unauthorized
        '404':
          description: System not found
        '500':
          description: Internal server error
components:
  schemas:
    System:
      type: object
      description: A discovered system
      properties:
        id:
          type: string
          description: Kubex unique system ID
        name:
          type: string
        href:
          type: string
        resource_id:
          type: string
          description: Cloud/provider unique ID (when applicable)
        type:
          type: string
          description: System type
          enum:
            - host
            - guest
            - vm
            - arm_vm
            - classic_vm
            - rds
            - asg
            - ecs_svc
        platform:
          type: string
          description: System platform
          enum:
            - VMWARE
            - HMC
            - AWS
            - GCP
            - AZURE
            - CONTAINERS
        platform_model:
          type: string
          description: Host model (hosts) or instance type (cloud instances)
        total_physical_cpus:
          type: string
          description: Secondary sort key for `sort_by=size`
        total_logical_cpus:
          type: string
        cores_per_cpu:
          type: string
          description: Tertiary sort key for `sort_by=size`
        threads_per_core:
          type: string
        memory:
          type: string
          description: Normalized total memory (MB). Primary sort key within `size`
        parent:
          type: string
          description: Parent host name for VMs; "N/A" for hosts
        children:
          type: string
          description: >-
            Number of child systems (returned when `details=true` and
            applicable)
        manufacturer:
          type: string
          description: Returned when `details=true`
        os:
          type: string
          description: Returned when `details=true`
        os_patch_level:
          type: string
        os_version:
          type: string
        ip_address:
          type: string
        mac_address:
          type: string
        entity_role_name:
          type: string
          description: Role derived from platform/role (e.g., VMWARE_VM)
        entity_type:
          type: string
          description: Entity type derived from platform/system type
        control_environment:
          $ref: '#/components/schemas/ControlEnvironmentRef'
        infrastructure_group:
          $ref: '#/components/schemas/InfrastructureGroupRef'
        cpu_benchmarks:
          type: array
          items:
            $ref: '#/components/schemas/CpuBenchmark'
        I/O_benchmarks:
          type: array
          items:
            $ref: '#/components/schemas/IoBenchmark'
        attributes:
          type: array
          items:
            $ref: '#/components/schemas/AttributeTriple'
      required:
        - id
        - name
        - href
    ControlEnvironmentRef:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        platform_category:
          type: string
          description: Control environment category
          enum:
            - External Cloud
            - Internal Virtual
        href:
          type: string
        icon:
          type: string
          description: Path to icon resource
    InfrastructureGroupRef:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        href:
          type: string
    CpuBenchmark:
      type: object
      properties:
        name:
          type: string
          description: Benchmark label
          enum:
            - CINT2000
            - CINT2000 Rate
            - CINT2006 Rate
            - RPE2
        score_type:
          type: string
          enum:
            - cint2000
            - cint2000rate
            - cint2006rate
            - rpe2
        value:
          type: number
          format: float
    IoBenchmark:
      type: object
      properties:
        name:
          type: string
          enum:
            - Maximum Disk Throughput (bytes/s)
            - Maximum Network Throughput (bytes/s)
        score_type:
          type: string
          enum:
            - disk
            - net
        value:
          type: number
          description: A value of -1 means no value specified
    AttributeTriple:
      type: object
      description: Attribute entry stored as [id, name, value]
      required:
        - id
        - name
        - value
      properties:
        id:
          type: string
          description: Unique attribute ID (e.g., attr_ObservedUptime)
        name:
          type: string
          description: Human-readable attribute name
        value:
          type: string
          description: Attribute value
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````