> ## 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.

# Tier2Tickets API

> Find the PC behind a help desk button ticket, read its diagnostic reports, and send endpoint actions through Tier2Tickets (Helpdesk Buttons)

The Tier2Tickets API tool gives Neo agents access to Tier2Tickets (Helpdesk Buttons), the help desk button on your clients' PCs. The common use is a button ticket: the agent takes the hostname from the ticket's report form, finds that PC in the client's group, and writes an internal note that says whether the PC is in your inventory, which client group it belongs to, whether it is online, when it was last seen, its agent version and its MAC address.

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

## What It Does

* Read the PCs running the button, by group (client), online state or agent version: hostname, OS, last seen, MAC address, and for one PC its last user, tags and local IP
* Read the groups your key reaches
* Read the diagnostic reports a button press files, with the ticket they belong to, the user's message and contact, and the PC's diagnostics
* Ask an online PC for a new diagnostic report, attached to the ticket you name
* Show the user a toast notification, or a popup message that can open a link
* Rename the desktop icon and set its key, pin the button to the taskbar, move PCs to another group, and upgrade the agent

Neo cannot read the Instant Replay screenshots, which are an image; the agent gives the technician the report's link. The API has no delete. Neo never sends an action to every group (`ALL`).

## Permission Groups

| Group | Access levels | Covers |
| - | - | - |
| Endpoints and Groups | Disabled, Read Only, Read / Write | PCs and groups; writes: desktop icon, taskbar pin, group move, agent upgrade |
| Diagnostic Reports | Disabled, Read Only, Read / Write | Reports and their diagnostics; a write requests a new report |
| End-User Messages | Disabled, Read / Write | Toast notifications and popup messages on the user's screen |

The Helpdesk preset asks a technician before every action, because each one reaches a client's PC or its user. A popup with a link always asks a technician, whatever the preset, because the user's OK opens the link on their PC.

## Setup

See [Connecting Tier2Tickets to Neo](https://docs.neoagent.io/integrations/tier2tickets/connecting-to-neo.md).


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