Productividad
Superhuman Docs en tu producto y en tus agentes de IA, con una API
El toolkit cubre docs, páginas, tablas, columnas y filas: lista y crea docs, lee y escribe el contenido de las páginas, y lee, inserta, actualiza y elimina filas de tablas. Tu producto o agente de IA los llama por Connect, que guarda la API key y registra cada ejecución.
15 días de prueba. Sin tarjeta de crédito.
POST https://connect.reportei.com/api/tools/coda_create_doc/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"title": "<title>"
}
}Cómo funciona
Del cliente conectado a la primera llamada a Superhuman Docs.
- 1
Tu cliente conecta la cuenta
Tu sistema abre una sesión de Connect para el toolkit y tu cliente conecta su cuenta de Superhuman Docs. Recibes el id de la conexión.
- 2
Tu producto llama a la tool
Un POST a /api/tools/{tool}/execute con el id de la conexión y los argumentos. Si la llamada tiene éxito, Connect conserva el status y el cuerpo de la respuesta de la app.
- 3
Connect se encarga del resto
Guarda la credencial cifrada, renueva tokens en conexiones OAuth que admiten renovación y registra las ejecuciones en un historial de auditoría disponible por API.
Casos de uso
Qué hace tu producto con Superhuman Docs.
Un doc como base de datos
Un SaaS escribe filas en una tabla del doc del cliente con Crear filas y las actualiza después, cruzando por columnas clave.
Páginas generadas desde tus datos
Una herramienta de agencia crea una página con contenido en Markdown en un doc y luego la edita o agrega contenido a medida que cambian los datos.
Agente que lee los docs del equipo
Un agente de IA lista docs y páginas, lee el contenido de una página como texto y consulta filas de tablas para responder preguntas.
Tools
12 tools de Superhuman Docs
- Listar docsGETLista los docs a los que el usuario puede acceder y que abrió al menos una vez, del más reciente al más antiguo, con id, name, owner, workspace y browserLink. Envía nextPageToken como pageToken para la página siguiente.
- Crear docPOSTCrea un doc, vacío o como copia de otro, en la carpeta My docs del workspace más antiguo del usuario. Exige el rol Doc Maker en el workspace.
- Listar páginasGETLista las páginas de un doc con id, name, subtitle, parent y children. Envía nextPageToken como pageToken para la página siguiente.
- Listar contenido de la páginaGETDevuelve el contenido de una página como texto plano, elemento por elemento. Envía nextPageToken como pageToken para la parte siguiente.
- Crear páginaPOSTCrea una página en un doc, o una subpágina, con contenido en Markdown o HTML. El cambio entra en cola y aparece en unos segundos; la respuesta trae el id de la página.
- Actualizar páginaPUTRenombra una página o le agrega contenido, al final, al inicio o reemplazando todo. El cambio entra en cola y aparece en unos segundos.
- Listar tablasGETLista las tablas y vistas de un doc con id, name, type y la página padre. Las filas solo se escriben en tablas, no en vistas.
- Listar columnasGETLista las columnas de una tabla con id, name y format. Los ids de las columnas van en las cells de Crear filas y Actualizar fila y en la query de Listar filas.
- Listar filasGETLista las filas de una tabla o vista, de la más antigua a la más reciente salvo que sortBy indique otra cosa, con id, name y los valores indexados por el id de la columna. Los datos pueden tardar unos segundos.
- Crear filasPOSTInserta filas en una tabla, o actualiza las que coinciden con keyColumns. Toda fila coincidente se actualiza. Solo las tablas base aceptan filas, no las vistas; el cambio entra en cola.
Clave de API
Tu cliente pega la clave de la app en una pantalla de Connect, o tu sistema envía la clave con POST /api/customer-toolkits, sin pantalla.
Preguntas sobre el toolkit de Superhuman Docs
¿Necesito implementar la API de Superhuman Docs?
No. Connect ya trae 12 tools de Superhuman Docs descritas y listas. Tu cliente conecta la cuenta y tu sistema llama a cada tool por el mismo endpoint, con el mismo formato de solicitud.
¿Cómo conecta mi cliente su cuenta de Superhuman Docs?
Con el modo que acepta el toolkit: Clave de API. Connect guarda la credencial cifrada y nunca la devuelve a tu sistema.
¿Funciona con agentes de IA?
Sí. El input de cada tool está descrito en JSON Schema, que tu agente usa directamente como definición de tool. El agente elige la tool y los argumentos, y tu sistema hace la llamada a Connect.
¿Mi cliente necesita una cuenta en Reportei?
No. Tu cliente conecta la cuenta en una pantalla de Connect, o tu sistema envía la credencial por la API, y sigue usando solo tu producto.
Toolkits de la misma categoría
Ver los 100 toolkitsMira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
