API para desarrolladores
Automatiza Papyro desde tus propios sistemas
Una API REST versionada con una especificación OpenAPI 3.1, claves de API con ámbitos e idempotencia — además de un servidor MCP para que los asistentes de IA trabajen dentro de tu espacio de trabajo.
API REST versionada
Una superficie estable /api/v1 para tableros, listas, tarjetas (con comentarios), notas, espacios, clientes y tickets de helpdesk y los propios informes de tus usuarios finales — documentada por una especificación OpenAPI 3.1 escrita a mano que sirve tu propia instancia.
Servidor MCP para asistentes de IA
Cualquier cliente MCP puede leer y escribir tus tableros y notas a través de 12 herramientas — listar, crear y actualizar tarjetas (mover, asignar, etiquetar), crear listas, leer y escribir notas, y clasificar huellas de error. Autentícate con OAuth 2.1 (tu instalación es su propio servidor de autorización) o con una clave papyro_ con ámbito limitado. Cada llamada queda auditada, y un único interruptor de administrador corta el acceso a todos los clientes.
Claves de API con ámbitos
Emite claves papyro_ desde Ajustes, envíalas como un token Bearer o una cabecera x-api-key, y otorga solo los ámbitos que cada integración necesita.
Ingesta de errores en los tableros
Apunta tus servicios a /api/v1/boards/{id}/fingerprints y Papyro agrupa los eventos, registra la primera y última aparición, dispara tu webhook y puede escribir un análisis de causa raíz en la tarjeta. Tu propio monitoreo de errores, en tu propio servidor.
Idempotencia y paginación
La paginación por cursor y las claves de idempotencia hacen que las solicitudes masivas y reintentadas sean seguras y predecibles.
Límites de tasa que puedes ver
Cada respuesta incluye cabeceras de límite de tasa, para que tu cliente siempre sepa en qué punto está.
La referencia completa e interactiva de la API se incluye dentro de cada instancia de Papyro en /api/v1/docs, con la especificación en bruto en /api/v1/openapi.json. El endpoint MCP vive en /api/mcp y se anuncia a través de los documentos estándar de descubrimiento de OAuth.