> ## Documentation Index
> Fetch the complete documentation index at: https://docs.neoagent.io/llms.txt
> Use this file to discover all available pages before exploring further.

# HPE GreenLake API

> Read HPE warranty and support coverage by serial number, add HPE devices, read subscriptions, MSP tenants, locations and tags, and open HPE support cases

The common use is warranty and lifecycle planning: the agent, or a dashboard, reads the HPE warranty and support coverage of each customer's servers, storage and network devices by serial number, lists the devices whose coverage ends in a quarter, and reports any device HPE gives no coverage for as not verified.

> [!NOTE]
>
> Automatically enabled when you configure HPE GreenLake permissions in your agent workflow.

## What It Does

* Work in the ticket company's own tenant workspace, from the company mapping
* Read each device's warranty: its current support level, contract level, start and end date, and every coverage HPE has on record
* List devices by serial number, category, model or support end date
* Add a device by serial number and product number (servers, storage) or serial number and MAC address (network devices), so HPE returns its coverage
* Read subscriptions and their end dates, claim a subscription key
* Read HPE's wellness events and open an HPE support case for one
* Read and change locations and tags, users, user groups and role assignments, MSP tenant workspaces, webhooks; read audit logs and build reports

## Permission Groups

| Group | Access levels | Covers |
| - | - | - |
| Devices & Warranty | Disabled, Read Only, Read / Write | HPE devices with their warranty and support levels; add devices, assign them to a service or subscription, archive them |
| Subscriptions | Disabled, Read Only, Read / Write | Subscriptions, keys, tiers and end dates, auto-subscription settings |
| Locations & Tags | Disabled, Read Only, Read / Write | Locations and tags |
| Support Cases & Wellness | Disabled, Read Only, Read / Write | HPE support cases and wellness events |
| Workspaces & MSP Tenants | Disabled, Read Only, Read / Write | The workspace, MSP tenant workspaces, workspace groups |
| Users & Access | Disabled, Read Only, Read / Write | Users and user groups, role assignments and scope groups, API client credentials |
| Audit Logs & Reports | Disabled, Read Only, Read / Write | Audit logs and reports; building a report emails it |
| Services & Webhooks | Disabled, Read Only, Read / Write | The service catalog, provisioned services, webhooks and their subscriptions |

## Access Profiles

| Profile | What runs on its own | What asks a technician |
| - | - | - |
| **Read Only** | Every read | No write is allowed |
| **Helpdesk** | Every read | Every change in Devices & Warranty, Locations & Tags and Support Cases & Wellness (adding a device, opening a support case); no other write is allowed |
| **IT Admin** | Every read, and every change outside the three groups on the right and the Safety Controls | Every change in Users & Access, Workspaces & MSP Tenants and Services & Webhooks, and the Safety Controls |
| **Full Automation** | Every read and write outside the Safety Controls | The Safety Controls |

## Safety Controls

| Control | Behavior |
| - | - |
| **The ticket's customer only** | On a run for a ticket, Neo sends a call only for the tenant workspace the ticket's company is mapped to, and no MSP-level call |
| **Always asks a technician** | Creating or changing a role assignment, creating a user group or changing its members, replacing or widening a scope group, adding a workspace to a workspace group; deleting an API client credential; unclaiming subscriptions in bulk; deleting a provisioned service or retrying its removal; building or sharing a report, which emails it; creating or changing a webhook or its event subscriptions |
| **Refused** | Deleting an MSP tenant workspace; creating an API client credential or resetting its secret; the locations CSV upload |
| **Secrets** | Secrets, passwords and tokens are hidden in every answer |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.