> For the complete documentation index, see [llms.txt](https://docs.devolutions.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.devolutions.net/unigetui/de/referenz/ipc-api.md).

# Automatisierungs-API (IPC)

Die lokale HTTP-API hinter der Befehlszeile von UniGetUI, mit Transporten, Authentifizierung, Anforderungstexten und jedem Endpunkt.

UniGetUI stellt eine lokale HTTP-API bereit, mit der die [Befehlszeilenschnittstelle](/unigetui/de/referenz/cli.md) eine Sitzung steuert. Sie können sie direkt aufrufen, um UniGetUI in eigene Skripte und Tools einzubinden. Jeder Endpunkt liegt unter `/uniget/v1/`, und jeder hat ein CLI-Äquivalent.

{% hint style="danger" %}
Die API ist nur für die lokale Automatisierung vorgesehen. Geben Sie sie nicht im Netzwerk frei.
{% endhint %}

## Transporte

<table><thead><tr><th width="250">EINSTELLUNG</th><th>STANDARD</th></tr></thead><tbody><tr><td>Transport</td><td><code>named-pipe</code>: eine benannte Windows-Pipe unter Windows, ein Unix-Domain-Socket unter macOS und Linux.</td></tr><tr><td>Alternativer Transport</td><td><code>tcp</code>, nur an <code>localhost</code> gebunden.</td></tr><tr><td>TCP-Port</td><td><code>7058</code></td></tr><tr><td>Pipename</td><td><code>UniGetUI.IPC</code></td></tr><tr><td>Ordner des Unix-Sockets (macOS, Linux)</td><td><code>/tmp</code></td></tr></tbody></table>

Unter macOS und Linux wird ein relativer Pipename wie `UniGetUI.IPC` in `/tmp/UniGetUI.IPC` aufgelöst, und ein absoluter Pfad wird unverändert verwendet. Unter Windows werden absolute Pipe-Pfade abgelehnt und der standardmäßige Pipename verwendet.

{% hint style="info" %}
In einer Desktopsitzung läuft die API nur, wenn ***Hintergrund-API aktivieren (UniGetUI-Widgets und -Zugriff, Port 7058)*** unter ***Einstellungen*** – ***Experimentelle und Entwickleroptionen*** aktiviert ist. Eine mit `--headless` gestartete Sitzung führt sie immer aus.
{% endhint %}

### Serverkonfiguration

Wird gelesen, wenn UniGetUI die API startet.

<table><thead><tr><th width="250">ARGUMENT</th><th>UMGEBUNGSVARIABLE</th><th>FUNKTION</th></tr></thead><tbody><tr><td><code>--ipc-api-transport {named-pipe|tcp}</code></td><td><code>UNIGETUI_IPC_API_TRANSPORT</code></td><td>Transport der API.</td></tr><tr><td><code>--ipc-api-port &#x3C;port></code></td><td><code>UNIGETUI_IPC_API_PORT</code></td><td>TCP-Port, mit dem Transport <code>tcp</code>.</td></tr><tr><td><code>--ipc-api-pipe-name &#x3C;name-or-path></code></td><td><code>UNIGETUI_IPC_API_PIPE_NAME</code></td><td>Pipename oder Pfad des Unix-Sockets, mit dem Transport <code>named-pipe</code>.</td></tr></tbody></table>

### Clientkonfiguration

Wird von der CLI gelesen, um die Sitzung zu finden.

<table><thead><tr><th width="250">ARGUMENT</th><th>UMGEBUNGSVARIABLE</th><th>FUNKTION</th></tr></thead><tbody><tr><td><code>--transport {named-pipe|tcp}</code></td><td><code>UNIGETUI_IPC_API_TRANSPORT</code></td><td>Transport zum Erreichen der Sitzung.</td></tr><tr><td><code>--tcp-port &#x3C;port></code></td><td><code>UNIGETUI_IPC_API_PORT</code></td><td>TCP-Port der Sitzung.</td></tr><tr><td><code>--pipe-name &#x3C;name-or-path></code></td><td><code>UNIGETUI_IPC_API_PIPE_NAME</code></td><td>Pipename oder Pfad des Unix-Sockets der Sitzung.</td></tr></tbody></table>

## Sitzungserkennung

Jede Sitzung registriert ihren Endpunkt und ihr Token im Konfigurationsordner des Benutzers. Ohne Transportoption geht der Client wie folgt vor:

1. Lädt die registrierten Sitzungen, zuerst die Sitzungen ohne Benutzeroberfläche, danach die neuesten.
2. Verbindet sich mit der ersten laufenden Sitzung und verwendet automatisch ihr Token.

Mit einer Transportoption verbindet sich der Client mit diesem Transport und wartet bis zu 5 Sekunden, bis ein passendes Token erscheint.

## Authentifizierung

<table><thead><tr><th width="250">ENDPUNKT</th><th>AUTHENTIFIZIERUNG</th></tr></thead><tbody><tr><td><code>GET /uniget/v1/status</code></td><td>Keine.</td></tr><tr><td>Alle anderen Endpunkte</td><td>Abfrageparameter <code>token</code>.</td></tr></tbody></table>

UniGetUI erzeugt bei jedem Start der API ein neues Token und speichert es mit der Sitzungsregistrierung. Die CLI fügt es Anforderungen automatisch hinzu.

## Sicherheit

* Der TCP-Modus überwacht nur `localhost`, nicht alle Netzwerkschnittstellen.
* Unter macOS und Linux ist der Unix-Socket nur für den Besitzer lesbar und beschreibbar (entspricht `0600`).
* Unter Windows erzeugt die Named Pipe keine Datei auf dem Datenträger.

## Antworten und Fehler

<table><thead><tr><th width="250">BEDINGUNG</th><th>ERGEBNIS</th></tr></thead><tbody><tr><td>Fehlendes oder ungültiges Token</td><td>HTTP <code>401</code>.</td></tr><tr><td>Ungültige Argumente der Abfrage oder des Textes</td><td>HTTP <code>400</code> mit einer Klartextmeldung.</td></tr><tr><td>Erfolg</td><td>JSON mit Eigenschaftsnamen in camelCase.</td></tr></tbody></table>

## Anforderungsparameter

Die meisten Endpunkte erwarten Abfrageparameter. Die folgenden Endpunkte erwarten stattdessen einen JSON-Text mit Feldern in camelCase.

### Anforderungstext für die Managerwartung

Verwendet von `/managers/maintenance/reload`, `/executable/set`, `/executable/clear` und `/action`.

<table><thead><tr><th width="250">FELD</th><th>TYP</th><th>BESCHREIBUNG</th></tr></thead><tbody><tr><td><code>managerName</code></td><td>string</td><td>Erforderlich. Manager-ID, zum Beispiel <code>winget</code>.</td></tr><tr><td><code>action</code></td><td>string</td><td>Wartungsaktion, für <code>/action</code>.</td></tr><tr><td><code>path</code></td><td>string</td><td>Benutzerdefinierter Pfad der ausführbaren Datei, für <code>/executable/set</code>.</td></tr><tr><td><code>confirm</code></td><td>boolean</td><td>Bestätigt eine zerstörerische Aktion.</td></tr></tbody></table>

### Anforderungstext für die GitHub-Anmeldung

<table><thead><tr><th width="250">FELD</th><th>TYP</th><th>BESCHREIBUNG</th></tr></thead><tbody><tr><td><code>launchBrowser</code></td><td>boolean</td><td>Öffnet die Bestätigungs-URL automatisch im Browser.</td></tr></tbody></table>

### Anforderungstext für die Cloud-Sicherung

<table><thead><tr><th width="250">FELD</th><th>TYP</th><th>BESCHREIBUNG</th></tr></thead><tbody><tr><td><code>key</code></td><td>string</td><td>Kennung der Sicherung.</td></tr><tr><td><code>append</code></td><td>boolean</td><td>Ergänzt das aktuelle Bündel, statt es zu ersetzen.</td></tr></tbody></table>

### Anforderungstext für den Bündelimport

<table><thead><tr><th width="250">FELD</th><th>TYP</th><th>BESCHREIBUNG</th></tr></thead><tbody><tr><td><code>path</code></td><td>string</td><td>Pfad der Bündeldatei.</td></tr><tr><td><code>content</code></td><td>string</td><td>Unverarbeiteter Bündelinhalt.</td></tr><tr><td><code>format</code></td><td>string</td><td><code>ubundle</code>, <code>json</code>, <code>yaml</code> oder <code>xml</code>.</td></tr><tr><td><code>append</code></td><td>boolean</td><td>Fügt die importierten Pakete zum aktuellen Bündel hinzu.</td></tr></tbody></table>

### Anforderungstext für den Bündelexport

<table><thead><tr><th width="250">FELD</th><th>TYP</th><th>BESCHREIBUNG</th></tr></thead><tbody><tr><td><code>path</code></td><td>string</td><td>Optionaler Pfad der Ausgabedatei.</td></tr></tbody></table>

### Anforderungstext für ein Paket des Bündels

<table><thead><tr><th width="250">FELD</th><th>TYP</th><th>BESCHREIBUNG</th></tr></thead><tbody><tr><td><code>packageId</code></td><td>string</td><td>Paketbezeichner.</td></tr><tr><td><code>managerName</code></td><td>string</td><td>Manager-ID.</td></tr><tr><td><code>packageSource</code></td><td>string</td><td>Name der Quelle.</td></tr><tr><td><code>version</code></td><td>string</td><td>Angeforderte Version.</td></tr><tr><td><code>scope</code></td><td>string</td><td>Angeforderter Bereich.</td></tr><tr><td><code>preRelease</code></td><td>boolean</td><td>Schließt Vorabversionen ein.</td></tr><tr><td><code>selection</code></td><td>string</td><td>Wie das Paket gefunden wird: <code>search</code>, <code>installed</code>, <code>updates</code> oder <code>auto</code>.</td></tr></tbody></table>

### Anforderungstext für die Installation des Bündels

<table><thead><tr><th width="250">FELD</th><th>TYP</th><th>BESCHREIBUNG</th></tr></thead><tbody><tr><td><code>includeInstalled</code></td><td>boolean</td><td>Verarbeitet auch bereits installierte Pakete.</td></tr><tr><td><code>elevated</code></td><td>boolean</td><td>Wird mit Administratorrechten ausgeführt.</td></tr><tr><td><code>interactive</code></td><td>boolean</td><td>Führt die Installationsprogramme interaktiv aus.</td></tr><tr><td><code>skipHash</code></td><td>boolean</td><td>Überspringt die Hashprüfung, wenn sie unterstützt wird.</td></tr></tbody></table>

### Abfrageparameter des Pakets

Wird von den Paketendpunkten verwendet (Details, Versionen, Installation, Update, Deinstallation, Download, ignorierte Updates).

<table><thead><tr><th width="250">PARAMETER</th><th>BESCHREIBUNG</th></tr></thead><tbody><tr><td><code>packageId</code></td><td>Paketbezeichner.</td></tr><tr><td><code>manager</code></td><td>Manager-ID.</td></tr><tr><td><code>packageSource</code></td><td>Name der Quelle.</td></tr><tr><td><code>version</code></td><td>Angeforderte Version.</td></tr><tr><td><code>scope</code></td><td>Installationsbereich.</td></tr><tr><td><code>preRelease</code></td><td>Boolesch. Schließt Vorabversionen ein.</td></tr><tr><td><code>elevated</code></td><td>Boolesch. Wird mit Administratorrechten ausgeführt.</td></tr><tr><td><code>interactive</code></td><td>Boolesch. Führt das Installationsprogramm interaktiv aus.</td></tr><tr><td><code>skipHash</code></td><td>Boolesch. Überspringt die Hashprüfung.</td></tr><tr><td><code>removeData</code></td><td>Boolesch. Entfernt die Paketdaten bei der Deinstallation.</td></tr><tr><td><code>wait</code></td><td>Boolesch. Wartet auf den Abschluss des Vorgangs.</td></tr><tr><td><code>architecture</code></td><td>Zu installierende Architektur.</td></tr><tr><td><code>location</code></td><td>Installationsordner.</td></tr><tr><td><code>outputPath</code></td><td>Downloadordner. Standardmäßig der in den Einstellungen festgelegte Downloadort oder der Ordner Downloads des Benutzers.</td></tr></tbody></table>

### Andere Abfrageparameter

<table><thead><tr><th width="250">PARAMETER</th><th>VERWENDET VON</th></tr></thead><tbody><tr><td><code>page</code>, <code>manager</code>, <code>helpAttachment</code></td><td><code>/app/navigate</code></td></tr><tr><td><code>tailLines</code></td><td><code>/operations/{operationId}/output</code></td></tr><tr><td><code>mode</code></td><td><code>/operations/{operationId}/retry</code></td></tr><tr><td><code>action</code></td><td><code>/operations/{operationId}/reorder</code></td></tr></tbody></table>

## Endpunkte

Die Pfade sind relativ zu `/uniget/v1`. Alle außer `/status` benötigen den Abfrageparameter `token`.

### Sitzung und Anwendung

<table><thead><tr><th width="250">METHODE</th><th>PFAD</th><th>PARAMETER</th><th>CLI-ÄQUIVALENT</th></tr></thead><tbody><tr><td><code>GET</code></td><td><code>/status</code></td><td>Keine</td><td><code>status</code>, <code>version</code>. Gibt <code>running</code>, <code>transport</code>, <code>tcpPort</code>, <code>namedPipeName</code>, <code>namedPipePath</code>, <code>baseAddress</code>, <code>version</code>, <code>buildNumber</code> zurück.</td></tr><tr><td><code>GET</code></td><td><code>/app</code></td><td>Keine</td><td><code>app status</code></td></tr><tr><td><code>POST</code></td><td><code>/app/show</code></td><td>Keine</td><td><code>app show</code></td></tr><tr><td><code>POST</code></td><td><code>/app/navigate</code></td><td>Abfrage: <code>page</code>, optional <code>manager</code>, <code>helpAttachment</code></td><td><code>app navigate</code></td></tr><tr><td><code>POST</code></td><td><code>/app/quit</code></td><td>Keine</td><td><code>app quit</code></td></tr></tbody></table>

### Vorgänge

<table><thead><tr><th width="250">METHODE</th><th>PFAD</th><th>PARAMETER</th><th>CLI-ÄQUIVALENT</th></tr></thead><tbody><tr><td><code>GET</code></td><td><code>/operations</code></td><td>Keine</td><td><code>operation list</code></td></tr><tr><td><code>GET</code></td><td><code>/operations/{operationId}</code></td><td>Route: <code>operationId</code></td><td><code>operation get</code></td></tr><tr><td><code>GET</code></td><td><code>/operations/{operationId}/output</code></td><td>Route: <code>operationId</code>, optionale Abfrage <code>tailLines</code></td><td><code>operation output</code></td></tr><tr><td><code>POST</code></td><td><code>/operations/{operationId}/cancel</code></td><td>Route: <code>operationId</code></td><td><code>operation cancel</code></td></tr><tr><td><code>POST</code></td><td><code>/operations/{operationId}/retry</code></td><td>Route: <code>operationId</code>, optionale Abfrage <code>mode</code></td><td><code>operation retry</code></td></tr><tr><td><code>POST</code></td><td><code>/operations/{operationId}/reorder</code></td><td>Route: <code>operationId</code>, Abfrage <code>action</code></td><td><code>operation reorder</code></td></tr><tr><td><code>POST</code></td><td><code>/operations/{operationId}/forget</code></td><td>Route: <code>operationId</code></td><td><code>operation forget</code></td></tr></tbody></table>

### Paketmanager

<table><thead><tr><th width="250">METHODE</th><th>PFAD</th><th>PARAMETER</th><th>CLI-ÄQUIVALENT</th></tr></thead><tbody><tr><td><code>GET</code></td><td><code>/managers</code></td><td>Keine</td><td><code>manager list</code></td></tr><tr><td><code>GET</code></td><td><code>/managers/maintenance</code></td><td>Abfrage: <code>manager</code></td><td><code>manager maintenance</code></td></tr><tr><td><code>POST</code></td><td><code>/managers/maintenance/reload</code></td><td>Anforderungstext für die Managerwartung</td><td><code>manager reload</code></td></tr><tr><td><code>POST</code></td><td><code>/managers/maintenance/executable/set</code></td><td>Anforderungstext für die Managerwartung</td><td><code>manager set-executable</code></td></tr><tr><td><code>POST</code></td><td><code>/managers/maintenance/executable/clear</code></td><td>Anforderungstext für die Managerwartung</td><td><code>manager clear-executable</code></td></tr><tr><td><code>POST</code></td><td><code>/managers/maintenance/action</code></td><td>Anforderungstext für die Managerwartung</td><td><code>manager action</code></td></tr><tr><td><code>POST</code></td><td><code>/managers/set-enabled</code></td><td>Abfrage: <code>manager</code>, <code>enabled</code></td><td><code>manager enable</code>, <code>manager disable</code></td></tr><tr><td><code>POST</code></td><td><code>/managers/set-update-notifications</code></td><td>Abfrage: <code>manager</code>, <code>enabled</code></td><td><code>manager notifications enable</code>, <code>manager notifications disable</code></td></tr></tbody></table>

### Quellen

<table><thead><tr><th width="250">METHODE</th><th>PFAD</th><th>PARAMETER</th><th>CLI-ÄQUIVALENT</th></tr></thead><tbody><tr><td><code>GET</code></td><td><code>/sources</code></td><td>Optionale Abfrage: <code>manager</code></td><td><code>source list</code></td></tr><tr><td><code>POST</code></td><td><code>/sources/add</code></td><td>Abfrage: <code>manager</code>, <code>name</code>, optional <code>url</code></td><td><code>source add</code></td></tr><tr><td><code>POST</code></td><td><code>/sources/remove</code></td><td>Abfrage: <code>manager</code>, <code>name</code>, optional <code>url</code></td><td><code>source remove</code></td></tr></tbody></table>

### Einstellungen

<table><thead><tr><th width="250">METHODE</th><th>PFAD</th><th>PARAMETER</th><th>CLI-ÄQUIVALENT</th></tr></thead><tbody><tr><td><code>GET</code></td><td><code>/settings</code></td><td>Keine</td><td><code>settings list</code></td></tr><tr><td><code>GET</code></td><td><code>/settings/item</code></td><td>Abfrage: <code>key</code></td><td><code>settings get</code></td></tr><tr><td><code>POST</code></td><td><code>/settings/set</code></td><td>Abfrage: <code>key</code>, optional <code>enabled</code>, optional <code>value</code></td><td><code>settings set</code></td></tr><tr><td><code>POST</code></td><td><code>/settings/clear</code></td><td>Abfrage: <code>key</code></td><td><code>settings clear</code></td></tr><tr><td><code>POST</code></td><td><code>/settings/reset</code></td><td>Keine</td><td><code>settings reset</code></td></tr><tr><td><code>GET</code></td><td><code>/secure-settings</code></td><td>Optionale Abfrage: <code>user</code></td><td><code>settings secure list</code></td></tr><tr><td><code>GET</code></td><td><code>/secure-settings/item</code></td><td>Abfrage: <code>key</code>, optional <code>user</code></td><td><code>settings secure get</code></td></tr><tr><td><code>POST</code></td><td><code>/secure-settings/set</code></td><td>Abfrage: <code>key</code>, <code>enabled</code>, optional <code>user</code></td><td><code>settings secure set</code></td></tr></tbody></table>

### Verknüpfungen

Die Endpunkte für das Startmenü gibt es nur unter Windows. Die Regeln für Pfad und Paket sind in der CLI-Referenz unter [Startmenü-Verknüpfungen](/unigetui/de/referenz/cli.md#start-menu-shortcuts) und [Startmenü-Ordner](/unigetui/de/referenz/cli.md#start-menu-folders) beschrieben. Die Antwort von `/start-menu-folders/set` listet die passenden Verknüpfungen in `matchingShortcuts`.

<table><thead><tr><th width="250">METHODE</th><th>PFAD</th><th>PARAMETER</th><th>CLI-ÄQUIVALENT</th></tr></thead><tbody><tr><td><code>GET</code></td><td><code>/desktop-shortcuts</code></td><td>Keine</td><td><code>shortcut list</code></td></tr><tr><td><code>POST</code></td><td><code>/desktop-shortcuts/set</code></td><td>Abfrage: <code>path</code>, <code>status</code></td><td><code>shortcut set</code></td></tr><tr><td><code>POST</code></td><td><code>/desktop-shortcuts/reset</code></td><td>Abfrage: <code>path</code></td><td><code>shortcut reset</code></td></tr><tr><td><code>POST</code></td><td><code>/desktop-shortcuts/reset-all</code></td><td>Keine</td><td><code>shortcut reset-all</code></td></tr><tr><td><code>GET</code></td><td><code>/start-menu-shortcuts</code></td><td>Keine</td><td><code>start-menu shortcut list</code></td></tr><tr><td><code>POST</code></td><td><code>/start-menu-shortcuts/set</code></td><td>Abfrage: <code>path</code>, <code>status</code></td><td><code>start-menu shortcut set</code></td></tr><tr><td><code>POST</code></td><td><code>/start-menu-shortcuts/reset</code></td><td>Abfrage: <code>path</code></td><td><code>start-menu shortcut reset</code></td></tr><tr><td><code>POST</code></td><td><code>/start-menu-shortcuts/reset-all</code></td><td>Keine</td><td><code>start-menu shortcut reset-all</code></td></tr><tr><td><code>GET</code></td><td><code>/start-menu-folders</code></td><td>Keine</td><td><code>start-menu folder list</code></td></tr><tr><td><code>POST</code></td><td><code>/start-menu-folders/set</code></td><td>Abfrage: <code>package</code>, <code>folder</code>, optional <code>relocate-existing</code></td><td><code>start-menu folder set</code></td></tr><tr><td><code>POST</code></td><td><code>/start-menu-folders/remove</code></td><td>Abfrage: <code>package</code></td><td><code>start-menu folder remove</code></td></tr></tbody></table>

### Protokolle

<table><thead><tr><th width="250">METHODE</th><th>PFAD</th><th>PARAMETER</th><th>CLI-ÄQUIVALENT</th></tr></thead><tbody><tr><td><code>GET</code></td><td><code>/logs/app</code></td><td>Optionale Abfrage: <code>level</code></td><td><code>log app</code></td></tr><tr><td><code>GET</code></td><td><code>/logs/history</code></td><td>Keine</td><td><code>log operations</code></td></tr><tr><td><code>GET</code></td><td><code>/logs/manager</code></td><td>Optionale Abfrage: <code>manager</code>, <code>verbose</code></td><td><code>log manager</code></td></tr></tbody></table>

### Sicherungen

<table><thead><tr><th width="250">METHODE</th><th>PFAD</th><th>PARAMETER</th><th>CLI-ÄQUIVALENT</th></tr></thead><tbody><tr><td><code>GET</code></td><td><code>/backups/status</code></td><td>Keine</td><td><code>backup status</code></td></tr><tr><td><code>POST</code></td><td><code>/backups/local/create</code></td><td>Keine</td><td><code>backup local create</code></td></tr><tr><td><code>POST</code></td><td><code>/backups/github/sign-in/start</code></td><td>Anforderungstext für die GitHub-Anmeldung</td><td><code>backup github login start</code></td></tr><tr><td><code>POST</code></td><td><code>/backups/github/sign-in/complete</code></td><td>Keine</td><td><code>backup github login complete</code></td></tr><tr><td><code>POST</code></td><td><code>/backups/github/sign-out</code></td><td>Keine</td><td><code>backup github logout</code></td></tr><tr><td><code>GET</code></td><td><code>/backups/cloud</code></td><td>Keine</td><td><code>backup cloud list</code></td></tr><tr><td><code>POST</code></td><td><code>/backups/cloud/create</code></td><td>Keine</td><td><code>backup cloud create</code></td></tr><tr><td><code>POST</code></td><td><code>/backups/cloud/download</code></td><td>Anforderungstext für die Cloud-Sicherung</td><td><code>backup cloud download</code></td></tr><tr><td><code>POST</code></td><td><code>/backups/cloud/restore</code></td><td>Anforderungstext für die Cloud-Sicherung</td><td><code>backup cloud restore</code></td></tr></tbody></table>

### Bündel

<table><thead><tr><th width="250">METHODE</th><th>PFAD</th><th>PARAMETER</th><th>CLI-ÄQUIVALENT</th></tr></thead><tbody><tr><td><code>GET</code></td><td><code>/bundles</code></td><td>Keine</td><td><code>bundle get</code></td></tr><tr><td><code>POST</code></td><td><code>/bundles/reset</code></td><td>Keine</td><td><code>bundle reset</code></td></tr><tr><td><code>POST</code></td><td><code>/bundles/import</code></td><td>Anforderungstext für den Bündelimport</td><td><code>bundle import</code></td></tr><tr><td><code>POST</code></td><td><code>/bundles/export</code></td><td>Anforderungstext für den Bündelexport</td><td><code>bundle export</code></td></tr><tr><td><code>POST</code></td><td><code>/bundles/add</code></td><td>Anforderungstext für ein Paket des Bündels</td><td><code>bundle add</code></td></tr><tr><td><code>POST</code></td><td><code>/bundles/remove</code></td><td>Anforderungstext für ein Paket des Bündels</td><td><code>bundle remove</code></td></tr><tr><td><code>POST</code></td><td><code>/bundles/install</code></td><td>Anforderungstext für die Installation des Bündels</td><td><code>bundle install</code></td></tr></tbody></table>

### Pakete

<table><thead><tr><th width="250">METHODE</th><th>PFAD</th><th>PARAMETER</th><th>CLI-ÄQUIVALENT</th></tr></thead><tbody><tr><td><code>GET</code></td><td><code>/packages/search</code></td><td>Abfrage: <code>query</code>, optional <code>manager</code>, <code>maxResults</code></td><td><code>package search</code></td></tr><tr><td><code>GET</code></td><td><code>/packages/installed</code></td><td>Optionale Abfrage: <code>manager</code></td><td><code>package installed</code></td></tr><tr><td><code>GET</code></td><td><code>/packages/updates</code></td><td>Optionale Abfrage: <code>manager</code></td><td><code>package updates</code></td></tr><tr><td><code>GET</code></td><td><code>/packages/details</code></td><td>Abfrageparameter des Pakets</td><td><code>package details</code></td></tr><tr><td><code>GET</code></td><td><code>/packages/versions</code></td><td>Abfrageparameter des Pakets</td><td><code>package versions</code></td></tr><tr><td><code>GET</code></td><td><code>/packages/ignored</code></td><td>Keine</td><td><code>package ignored list</code></td></tr><tr><td><code>POST</code></td><td><code>/packages/ignore</code></td><td>Abfrageparameter des Pakets</td><td><code>package ignored add</code></td></tr><tr><td><code>POST</code></td><td><code>/packages/unignore</code></td><td>Abfrageparameter des Pakets</td><td><code>package ignored remove</code></td></tr><tr><td><code>POST</code></td><td><code>/packages/download</code></td><td>Abfrageparameter des Pakets</td><td><code>package download</code></td></tr><tr><td><code>POST</code></td><td><code>/packages/install</code></td><td>Abfrageparameter des Pakets</td><td><code>package install</code></td></tr><tr><td><code>POST</code></td><td><code>/packages/reinstall</code></td><td>Abfrageparameter des Pakets</td><td><code>package reinstall</code></td></tr><tr><td><code>POST</code></td><td><code>/packages/update</code></td><td>Abfrageparameter des Pakets</td><td><code>package update</code></td></tr><tr><td><code>POST</code></td><td><code>/packages/uninstall</code></td><td>Abfrageparameter des Pakets</td><td><code>package uninstall</code></td></tr><tr><td><code>POST</code></td><td><code>/packages/uninstall-then-reinstall</code></td><td>Abfrageparameter des Pakets</td><td><code>package repair</code></td></tr><tr><td><code>POST</code></td><td><code>/packages/show</code></td><td>Abfrage: <code>packageId</code>, <code>packageSource</code></td><td><code>package show</code></td></tr><tr><td><code>POST</code></td><td><code>/packages/update-all</code></td><td>Keine</td><td><code>package update-all</code></td></tr><tr><td><code>POST</code></td><td><code>/packages/update-manager</code></td><td>Abfrage: <code>manager</code></td><td><code>package update-manager</code></td></tr></tbody></table>

## Einschränkungen ohne Benutzeroberfläche

In einer Sitzung ohne Benutzeroberfläche geben diese Endpunkte HTTP `400` mit einer erläuternden Meldung zurück:

* `POST /uniget/v1/app/show` und `POST /uniget/v1/app/navigate`: Es gibt kein Fenster.
* `POST /uniget/v1/packages/update-all` und `POST /uniget/v1/packages/update-manager`: es sei denn, der Host stellt die Handler bereit, die diese Updates starten.

## Mit curl ausprobieren

Starten Sie eine Sitzung ohne Benutzeroberfläche im TCP-Modus:

```powershell
UniGetUI.exe --headless --ipc-api-transport tcp --ipc-api-port 7058
```

Fragen Sie anschließend den Statusendpunkt ab, für den kein Token nötig ist:

```powershell
curl http://localhost:7058/uniget/v1/status
```

Die anderen Endpunkte benötigen das Sitzungstoken im Abfrageparameter `token`. Die CLI übernimmt das für Sie.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.devolutions.net/unigetui/de/referenz/ipc-api.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.