Aller au contenu

API Agent pour assistants IA personnels

La surface d’agent d’Airtape, sans approximation.

Utilisez des jetons d’accès personnel à portée limitée pour donner à l’assistant d’un utilisateur accès aux opérations Airtape concrètes qui comptent : créer, planifier, inviter et renvoyer le lien de participation.

Ouvrir le Skill AirtapeCréer votre compte gratuit

Après l’inscription, créez un jeton dans Paramètres > Sécurité

Requête201 Created
POST /api/agent/sessions
Authorization: Bearer atp_your_personal_token

{
  "title": "Founder interview",
  "scheduled_at": "2026-04-02T14:00:00Z",
  "participants": [
    { "email": "[email protected]" }
  ]
}

Portées

Un jeton ne porte que les portées accordées par l’utilisateur. Les portées sont appliquées au niveau de la couche de routes de l’agent.

sessions:write

Créer des sessions et mettre à jour les détails de planification.

invites:write

Ajouter des invités et laisser Airtape envoyer les e-mails d’invitation.

sessions:read

Lire les métadonnées d’une session et récupérer l’URL de participation.

Points de terminaison

Quatre appels couvrent tout le parcours de planification.

Créer une session

/api/agent/sessionsPOST

Mettre à jour la planification

/api/agent/sessions/:idPATCH

Ajouter des invités

/api/agent/sessions/:id/inviteesPOST

Récupérer le lien de participation

/api/agent/sessions/:id/join-linkGET
Garde-fous des jetons
Jeton brut affiché une seule fois
après la création
Haché sur le serveur
jamais stocké en clair
Portées appliquées par route
couche de routes de l’agent

Garde-fous

  • Les jetons sont créés par l’utilisateur et révocables dans les paramètres Airtape.
  • Les jetons bruts ne sont affichés qu’une fois après leur création.
  • Le stockage serveur conserve des valeurs de jetons hachées, jamais en clair.
  • Les portées sont appliquées au niveau de la couche de routage de l’agent.

Meilleur point de départ

Si l’objectif est d’abord de connecter des agents personnels, commencez par la page du skill Airtape et un jeton ne portant que les portées dont l’utilisateur a réellement besoin.

Utiliser le Skill AirtapeLire la présentation de l’IA