Tools de Notion
Las 13 operaciones de Notion que tu producto ejecuta en la cuenta de tu cliente con Connect. Todas usan el mismo endpoint, POST /api/tools/{tool}/execute.
- BuscarPOSTBusca por título las páginas y data sources compartidos con la conexión. Devuelve has_more y next_cursor para la página siguiente.
- Obtener páginaGETDevuelve las propiedades de una página. El contenido no está incluido: léelo con Obtener markdown de la página.
- Crear páginaPOSTCrea una página bajo una página o data source compartido con la conexión. Envía el contenido como Markdown en markdown, o como bloques en children, nunca ambos.
- Actualizar páginaPATCHActualiza las propiedades, el ícono o la portada de una página, o la mueve a la papelera y de vuelta con in_trash. Las propiedades omitidas conservan su valor.
- Obtener markdown de la páginaGETDevuelve el contenido de una página como Markdown en el campo markdown. En páginas muy grandes, truncated es true y unknown_block_ids lista las partes omitidas.
- Actualizar markdown de la páginaPATCHEdita el contenido de una página con Markdown: el tipo update_content aplica ediciones de búsqueda y reemplazo, y replace_content reescribe toda la página.
- Crear bloquesPATCHAgrega bloques de contenido a una página, o a un bloque que acepta hijos, al final salvo que position indique otra cosa. Hasta 100 bloques por llamada.
- Obtener databaseGETDevuelve un database con título, parent y data_sources, el id y el name de cada data source en él.
- Obtener data sourceGETDevuelve el schema de un data source: nombre, id, tipo y opciones de cada propiedad. Léelo antes de crear, actualizar o filtrar páginas en él.
- Listar páginas del data sourcePOSTLista las páginas de un data source, las filas de un database, con filtro y orden opcionales. Devuelve has_more y next_cursor para la página siguiente.
- Listar comentariosGETLista los comentarios no resueltos de una página o bloque, cada uno con su discussion_id. Devuelve has_more y next_cursor para la página siguiente.
- Crear comentarioPOSTComenta en una página o bloque, abriendo una nueva discusión, o responde a una discusión existente. Envía parent o discussion_id, no ambos.
- Listar usuariosGETLista los miembros y bots del workspace, sin invitados, con el id que aceptan las propiedades de persona y las menciones.
Mira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
