Lenovo Inventory API

Query inventory of managed devices.

Operations 7

GET /nodes List nodes #
GET /nodes/{uuid} Get a node by UUID #
PUT /nodes/{uuid} Modify a node #
GET /storage List storage devices #
GET /switches List switches #
GET /canisters List canisters #
GET /cabinet List cabinets #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/lenovo-inventory-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

lenovo-inventory-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Lenovo XClarity Administrator REST Inventory API
  description: 'Programmatic access to Lenovo XClarity Administrator (LXCA) for managing

    Lenovo servers, storage, and switches.'
  version: 1.0.0
  contact:
    name: Lenovo XClarity Documentation
    url: https://pubs.lenovo.com/lxca_scripting/
  license:
    name: Lenovo Proprietary
servers:
- url: https://{xclarityHost}
  description: Lenovo XClarity Administrator management server
  variables:
    xclarityHost:
      default: lxca.example.com
      description: Hostname or IP address of the XClarity Administrator server
security:
- sessionCookie: []
tags:
- name: Inventory
  description: Query inventory of managed devices.
paths:
  /nodes:
    get:
      tags:
      - Inventory
      summary: List nodes
      description: Retrieve properties for all managed servers and Flex System storage devices.
      operationId: listNodes
      responses:
        '200':
          description: A list of nodes.
          content:
            application/json:
              schema:
                type: object
                properties:
                  nodeList:
                    type: array
                    items:
                      $ref: '#/components/schemas/Node'
  /nodes/{uuid}:
    get:
      tags:
      - Inventory
      summary: Get a node by UUID
      description: Retrieve properties for a specific server.
      operationId: getNode
      parameters:
      - name: uuid
        in: path
        required: true
        description: UUID of the managed node.
        schema:
          type: string
      responses:
        '200':
          description: Node properties.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Node'
        '404':
          description: Node not found.
    put:
      tags:
      - Inventory
      summary: Modify a node
      description: 'Modify properties of a specific server, including operations such as

        turning location LEDs on or off.'
      operationId: modifyNode
      parameters:
      - name: uuid
        in: path
        required: true
        description: UUID of the managed node.
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              description: Properties to modify on the node.
              additionalProperties: true
      responses:
        '200':
          description: Node updated.
        '404':
          description: Node not found.
  /storage:
    get:
      tags:
      - Inventory
      summary: List storage devices
      description: Retrieve properties for all managed storage devices.
      operationId: listStorage
      responses:
        '200':
          description: A list of storage devices.
          content:
            application/json:
              schema:
                type: object
                properties:
                  storageList:
                    type: array
                    items:
                      type: object
                      additionalProperties: true
  /switches:
    get:
      tags:
      - Inventory
      summary: List switches
      description: Retrieve properties for all managed Flex System and RackSwitch switches.
      operationId: listSwitches
      responses:
        '200':
          description: A list of switches.
          content:
            application/json:
              schema:
                type: object
                properties:
                  switchList:
                    type: array
                    items:
                      type: object
                      additionalProperties: true
  /canisters:
    get:
      tags:
      - Inventory
      summary: List canisters
      description: Retrieve properties and metrics for all Flex System storage controllers (canisters).
      operationId: listCanisters
      responses:
        '200':
          description: A list of canisters.
          content:
            application/json:
              schema:
                type: object
                properties:
                  canisterList:
                    type: array
                    items:
                      type: object
                      additionalProperties: true
  /cabinet:
    get:
      tags:
      - Inventory
      summary: List cabinets
      description: Retrieve properties for all configured cabinets (racks) and the devices placed in them.
      operationId: listCabinets
      responses:
        '200':
          description: A list of cabinets and their device placements.
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
components:
  schemas:
    Node:
      type: object
      description: A managed server or Flex System storage node.
      properties:
        uuid:
          type: string
          description: Unique identifier of the node.
        name:
          type: string
        machineType:
          type: string
        model:
          type: string
        serialNumber:
          type: string
        status:
          type: object
          additionalProperties: true
      additionalProperties: true
  securitySchemes:
    sessionCookie:
      type: apiKey
      in: cookie
      name: JSESSIONID
      description: 'Session cookie issued by `POST /sessions`. Requests also require

        the `X-Csrf-Token` header populated from the session response.

        '
externalDocs:
  description: Lenovo XClarity Administrator REST API reference
  url: https://pubs.lenovo.com/lxca_scripting/rest_apis