---
title: "API-Token als Administrator verwalten"
description: "Administratoren erstellen und widerrufen Talkspirit-API-Token in der Administration, wählen die Geltungsbereiche aus, die jeder Token trägt, und kopieren den Token-Wert einmalig"
category: integrations
section: api-and-webhooks
tags: [admin]
type: Tutorial
lastUpdated: 2026-11-13
locale: de
canonical: https://support.talkspirit.com/de/integrations/manage-api-tokens-as-an-admin
---

# API-Token als Administrator verwalten


Ein API-Token ermöglicht es einer Partnerintegration, die REST-API von Talkspirit im Namen eines Mitglieds Ihrer Organisation aufzurufen. Administratoren erstellen und widerrufen Token in der **Administration**, unter **Sicherheit** und dann **API**.

> **Zusammengefasst:** Öffnen Sie die **Administration**, dann **API**, klicken Sie auf **API-Token erstellen**, benennen Sie den Partner, wählen Sie das Mitglied, in dessen Namen der Token handelt, haken Sie die benötigten Geltungsbereiche an und kopieren Sie den Token. Er erscheint nur einmal und kann nicht erneut angezeigt werden.

Die Talkspirit-API ist eine Partnerschnittstelle, keine öffentliche API für allgemeine Zwecke. Jeder Token wird für einen benannten Partner ausgestellt, es gibt kein Entwicklerportal zur Selbstbedienung, und die Ressourcen, die ein Token erreicht, sind bewusst eng gefasst: Mitglieder, Kreise, Rollen, Spannungen, Meetings, Ziele, Projekte und Aufgaben.

## Bevor Sie beginnen

Sie benötigen drei Dinge.

- **Administratorrechte.** Talkspirit verweigert die Erstellung und den Widerruf von Token durch alle anderen.
- **Das API-Modul, für Ihre Organisation aktiviert.** Es ist standardmäßig deaktiviert. Ohne es erscheint **API** nicht im Administrationsmenü, und das Öffnen der Seite über ihre Adresse gibt eine Nicht-gefunden-Seite zurück. Bitten Sie Ihren Talkspirit-Ansprechpartner, es zu aktivieren.
- **Das Konto des Partners, bereits in Ihrer Organisation vorhanden.** Ein Token handelt im Namen eines Mitglieds, und Talkspirit richtet für jeden Partner ein eigenes Konto ein. Bitten Sie Ihren Talkspirit-Ansprechpartner, dieses Konto zu erstellen, bevor Sie einen Token dafür ausstellen.

## Einen API-Token erstellen

1. Gehen Sie in die **Administration**, dann **API** unter **Sicherheit**.
2. Klicken Sie auf **API-Token erstellen**.
3. Geben Sie den **Partnernamen** ein. Er identifiziert den Token in der Liste, benennen Sie daher den Partner statt des Verwendungszwecks.
4. Suchen Sie unter **Eigentümer** das Mitglied, in dessen Namen der Token handelt, und wählen Sie es aus. Der Token sieht genau das, was dieses Mitglied sieht, und nichts weiter.
5. Wählen Sie unter **Zugriff** einen Ausgangspunkt: **Nur Lesen** (beim Öffnen des Dialogs ausgewählt), **Lesen und Schreiben** oder **Benutzerdefiniert**. Die Matrix darunter listet pro Zeile eine Ressource auf, mit den Spalten **Lesen**, **Schreiben** und **Löschen**, und ihre Haken folgen dem Ausgangspunkt. Entfernen Sie die Haken bei allem, was die Integration nicht braucht, und setzen Sie die, die sie benötigt. Wer **Schreiben** anhakt, hakt auch **Lesen** derselben Ressource an, und jeder Haken, den Sie selbst ändern, stellt den Ausgangspunkt auf **Benutzerdefiniert**. Prüfen Sie die Matrix, bevor Sie fortfahren, denn sie enthält Schreibrechte und sie enthält **Tensions löschen**, was endgültig löscht. Mindestens ein Geltungsbereich ist erforderlich.
6. Klicken Sie auf **API-Token erstellen**.
7. Kopieren Sie den Token, speichern Sie ihn in Ihrem Passwortmanager und klicken Sie dann auf **Schließen**.

