Entwickler

Die Agent-Schnittstelle von Airtape, ohne Blabla.

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

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

Erstelle nach der Anmeldung ein Token unter Einstellungen > Sicherheit

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 erstellen und Planungsdetails aktualisieren.

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

Session-Metadaten lesen und die Join-URL abrufen.

Endpunkte

Vier Aufrufe decken den kompletten Planungsablauf ab.

Session anlegen

/api/agent/sessions

POST

Termin verschieben

/api/agent/sessions/:id

PATCH

Gäste einladen

/api/agent/sessions/:id/invitees

POST

Beitrittslink abrufen

/api/agent/sessions/:id/join-link

GET

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.