# Zugriffsschlüssel (PAK)

Persönliche Zugriffsschlüssel (PAKs) ermöglichen den Zugriff auf die Polyteia-API, ohne Benutzername und Passwort zu verwenden. Sie eignen sich ideal für die Anbindung von Skripten, Tools oder externen Systemen. Jeder Schlüssel hat ein Ablaufdatum und ist nur einmal nach der Erstellung sichtbar.

### Anwendungsfälle

Verwenden Sie persönliche Zugriffsschlüssel, wenn Sie:

* Sicher aus externen Tools (z. B. Python, Postman) auf die API zugreifen möchten
* Aufgaben automatisieren wollen, ohne sich manuell anzumelden
* Polyteia-Daten in eigene Systeme integrieren möchten

{% hint style="info" %}
PAKs sind an Ihr Benutzerkonto gebunden und unterliegen Ihren Zugriffsrechten.
{% endhint %}

### PAK erstellen

1. Gehen Sie zu **Einstellungen** → **Persönliche Zugriffsschlüssel**
2. Klicken Sie auf **Persönlichen Zugriffsschlüssel (PAK) erstellen**
3. Im Dialog:
   * Geben Sie einen Namen ein (z. B. `Skriptzugriff`, `ETL-Pipeline`)
   * (Optional) Fügen Sie eine Beschreibung hinzu
   * Legen Sie die Gültigkeit in Tagen fest (z. B. `30`)
   * Klicken Sie auf **Speichern**
4. Ihr Schlüssel wird angezeigt. **Kopieren Sie ihn jetzt** – er wird später nicht mehr angezeigt
5. Klicken Sie auf **Speichern**, um abzuschließen

{% hint style="warning" %}
Kopieren Sie den Schlüssel unbedingt jetzt und bewahren Sie ihn sicher auf. Er kann später nicht erneut angezeigt werden. Wenn Sie ihn verlieren, müssen Sie einen neuen erstellen.
{% endhint %}

### Bestehende Schlüssel anzeigen

Alle aktiven PAKs erscheinen in der Liste mit:

* Name
* Beschreibung (falls angegeben)
* Erstellungsdatum
* Ablaufdatum
* Gültigkeitsbereich (derzeit immer `Alle`)

### PAK löschen

1. Suchen Sie den Schlüssel in der Liste
2. Klicken Sie auf das **🗑️**-Symbol rechts
3. Bestätigen Sie die Löschung im Pop-up

{% hint style="warning" %}
Ein gelöschter Schlüssel ist sofort ungültig für API-Zugriffe.
{% endhint %}

### Hinweise

* Sie können mehrere aktive Schlüssel gleichzeitig haben
* Schlüssel sind nur für die festgelegte Anzahl an Tagen gültig
* Bewahren Sie Ihre Schlüssel sicher auf – behandeln Sie sie wie ein Passwort
* Bei Verlust oder Kompromittierung löschen Sie den Schlüssel und erstellen einen neuen


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.polyteia.com/konto/zugriffsschlussel-pak.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.