![Die Seite API in der Talkspirit-Administration. API ist im Bereich Sicherheit des Administrationsmenüs hervorgehoben, die Schaltfläche API-Token erstellen sitzt oben rechts, und die Seite zeigt „Noch keine API-Token".](/images/integrations/manage-api-tokens-as-an-admin/01-administration-api-page.png)

> **Warnung:** Der Token beginnt mit `ts_partner_` und wird nur einmal angezeigt, bei der Erstellung. Talkspirit bewahrt nur eine gehashte Kopie auf, sodass ihn niemand erneut anzeigen kann. Wenn Sie ihn verlieren, widerrufen Sie den Token und erstellen Sie einen neuen.

## Was jeder Geltungsbereich erlaubt

Geltungsbereiche legen fest, was der Token erreichen kann. Es gibt vierundzwanzig. Der Dialog zeigt sie als Matrix, eine Zeile pro Ressource, gruppiert nach dem Modul, aus dem die Ressource liest, denn ein Geltungsbereich wird nur angeboten, wenn dieses Modul in Ihrer Organisation aktiv ist. Vier sind ohne Modulbindung und immer verfügbar, unter **Administration**; die übrigen brauchen Struktur, Ziele, Projekte oder Meetings.

Die Ausgangspunkte haken diese Geltungsbereiche für Sie an. **Nur Lesen** hakt die Lesezugriffe an, die jedes Modul freigibt, und sonst nichts. Neun weiterreichende Lesezugriffe lässt es aus; sie verlangen einen bewusst gesetzten Haken: **Benutzer lesen**, **Arbeitsvereinbarungen lesen**, **Audit-Log lesen**, **Aktivitätsverlauf lesen** und die fünf Exporte (**Benutzerexport**, **Organisationsexport**, **Export der Checklisten und Kennzahlen**, **Export der Ziele** und **Export der Aufgaben und Projekte**). **Lesen und Schreiben** fügt Schreiben überall dort hinzu, wo Lesen angehakt ist (Kreise, Rollen, Tensions, Aufgaben und Meetings), und löscht nie. **Benutzerdefiniert** ist, was Sie selbst anhaken.

Die Namen der Geltungsbereiche folgen dem Vokabular Ihrer Organisation: wenn Sie Kreise oder Rollen unter **Terminologie** umbenannt haben, verwenden die Kontrollkästchen Ihre Begriffe.

| Gruppe | Geltungsbereich | Was ein Token damit tun kann |
| --- | --- | --- |
| Immer angeboten | **Benutzer lesen** (`users:read`) | Mitglieder und ihre Mitgliedschaften lesen |
| Immer angeboten | **Benutzer schreiben** (`users:write`) | Mitglieder bearbeiten und ihre benutzerdefinierten Felder setzen |
| Immer angeboten | **Audit-Log lesen** (`audit_log:read`) | Das Aktivitätsprotokoll der Organisation lesen. Der Eigentümer des Tokens muss außerdem Administrator sein, sonst verweigert die Route den Aufruf |
| Immer angeboten | **Benutzerexport** (`user_export:read`) | Einen Export aller Mitglieder starten und seine Datei herunterladen: eine CSV-Datei, eine Zeile pro Mitglied, mit Name, E-Mail-Adresse, Rolle, Status, Profilfeldern und letzter Anmeldung. Es ist die Zeile **Benutzerexport** der Matrix, in der Spalte **Lesen**. Der Eigentümer des Tokens muss Administrator der Organisation sein, sonst verweigert die Route den Aufruf |
| Struktur | **Kreise lesen** (`circles:read`) | Kreise und ihre Mitglieder lesen |
| Struktur | **Kreise schreiben** (`circles:write`) | Benutzerdefinierte Felder eines Kreises setzen |
| Struktur | **Rollen lesen** (`roles:read`) | Rollen und ihre Mitglieder lesen |
| Struktur | **Rollen schreiben** (`roles:write`) | Benutzerdefinierte Felder einer Rolle setzen |
| Struktur | **Tensions lesen** (`tensions:read`) | Tensions lesen |
| Struktur | **Tensions schreiben** (`tensions:write`) | Tensions erstellen, bearbeiten und ihren Status ändern |
| Struktur | **Tensions im Namen eines Mitglieds schreiben** (`tensions:write_on_behalf`) | Beim Erstellen einer Tension ein Mitglied als Ersteller angeben, sodass die Tension seine ist. Sie hat eine eigene Zeile in der Matrix, und **Tensions schreiben** schließt sie nicht ein |
| Struktur | **Tensions löschen** (`tensions:delete`) | **Tensions endgültig löschen.** Siehe Warnung unten |
| Struktur | **Arbeitsvereinbarungen lesen** (`documents:read`) | Arbeitsvereinbarungen, ihren Text und ihre Kommentare lesen |
| Struktur | **Organisationsexport** (`structure_export:read`) | Einen Export der Organisation starten und seine Datei herunterladen: die Kreise, die Rollen und wer was innehat, mit der E-Mail-Adresse jedes Inhabers, als Excel-Arbeitsmappe oder CSV-Dateien. Es ist die Zeile **Organisationsexport** der Matrix, in der Spalte **Lesen**, mit dem Hinweis „Erfordert, dass das Konto des Schlüssels Administrator ist“: Der Eigentümer des Tokens muss Administrator der Organisation sein, sonst verweigert die Route den Aufruf |
| Struktur | **Export der Checklisten und Kennzahlen** (`checklist_metric_export:read`) | Einen Export der Checklisten und Kennzahlen der Organisation starten und seine Excel-Arbeitsmappe herunterladen: jeder Eintrag mit seinem Kreis oder seiner Rolle, Status, Wiederholung, letzter Prüfung und Zuständigen. Der Eigentümer des Tokens muss Administrator der Organisation sein, sonst verweigert die Route den Aufruf |
| Struktur | **Aktivitätsverlauf lesen** (`activity:read`) | Lesen, wer auf eine Rolle gesetzt oder von ihr entfernt, einem Kreis hinzugefügt oder aus ihm entfernt wurde, wer die Änderung vorgenommen hat und wann. Er ist ausgeschaltet, solange Sie ihn nicht anhaken, und der Ausgangspunkt **Nur Lesen** lässt ihn aus. Eine Administratorrolle ist nicht nötig: Der Token sieht, was sein Eigentümer sieht. Nicht zu verwechseln mit dem Aktivitätsprotokoll, das **Audit-Log lesen** öffnet |
| Ziele | **Ziele lesen** (`goals:read`) | Ziele, ihre Key Results, ihre Kommentare und Zeiträume lesen |
| Ziele | **Export der Ziele** (`goal_export:read`) | Einen Export der Ziele und ihrer Key Results starten und seine Excel-Arbeitsmappe herunterladen, mit einem Blatt Ziele und einem Blatt Key Results. Private Ziele sind nur enthalten, solange die Administrator-Aufsicht Ihrer Organisation aktiv ist. Der Eigentümer des Tokens muss Administrator der Organisation sein, sonst verweigert die Route den Aufruf |
| Projekte | **Projekte lesen** (`projects:read`) | Projekte samt Kommentaren, Abschnitten und Labels lesen |
| Projekte | **Aufgaben lesen** (`tasks:read`) | Die für den Eigentümer sichtbaren Aufgaben und ihre Kommentare lesen |
| Projekte | **Aufgaben schreiben** (`tasks:write`) | Aufgaben erstellen, im Namen des Eigentümers |
| Projekte | **Export der Aufgaben und Projekte** (`task_export:read`) | Einen Export der Aufgaben und Projekte starten und seine Excel-Arbeitsmappe herunterladen, mit einem Blatt Aufgaben und einem Blatt Projekte. Private Projekte und ihre Aufgaben sind nur enthalten, solange die Administrator-Aufsicht Ihrer Organisation aktiv ist. Der Eigentümer des Tokens muss Administrator der Organisation sein, sonst verweigert die Route den Aufruf |
| Meetings | **Meetings lesen** (`meetings:read`) | Die für den Eigentümer sichtbaren Meetings lesen |
| Meetings | **Meetings schreiben** (`meetings:write`) | Einen Punkt zur Tagesordnung eines für den Eigentümer sichtbaren Meetings hinzufügen. Erteilen Sie ihn zusammen mit **Meetings lesen**, damit die Integration prüfen kann, was sie geschrieben hat |

Sechzehn der vierundzwanzig Geltungsbereiche lesen nur. Die anderen acht verändern die Daten Ihrer Organisation: erteilen Sie sie nur einer Integration, die schreiben muss, und schützen Sie einen solchen Token so sorgfältig wie ein Passwort.

> **Warnung:** **Tensions löschen** ist destruktiv und nicht rückholbar. Ein Token damit löscht Tensions endgültig, ohne Wiederherstellung. Er ist bewusst von **Tensions schreiben** getrennt, der ihn nicht einschließt: erteilen Sie ihn also nur, wenn eine Integration wirklich hinter sich aufräumen muss. Er erreicht nur die Tensions, die das Konto des Tokens selbst erstellt hat.

Was auch immer Sie anhaken, ein Token erreicht nie mehr als sein Eigentümer. Wenn ein Partner jedes Mitglied der Organisation lesen muss, benötigt das Eigentümerkonto zuerst diese Sichtbarkeit.

## Einen API-Token widerrufen

1. Öffnen Sie auf der Seite **API** das Aktionsmenü am Ende der Zeile des Tokens.
2. Klicken Sie auf **Widerrufen**.
3. Bestätigen Sie mit **Widerrufen**.

Der Widerruf tritt sofort in Kraft und kann nicht rückgängig gemacht werden. Der Token bleibt mit dem Status **Widerrufen** in der Liste, sodass Sie die Aufzeichnung darüber behalten, was existiert hat. Token haben kein Ablaufdatum: Ein Token funktioniert, bis Sie ihn widerrufen, oder bis das API-Modul für Ihre Organisation deaktiviert wird, was alle Token gleichzeitig stoppt.

## Nächste Schritte

- [Talkspirit-API-Dokumentation](/de/integrations/partner-api)
- [Eine Integration aktivieren oder deaktivieren](/de/integrations/enable-a-cloud-file-picker)
