Zum Inhalt springen

Agent-API für persönliche KI-Assistenten

Die Agentenoberfläche von Airtape, ohne Handbewegungen.

Nutze begrenzte persönliche Zugriffstokens, um dem Assistenten Zugriff auf konkrete Airtape-Aktionen zu geben: erstellen, planen, einladen und den Join-Link zurückgeben.

Airtape Skill öffnenKostenloses Konto erstellen

Erstelle nach der Anmeldung ein Token unter Einstellungen > Sicherheit

Anfrage201 Created
POST /api/agent/sessions
Authorization: Bearer atp_your_personal_token

{
  "title": "Founder interview",
  "scheduled_at": "2026-04-02T14:00:00Z",
  "participants": [
    { "email": "guest@example.com" }
  ]
}

Berechtigungen

Ein Token trägt nur die Scopes, die der Nutzer vergibt. Die Scopes werden in der Agent-Routen-Schicht erzwungen.

sessions:write

Sessions erstellen und Planungsdetails aktualisieren.

invites:write

Gäste hinzufügen und Airtape die Einladungsmails versenden lassen.

sessions:read

Session-Metadaten lesen und die Join-URL abrufen.

Endpunkte

Vier Aufrufe decken den kompletten Planungsablauf ab.

Session anlegen

/api/agent/sessionsPOST

Termin verschieben

/api/agent/sessions/:idPATCH

Gäste einladen

/api/agent/sessions/:id/inviteesPOST

Beitrittslink abrufen

/api/agent/sessions/:id/join-linkGET
Token-Leitplanken
Rohes Token nur einmal sichtbar
nach dem Anlegen
Auf dem Server gehasht
nie im Klartext gespeichert
Scopes pro Route erzwungen
Agent-Routen-Schicht

Leitplanken

  • Tokens werden von dir erstellt und können in den Airtape-Einstellungen widerrufen werden.
  • Rohe Token werden einmal nach der Erstellung angezeigt.
  • Der Serverspeicher speichert gehashte Tokenwerte, keinen Klartext.
  • Berechtigungen werden auf der Agent-Route durchgesetzt.

Bester Ausgangspunkt

Wenn du zuerst mit persönlichen Assistenten starten willst, beginne mit dem Airtape Skill und einem Token, das nur die wirklich nötigen Berechtigungen enthält.

Airtape Skill nutzenKI-Übersicht lesen