Agent API para asistentes de IA personales

La superficie de agente de Airtape, sin rodeos.

Usa tokens personales de acceso con alcance limitado para dar al asistente de un usuario acceso a las operaciones concretas de Airtape que importan: crear, programar, invitar y devolver el enlace de acceso.

Abrir Airtape Skill Crea tu cuenta gratuita

Después de registrarte, crea un token en Ajustes > Seguridad

Petición201 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]" }
  ]
}

Alcances

Un token solo lleva los permisos que el usuario concede. Los permisos se aplican en la capa de rutas del agente.

sessions:write

Crear sesiones y actualizar los detalles de programación.

invites:write

Añadir invitados y dejar que Airtape envíe el correo de invitación.

sessions:read

Leer los metadatos de la sesión y obtener la URL de acceso.

Endpoints

Cuatro llamadas cubren todo el flujo de programación.

Crear una sesión

/api/agent/sessionsPOST

Actualizar la programación

/api/agent/sessions/:idPATCH

Añadir invitados

/api/agent/sessions/:id/inviteesPOST

Obtener el enlace de acceso

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

Protecciones del token

Token en claro, mostrado una vez

tras la creación

Con hash en el servidor

nunca se guarda en claro

Permisos aplicados por ruta

capa de rutas del agente

Salvaguardas

Los tokens los crea el usuario y se pueden revocar en los ajustes de Airtape.
El token sin cifrar se muestra una sola vez tras crearlo.
El servidor guarda los valores de los tokens con hash, no en texto plano.
Los alcances se aplican en la capa de rutas del agente.

Mejor punto de partida

Si el objetivo son primero los agentes personales, empieza por la página de la skill de Airtape y un token que solo lleve los alcances que el usuario necesita de verdad.

Usar Airtape Skill Leer la introducción sobre IA