{ "info": { "name": "API do Dashboard Mágico (v1.0.0)", "description": "¡Tú que eres dev, diviértete! ✨\n\n> **Índice de la documentación** — accede al índice completo en [https://docs.dashboards.kobana.com.br/llms.txt](https://docs.dashboards.kobana.com.br/llms.txt). Usa este archivo para descubrir todas las páginas disponibles antes de explorar.\n\n> **Atención a las versiones de la API** — estás en la documentación de la **v1.0** de la API de Dashboard Mágico, que cubre el portal (constructor, páginas, marca, acceso y dominios), los usuarios del portal, conectores, entidades, archivos, webhooks y el equipo de la organización. Recursos como **Pagos, Transferencias, Extracto y Recepción por Pix** están disponibles en otras APIs de Kobana — usa el selector de producto en el menú superior para acceder.\n\n## Autenticación\n\nToda solicitud lleva el token, que dice qué **organización** eres. Cuando la organización tiene más de un **workspace**, lleva también el encabezado `X-Workspace-Id`, que dice en cuál de ellos actuar.\n\n```\nAuthorization: Bearer \nX-Workspace-Id: \n```\n\n### El token\n\nAccess token de la **Cuenta Kobana**: un JWT firmado en **RS256** por el servidor de autorización de Kobana (`account.kobana.com.br`). Esta API solo lo verifica — no emite ningún token.\n\n| Claim | Rol |\n| :--- | :--- |\n| **`org`** | **El tenant.** La cuenta Kobana en cuyo nombre actúa el token — es lo que decide a qué datos llega el token. Obligatoria. |\n| `sub` | La **persona** que autorizó. Existe para auditoría y **no** delimita nada. |\n| `scope` | Lista separada por espacios (ej.: `dashboards/users write`). Un recurso sin verbo es lectura; escribir exige también `write`. |\n| `jti` | Identificador del token, usado para revocación. |\n| `iss` / `aud` / `exp` | Emisor, destinatario y expiración (obligatoria). |\n\n⚠️ El tenant es `org`, nunca `sub`. Son espacios de identificadores distintos: un id de persona jamás corresponde a una organización, así que un token sin `org` se rechaza.\n\n### El encabezado `X-Workspace-Id`\n\nUna organización puede tener **varios workspaces**, y toda ruta de esta API responde por exactamente **uno**. Mientras la organización tiene un único workspace, el encabezado puede omitirse; a partir del segundo, es obligatorio. Acepta el `id` o el `public_id` del workspace, ambos en la página **Workspaces** del dashboard.\n\nEs un **selector, nunca un permiso**: el workspace enviado se compara con la organización del token, y un token emitido para una persona solo llega a los workspaces a los que ella tiene acceso.\n\n| Situación | Respuesta |\n| :--- | :--- |\n| Encabezado ausente con más de un workspace | `400` `workspace_required` |\n| Workspace de otra organización, inexistente, o id mal formado | `403` `unknown_workspace` |\n| La persona del token no tiene acceso al workspace | `403` `workspace_access_denied` |\n| `org` no corresponde a ninguna organización | `403` `unknown_organization` |\n| Alcance insuficiente para la operación | `403` `insufficient_scope` |\n\n### Ejemplo\n\n```bash\ncurl https://api.dashboards.kobana.com.br/v1/portal_users \\\n -H \"Authorization: Bearer $KOBANA_TOKEN\" \\\n -H \"X-Workspace-Id: $KOBANA_WORKSPACE_ID\"\n```\n\nPara pruebas en línea de comandos, exporta los dos: `export KOBANA_TOKEN=xxxxxxxx` y `export KOBANA_WORKSPACE_ID=xxxxxxxx`, y pega los comandos de la documentación en la terminal.\n\n## Formato\n\nLa API solo acepta `JSON`. Todas las solicitudes deben usar `Content-Type: application/json`. Todas las respuestas usan `snake_case`.\n\n| Tipo de Campo | Formato |\n| :--- | :--- |\n| **DateTime** | Formato [ISO8601](https://es.wikipedia.org/wiki/ISO_8601). Ejemplos — Fecha: `2026-01-24`. Fecha y hora: `2026-01-24T10:07Z` |\n| **UUID** | Identificadores de recursos en formato UUID v4 |\n\n## Convenciones\n\nConvenciones usadas en esta documentación:\n\n| Convención | Descripción |\n| :--- | :--- |\n| **`:variable`** | Nombre de variable que debe sustituirse en una URL. |\n| **`#{variable}`** | Nombre de variable que debe sustituirse por valores de tu cuenta. |\n| **`...`** | Contenido de la respuesta truncado para facilitar la lectura. |\n| **`$KOBANA_TOKEN`** | Token de acceso. Para pruebas en línea de comandos, expórtalo: `export KOBANA_TOKEN=xxxxxxxxxxxxxxxxxxxxxxxx` y pega los comandos de la documentación en la terminal. |\n\n## Ambientes\n\n| Ambiente | Base URL |\n| :--- | :--- |\n| **Producción** | `https://api.dashboards.kobana.com.br` |\n| **Sandbox** | `https://api.dashboards.sandbox.kobana.com.br` |\n\nCada ambiente exige su propio token — el de uno no sirve en el otro.\n\n## Listado y Paginación\n\nTodos los endpoints de listado usan **paginación por número de página**:\n\n```\nGET /v1/portal_users?page=2&per_page=50&sort_by=created_at&sort_order=desc\n```\n\n`per_page` llega hasta **100** (por defecto `20`). La respuesta trae los ítems en `data` y, en `meta`, `total`, `page`, `per_page` y `total_pages`.\n\n## Idempotencia\n\nLas solicitudes `POST`, `PUT` y `PATCH` aceptan el encabezado `X-Idempotency-Key`. Los reenvíos con la misma clave dentro de **24h** devuelven el resultado original sin repetir la operación — seguro para reintentar ante una falla de red.\n\n```\nX-Idempotency-Key: \n```\n\n## Códigos de Retorno\n\nLa API devuelve códigos HTTP estándar:\n\n| | Código | Descripción |\n| :--- | :--- | :--- |\n| ✅ | **200 OK** | Solicitud exitosa con cuerpo de respuesta. |\n| ✅ | **201 Created** | Recurso creado con éxito. |\n| ✅ | **204 No Content** | Solicitud exitosa sin cuerpo de respuesta. |\n| ❌ | **400 Bad Request** | Solicitud inválida, generalmente contenido mal formado. |\n| ❌ | **401 Unauthorized** | Token de acceso ausente o inválido. |\n| ❌ | **403 Forbidden** | Acceso a la API bloqueado o usuario sin permiso. |\n| ❌ | **404 Not Found** | El recurso no existe. |\n| ❌ | **422 Unprocessable Entity** | Solicitud válida, pero los datos enviados no lo son. |\n| ❌ | **429 Too Many Requests** | Límite de solicitudes alcanzado. |\n| ❌ | **500 Internal Server Error** | Error interno de procesamiento. Consulta el [estado de los servidores](https://status.kobana.com.br). |\n\n## ID de las Solicitudes (Request ID)\n\nCada solicitud tiene un identificador asociado, disponible en la cabecera `Request-Id` de la respuesta. Este valor ayuda en la depuración y auditoría — las solicitudes y sus IDs pueden consultarse en el panel del sistema. El registro de solicitudes está disponible por **30 días**. Al abrir un ticket de soporte sobre una solicitud específica, informa el `Request-Id` para acelerar la investigación.\n\n## Seguridad\n\nLa API de Kobana usa certificados **SSL 2048 bits**. Toda solicitud debe hacerse vía **HTTPS** — las llamadas al puerto 80 son redirigidas al 443.\n\nLos clientes deben soportar `TLSv1.2` o `TLSv1.3` con una de las cifras: `TLS_AES_128_GCM_SHA256`, `TLS_AES_256_GCM_SHA384`, `TLS_CHACHA20_POLY1305_SHA256`, `ECDHE-RSA-AES128-GCM-SHA256`, `ECDHE-RSA-AES128-SHA256`, `ECDHE-RSA-AES256-GCM-SHA384`, `ECDHE-RSA-CHACHA20-POLY1305`, `ECDHE-RSA-AES256-SHA384`. `TLSv1` y `TLSv1.1` no son soportados.\n\n## Caché HTTP\n\nUsa las cabeceras HTTP de caché para reducir carga y ganar velocidad. La mayoría de las respuestas incluye `ETag` y/o `Last-Modified` — guarda estos valores y reenvíalos en las siguientes solicitudes vía `If-None-Match` e `If-Modified-Since`. Si el recurso no cambió, la respuesta será `304 Not Modified`, sin cuerpo y sin reprocesamiento. Más información: [HTTP Cache Docs](http://www.mnot.net/cache_docs/).\n\n## Manejo de Errores\n\nLos errores 5xx indican fallas del servidor: **500 Internal Server Error** (aplicación indisponible), **502 Bad Gateway**, **503 Service Unavailable** y **504 Gateway Timeout** (fallas puntuales de infraestructura). Tu aplicación debe identificar estos códigos y reintentar la solicitud después de algunos minutos con backoff. Estado de los servidores: [https://status.kobana.com.br](https://status.kobana.com.br).\n\n## Spec OpenAPI\n\nImporta la spec en Postman o Insomnia para tener una colección lista que siempre refleja la API actual:\n\n- **YAML:** `https://api.dashboards.kobana.com.br/v1/openapi.yaml`\n- **JSON:** `https://api.dashboards.kobana.com.br/v1/openapi.json`", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json" }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}", "type": "string" } ] }, "variable": [ { "key": "baseUrl", "value": "https://api.dashboards.kobana.com.br", "type": "string", "description": "https://api.dashboards.kobana.com.br — Producción. Sustituido en tiempo de ejecución cuando `API_V1_PUBLIC_URL` está definido.\nhttps://api.dashboards.sandbox.kobana.com.br — Sandbox — entorno de pruebas aislado de producción." }, { "key": "bearerToken", "value": "", "type": "string", "description": "Access token da Conta Kobana (JWT RS256) usado no header Authorization: Bearer." } ], "item": [ { "name": "Organización", "item": [ { "name": "Obtener organización actual", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/organization", "host": [ "{{baseUrl}}" ], "path": [ "v1", "organization" ] }, "description": "Devuelve los datos de la organización a la que pertenece el token autenticado. No hay parámetro `:id` — la organización siempre se resuelve a partir de la clave de la API." }, "response": [] }, { "name": "Actualizar organización actual", "request": { "method": "PATCH", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/organization", "host": [ "{{baseUrl}}" ], "path": [ "v1", "organization" ] }, "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"email\": \"user@example.com\",\n \"phone\": \"\",\n \"addresses\": [\n {}\n ],\n \"custom_metadata\": {}\n}", "options": { "raw": { "language": "json" } } }, "description": "Actualiza el perfil de la organización autenticada. Solo los campos a continuación pueden modificarse — la identidad (`id`, `external_id`, `status`) no es modificable por este endpoint." }, "response": [] }, { "name": "Identidad del token actual", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/me", "host": [ "{{baseUrl}}" ], "path": [ "v1", "me" ] }, "description": "Devuelve quién está detrás del token Bearer: la persona (`user`, `null` para un token de máquina), la organización y los scopes, el nivel de acceso y la expiración del propio token. Sirve para validar la credencial configurada en una integración. Nunca devuelve el token, hashes ni claves." }, "response": [] } ] }, { "name": "Usuarios del Portal", "item": [ { "name": "Listar usuarios del portal", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/portal_users?page=1&per_page=20&sort_by=&sort_order=asc&tenant_id=&status=active&email=&external_id=&sso_only=true&created_after=&created_before=&last_login_after=&last_login_before=&person_id=00000000-0000-0000-0000-000000000000&person_document_number=&person_name_contains=", "host": [ "{{baseUrl}}" ], "path": [ "v1", "portal_users" ], "query": [ { "key": "page", "value": "1", "disabled": true }, { "key": "per_page", "value": "20", "disabled": true }, { "key": "sort_by", "value": "", "disabled": true }, { "key": "sort_order", "value": "asc", "disabled": true }, { "key": "tenant_id", "value": "", "disabled": true }, { "key": "status", "value": "active", "disabled": true }, { "key": "email", "value": "", "disabled": true }, { "key": "external_id", "value": "", "disabled": true }, { "key": "sso_only", "value": "true", "disabled": true }, { "key": "created_after", "value": "", "disabled": true }, { "key": "created_before", "value": "", "disabled": true }, { "key": "last_login_after", "value": "", "disabled": true }, { "key": "last_login_before", "value": "", "disabled": true }, { "key": "person_id", "value": "00000000-0000-0000-0000-000000000000", "disabled": true }, { "key": "person_document_number", "value": "", "disabled": true }, { "key": "person_name_contains", "value": "", "disabled": true } ] }, "description": "Devuelve los usuarios del portal del workspace, con paginación. Los campos sensibles (contraseña, tokens) nunca se exponen." }, "response": [] }, { "name": "Crear (invitar) usuario del portal", "request": { "method": "POST", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/portal_users", "host": [ "{{baseUrl}}" ], "path": [ "v1", "portal_users" ] }, "body": { "mode": "raw", "raw": "{\n \"email\": \"\",\n \"tenant_id\": \"\",\n \"external_id\": \"\",\n \"sso_only\": false,\n \"custom_metadata\": {}\n}", "options": { "raw": { "language": "json" } } }, "description": "Crea el usuario en el workspace con estado `pending_invitation` y envía el correo de invitación. La invitación expira en 7 días." }, "response": [] }, { "name": "Invitar usuario del portal (verbo)", "request": { "method": "POST", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/portal_users/invite", "host": [ "{{baseUrl}}" ], "path": [ "v1", "portal_users", "invite" ] }, "body": { "mode": "raw", "raw": "{\n \"email\": \"\",\n \"tenant_id\": \"\",\n \"external_id\": \"\",\n \"sso_only\": false,\n \"custom_metadata\": {}\n}", "options": { "raw": { "language": "json" } } }, "description": "Equivalente a `POST /portal_users`. Disponible como ruta de verbo para SDKs que prefieren URLs descriptivas." }, "response": [] }, { "name": "Obtener usuario del portal", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/portal_users/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "portal_users", ":id" ], "variable": [ { "key": "id", "value": "" } ] }, "description": "El parámetro `{id}` acepta el UUID o el `external_id` del usuario." }, "response": [] }, { "name": "Actualizar usuario del portal", "request": { "method": "PATCH", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/portal_users/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "portal_users", ":id" ], "variable": [ { "key": "id", "value": "" } ] }, "body": { "mode": "raw", "raw": "{\n \"email\": \"\",\n \"tenant_id\": \"\",\n \"external_id\": \"\",\n \"sso_only\": false,\n \"status\": \"active\",\n \"unlock\": true,\n \"custom_metadata\": {}\n}", "options": { "raw": { "language": "json" } } }, "description": "Actualiza `email`, `tenant_id`, `external_id`, `sso_only`, `status` y `custom_metadata`. Transiciones de estado permitidas: `active` ↔ `suspended`." }, "response": [] }, { "name": "Eliminar usuario del portal", "request": { "method": "DELETE", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/portal_users/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "portal_users", ":id" ], "variable": [ { "key": "id", "value": "" } ] }, "description": "Las invitaciones pendientes se eliminan definitivamente; los demás usuarios se suspenden y sus sesiones se cierran. Un usuario ya suspendido no cambia. `outcome` indica lo que ocurrió." }, "response": [] }, { "name": "Previsualizar correo del usuario del portal", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/portal_users/:id/email-preview", "host": [ "{{baseUrl}}" ], "path": [ "v1", "portal_users", ":id", "email-preview" ], "variable": [ { "key": "id", "value": "" } ] }, "description": "Devuelve el asunto y el mensaje del correo de invitación o verificación que se enviaría al usuario, sin disparar el envío. Disponible solo para usuarios `pending_invitation` o `pending_verification`." }, "response": [] }, { "name": "Consultar la actividad del usuario del portal", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/portal_users/:id/activity?days=0", "host": [ "{{baseUrl}}" ], "path": [ "v1", "portal_users", ":id", "activity" ], "query": [ { "key": "days", "value": "0", "disabled": true } ], "variable": [ { "key": "id", "value": "" } ] }, "description": "Analítica de uso de un usuario del portal: inicios de sesión y páginas visitadas (desde siempre), páginas distintas, la actividad más reciente, una serie diaria de visitas e inicios de sesión en los últimos `days` días (días de São Paulo) y las páginas más abiertas. Las entradas individuales están en `GET /portal_users/{id}/activity/timeline`." }, "response": [] }, { "name": "Listar la línea de tiempo del usuario del portal", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/portal_users/:id/activity/timeline?before=2026-01-01T00:00:00Z&limit=0", "host": [ "{{baseUrl}}" ], "path": [ "v1", "portal_users", ":id", "activity", "timeline" ], "query": [ { "key": "before", "value": "2026-01-01T00:00:00Z", "disabled": true }, { "key": "limit", "value": "0", "disabled": true } ], "variable": [ { "key": "id", "value": "" } ] }, "description": "Inicios de sesión (`kind: login`, con el `method` usado: `credentials`, `magic-link` o `sso`) y páginas abiertas (`kind: page_view`, con `path` y `page_name`), de la más reciente a la más antigua. Paginación por cursor: envíe `meta.next_before` como `before` para la página siguiente; `null` indica que no hay más. Los accesos de un operador viendo el portal como el usuario no cuentan." }, "response": [] }, { "name": "Reenviar correo de invitación o verificación", "request": { "method": "POST", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/portal_users/:id/resend", "host": [ "{{baseUrl}}" ], "path": [ "v1", "portal_users", ":id", "resend" ], "variable": [ { "key": "id", "value": "" } ] }, "description": "Reenvía el correo de invitación (para `pending_invitation`, con rotación de token) o de verificación (para `pending_verification`). Otros estados devuelven 400." }, "response": [] }, { "name": "Consultar mapeo de usuarios del portal", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/portal_user_mappings", "host": [ "{{baseUrl}}" ], "path": [ "v1", "portal_user_mappings" ] }, "description": "La entidad que alimenta a los usuarios del portal del workspace (`mapping`, `null` si no hay, con el resultado de la última sincronización) y las entidades que pueden mapearse, con sus campos." }, "response": [] }, { "name": "Mapear entidad a usuarios del portal", "request": { "method": "PUT", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/portal_user_mappings", "host": [ "{{baseUrl}}" ], "path": [ "v1", "portal_user_mappings" ] }, "body": { "mode": "raw", "raw": "{\n \"entity_type_id\": \"00000000-0000-0000-0000-000000000000\",\n \"tenant_id_field_key\": \"\",\n \"email_field_key\": \"\",\n \"name_field_key\": \"\"\n}", "options": { "raw": { "language": "json" } } }, "description": "Mapea una entidad: un usuario del portal por correo de sus registros, con el ID del titular tomado de un campo. Reemplaza el mapeo anterior y sincroniza en el acto (devuelve `stats`); las próximas sincronizaciones de la entidad mantienen a los usuarios al día." }, "response": [] }, { "name": "Eliminar mapeo de usuarios del portal", "request": { "method": "DELETE", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/portal_user_mappings", "host": [ "{{baseUrl}}" ], "path": [ "v1", "portal_user_mappings" ] }, "description": "Deja de sincronizar; los usuarios ya creados permanecen." }, "response": [] } ] }, { "name": "Administración de la Cuenta", "item": [ { "name": "Listar usuarios del dashboard", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/dashboard_users?page=1&per_page=20&sort_by=&sort_order=asc&search=&status=all&role=", "host": [ "{{baseUrl}}" ], "path": [ "v1", "dashboard_users" ], "query": [ { "key": "page", "value": "1", "disabled": true }, { "key": "per_page", "value": "20", "disabled": true }, { "key": "sort_by", "value": "", "disabled": true }, { "key": "sort_order", "value": "asc", "disabled": true }, { "key": "search", "value": "", "disabled": true }, { "key": "status", "value": "all", "disabled": true }, { "key": "role", "value": "", "disabled": true } ] }, "description": "Devuelve una lista paginada de los usuarios del dashboard (miembros del equipo) de la organización actual." }, "response": [] }, { "name": "Invitar usuario del dashboard", "request": { "method": "POST", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/dashboard_users", "host": [ "{{baseUrl}}" ], "path": [ "v1", "dashboard_users" ] }, "body": { "mode": "raw", "raw": "{\n \"email\": \"user@example.com\",\n \"name\": \"\",\n \"external_id\": \"\",\n \"role_ids\": [\n \"00000000-0000-0000-0000-000000000000\"\n ],\n \"permissions\": [\n \"\"\n ],\n \"custom_metadata\": {}\n}", "options": { "raw": { "language": "json" } } }, "description": "Invita a un nuevo miembro al equipo de la organización. Es obligatorio informar `email` y al menos un rol en `role_ids`. El usuario recibe una invitación por correo y entra con estado `pending_invitation`." }, "response": [] }, { "name": "Crea o actualiza un usuario del panel", "request": { "method": "PUT", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/dashboard_users", "host": [ "{{baseUrl}}" ], "path": [ "v1", "dashboard_users" ] }, "body": { "mode": "raw", "raw": "{\n \"email\": \"user@example.com\",\n \"name\": \"\",\n \"external_id\": \"\",\n \"role_ids\": [\n \"00000000-0000-0000-0000-000000000000\"\n ],\n \"permissions\": [\n \"\"\n ],\n \"custom_metadata\": {},\n \"id\": \"00000000-0000-0000-0000-000000000000\",\n \"public_id\": \"00000000-0000-0000-0000-000000000000\"\n}", "options": { "raw": { "language": "json" } } }, "description": "Localiza al usuario por `id`, `public_id`, `external_id` o `email` — este último es único por organización. Si lo encuentra, lo actualiza; si no, lo crea y devuelve `201`. Al actualizar, con un token de persona, esta debe tener acceso a todos los workspaces en los que trabaja el miembro (o ser propietaria de la organización); de lo contrario, 403." }, "response": [] }, { "name": "Obtener usuario del dashboard", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/dashboard_users/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "dashboard_users", ":id" ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" } ] } }, "response": [] }, { "name": "Actualizar usuario del dashboard", "request": { "method": "PATCH", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/dashboard_users/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "dashboard_users", ":id" ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" } ] }, "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"picture\": \"\",\n \"status\": \"active\",\n \"permissions\": [\n \"\"\n ],\n \"role_ids\": [\n \"00000000-0000-0000-0000-000000000000\"\n ],\n \"external_id\": \"\",\n \"custom_metadata\": {}\n}", "options": { "raw": { "language": "json" } } }, "description": "Actualiza el nombre, la foto, el estado, los permisos y/o los roles del usuario. Solo se modifican los campos enviados. Con un token de persona, esta debe tener acceso a todos los workspaces en los que trabaja el miembro (o ser propietaria de la organización); de lo contrario, 403." }, "response": [] }, { "name": "Eliminar usuario del dashboard", "request": { "method": "DELETE", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/dashboard_users/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "dashboard_users", ":id" ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" } ] }, "description": "Elimina al usuario del dashboard de la organización. Acción irreversible — el usuario debe ser invitado de nuevo para recuperar el acceso. Con un token de persona, esta debe tener acceso a todos los workspaces en los que trabaja el miembro (o ser propietaria de la organización); de lo contrario, 403." }, "response": [] }, { "name": "Listar roles del equipo", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/team_roles?page=1&per_page=20&sort_by=&sort_order=asc&search=&is_active=true&is_system=false", "host": [ "{{baseUrl}}" ], "path": [ "v1", "team_roles" ], "query": [ { "key": "page", "value": "1", "disabled": true }, { "key": "per_page", "value": "20", "disabled": true }, { "key": "sort_by", "value": "", "disabled": true }, { "key": "sort_order", "value": "asc", "disabled": true }, { "key": "search", "value": "", "disabled": true }, { "key": "is_active", "value": "true", "disabled": true }, { "key": "is_system", "value": "false", "disabled": true } ] }, "description": "Devuelve la lista paginada de roles configurados para el equipo de la organización. Incluye tanto roles de sistema (`is_system = true`) como roles personalizados." }, "response": [] }, { "name": "Crear rol personalizado", "request": { "method": "POST", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/team_roles", "host": [ "{{baseUrl}}" ], "path": [ "v1", "team_roles" ] }, "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"slug\": \"portal_manager\",\n \"description\": \"\",\n \"permissions\": [\n \"\"\n ],\n \"is_active\": false,\n \"external_id\": \"\",\n \"custom_metadata\": {}\n}", "options": { "raw": { "language": "json" } } }, "description": "Crea un rol personalizado. El `slug` debe empezar con una letra minúscula y contener solo letras minúsculas, dígitos y `_`. Con un token de persona, esta debe tener acceso a todos los workspaces de la organización (o ser propietaria): un rol vale en todos ellos. De lo contrario, 403." }, "response": [] }, { "name": "Crea o actualiza un rol de equipo", "request": { "method": "PUT", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/team_roles", "host": [ "{{baseUrl}}" ], "path": [ "v1", "team_roles" ] }, "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"slug\": \"portal_manager\",\n \"description\": \"\",\n \"permissions\": [\n \"\"\n ],\n \"is_active\": false,\n \"external_id\": \"\",\n \"custom_metadata\": {},\n \"id\": \"00000000-0000-0000-0000-000000000000\",\n \"public_id\": \"00000000-0000-0000-0000-000000000000\"\n}", "options": { "raw": { "language": "json" } } }, "description": "Localiza el rol por `id`, `public_id` o `external_id`. El `slug` no tiene restricción de unicidad y por lo tanto **no** identifica un registro. Si lo encuentra, lo actualiza; si no, lo crea y devuelve `201`. Con un token de persona, esta debe tener acceso a todos los workspaces de la organización (o ser propietaria): un rol vale en todos ellos. De lo contrario, 403." }, "response": [] }, { "name": "Obtener rol", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/team_roles/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "team_roles", ":id" ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" } ] } }, "response": [] }, { "name": "Actualizar rol", "request": { "method": "PATCH", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/team_roles/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "team_roles", ":id" ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" } ] }, "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"slug\": \"\",\n \"description\": \"\",\n \"permissions\": [\n \"\"\n ],\n \"is_active\": false,\n \"external_id\": \"\",\n \"custom_metadata\": {}\n}", "options": { "raw": { "language": "json" } } }, "description": "Actualiza los campos del rol. Solo se modifican los campos enviados. Los roles de sistema tienen restricciones adicionales. Con un token de persona, esta debe tener acceso a todos los workspaces de la organización (o ser propietaria): un rol vale en todos ellos. De lo contrario, 403." }, "response": [] }, { "name": "Eliminar rol", "request": { "method": "DELETE", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/team_roles/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "team_roles", ":id" ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" } ] }, "description": "Realiza soft delete del rol. Los roles de sistema (`is_system = true`) no pueden eliminarse. Con un token de persona, esta debe tener acceso a todos los workspaces de la organización (o ser propietaria): un rol vale en todos ellos. De lo contrario, 403." }, "response": [] }, { "name": "Consultar los workspaces de un miembro", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/dashboard_users/:id/workspaces", "host": [ "{{baseUrl}}" ], "path": [ "v1", "dashboard_users", ":id", "workspaces" ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" } ] }, "description": "Lista todos los workspaces de la organización, marcando a los que el miembro accede — también es la lista de lo que se puede conceder." }, "response": [] }, { "name": "Definir los workspaces de un miembro", "request": { "method": "PUT", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/dashboard_users/:id/workspaces", "host": [ "{{baseUrl}}" ], "path": [ "v1", "dashboard_users", ":id", "workspaces" ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" } ] }, "body": { "mode": "raw", "raw": "{\n \"workspace_ids\": [\n \"00000000-0000-0000-0000-000000000000\"\n ]\n}", "options": { "raw": { "language": "json" } } }, "description": "Reemplaza el conjunto de workspaces del miembro. Nadie cambia su propio acceso (400), solo un dueño cambia el acceso de un dueño, y solo un dueño concede o revoca un workspace al que él mismo no accede (403). Un token de máquina puede conceder cualquier workspace, pero nunca cambia el acceso de un dueño. Quitar al último dueño de un workspace responde 403." }, "response": [] }, { "name": "Reenviar invitación de miembro", "request": { "method": "POST", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/dashboard_users/:id/resend", "host": [ "{{baseUrl}}" ], "path": [ "v1", "dashboard_users", ":id", "resend" ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" } ] }, "description": "Reenvía el correo de invitación, con un nuevo enlace de acceso, a un miembro cuya invitación sigue pendiente. Limitado a 5 envíos por hora por destinatario (429 por encima de eso)." }, "response": [] }, { "name": "Listar permisos", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/permissions", "host": [ "{{baseUrl}}" ], "path": [ "v1", "permissions" ] }, "description": "Catálogo de los permisos del dashboard que un miembro o un rol del equipo puede tener, agrupados por recurso — el vocabulario de `permissions` en `/dashboard_users` y `/team_roles`." }, "response": [] } ] }, { "name": "Workspaces", "item": [ { "name": "Listar workspaces", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/workspaces?page=1&per_page=20&sort_by=&sort_order=asc&search=", "host": [ "{{baseUrl}}" ], "path": [ "v1", "workspaces" ], "query": [ { "key": "page", "value": "1", "disabled": true }, { "key": "per_page", "value": "20", "disabled": true }, { "key": "sort_by", "value": "", "disabled": true }, { "key": "sort_order", "value": "asc", "disabled": true }, { "key": "search", "value": "", "disabled": true } ] }, "description": "Lista los workspaces de la organización que usted puede abrir, con su rol en cada uno — los mismos del selector del dashboard. Un token de máquina ve todos los workspaces de la organización. No requiere `X-Workspace-Id`." }, "response": [] }, { "name": "Crear workspace", "request": { "method": "POST", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/workspaces", "host": [ "{{baseUrl}}" ], "path": [ "v1", "workspaces" ] }, "body": { "mode": "raw", "raw": "{\n \"name\": \"\"\n}", "options": { "raw": { "language": "json" } } }, "description": "Crea un workspace vacío en la organización. La persona del token pasa a ser su dueña. Creado por un token de máquina, el workspace queda sin dueño: los dueños de la organización lo reciben en su próximo inicio de sesión, y `PUT /dashboard_users/{id}/workspaces` lo concede a otros miembros." }, "response": [] }, { "name": "Importar workspace", "request": { "method": "POST", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/workspaces/import", "host": [ "{{baseUrl}}" ], "path": [ "v1", "workspaces", "import" ] }, "body": { "mode": "raw", "raw": "{\n \"data\": {},\n \"name\": \"\"\n}", "options": { "raw": { "language": "json" } } }, "description": "Restaura un archivo de `GET /workspaces/{id}/export` en un workspace NUEVO, cuyo dueño es la persona del token. Responde lo que no se pudo traer de vuelta (`warnings`) para terminarlo a mano. Requiere un token de persona (un token de máquina recibe 403) con los permisos de crear workspaces, configurar el portal y crear fuentes de datos. Las entidades del archivo pasan por las mismas validaciones que al crearlas una a una (claves, expresiones, límite de campos del workspace). El cuerpo está limitado a 2 MB." }, "response": [] }, { "name": "Consultar workspace", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/workspaces/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "workspaces", ":id" ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" } ] }, "description": "Devuelve un workspace que usted puede abrir. Un workspace sin acceso concedido responde 404." }, "response": [] }, { "name": "Renombrar workspace", "request": { "method": "PATCH", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/workspaces/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "workspaces", ":id" ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" } ] }, "body": { "mode": "raw", "raw": "{\n \"name\": \"\"\n}", "options": { "raw": { "language": "json" } } }, "description": "Renombra el workspace. Solo los dueños del workspace pueden (403 para un miembro común)." }, "response": [] }, { "name": "Eliminar workspace", "request": { "method": "DELETE", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/workspaces/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "workspaces", ":id" ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" } ] }, "description": "Elimina el workspace (eliminación lógica), solo para sus dueños: el portal deja de estar disponible, los conectores dejan de sincronizar y los miembros pierden el acceso. El último workspace de la organización no puede eliminarse." }, "response": [] }, { "name": "Consultar el contenido del workspace", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/workspaces/:id/usage", "host": [ "{{baseUrl}}" ], "path": [ "v1", "workspaces", ":id", "usage" ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" } ] }, "description": "Cuenta lo que la eliminación del workspace ocultaría — el mismo resumen del diálogo de eliminación del dashboard." }, "response": [] }, { "name": "Exportar workspace", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/workspaces/:id/export", "host": [ "{{baseUrl}}" ], "path": [ "v1", "workspaces", ":id", "export" ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" } ] }, "description": "Descarga la configuración del workspace (constructor del portal, acceso y ajustes del portal, mapeo de usuarios, conectores y entidades) como un archivo JSON, solo para sus dueños. Los secretos y los datos quedan fuera. La respuesta es el propio archivo, sin envoltorio `data`; envíelo como `data` a `POST /workspaces/import`." }, "response": [] } ] }, { "name": "Fuentes de Datos", "item": [ { "name": "Listar fuentes de datos", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/data_sources?page=1&per_page=20&sort_by=&sort_order=asc", "host": [ "{{baseUrl}}" ], "path": [ "v1", "data_sources" ], "query": [ { "key": "page", "value": "1", "disabled": true }, { "key": "per_page", "value": "20", "disabled": true }, { "key": "sort_by", "value": "", "disabled": true }, { "key": "sort_order", "value": "asc", "disabled": true } ] }, "description": "Fuentes de datos del workspace — APIs OpenAPI, servidores MCP y bases de solo lectura —, de las más nuevas a las más antiguas. Los secretos nunca se devuelven. Para crear una fuente, use la ruta de su tipo: `/data_sources/openapi`, `/mcp`, `/database` o `/catalog`." }, "response": [] }, { "name": "Listar productos del catálogo Kobana", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/data_sources/catalog", "host": [ "{{baseUrl}}" ], "path": [ "v1", "data_sources", "catalog" ] }, "description": "Productos Kobana que se pueden conectar como fuente de datos solo con un token. Lista completa, sin paginación." }, "response": [] }, { "name": "Conectar producto Kobana", "request": { "method": "POST", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/data_sources/catalog", "host": [ "{{baseUrl}}" ], "path": [ "v1", "data_sources", "catalog" ] }, "body": { "mode": "raw", "raw": "{\n \"product\": \"\",\n \"environment\": \"production\",\n \"token\": \"\",\n \"workspace_id\": \"\",\n \"name\": \"\"\n}", "options": { "raw": { "language": "json" } } }, "description": "Guarda una fuente OpenAPI a partir de la spec del producto incluida en la aplicación y prueba la conexión." }, "response": [] }, { "name": "Crear fuente OpenAPI", "request": { "method": "POST", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/data_sources/openapi", "host": [ "{{baseUrl}}" ], "path": [ "v1", "data_sources", "openapi" ] }, "body": { "mode": "raw", "raw": "{\n \"spec\": \"\",\n \"spec_file_name\": \"\",\n \"certificate\": {\n \"filename\": \"\",\n \"content_base64\": \"\"\n },\n \"name\": \"\",\n \"base_url\": \"\",\n \"auth\": {\n \"kind\": \"none\",\n \"headers\": [\n {\n \"name\": \"\",\n \"value\": \"\"\n }\n ],\n \"params\": [\n {\n \"name\": \"\",\n \"value\": \"\"\n }\n ]\n },\n \"credentials\": {\n \"token\": \"\",\n \"username\": \"\",\n \"password\": \"\",\n \"certificate_password\": \"\"\n },\n \"response_format\": \"json\"\n}", "options": { "raw": { "language": "json" } } }, "description": "Guarda una API descrita por una spec OpenAPI, importa sus operaciones y prueba la conexión. La spec va como texto en `spec`; el certificado mTLS, en base64 en `certificate`." }, "response": [] }, { "name": "Analizar spec OpenAPI", "request": { "method": "POST", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/data_sources/openapi/analyze", "host": [ "{{baseUrl}}" ], "path": [ "v1", "data_sources", "openapi", "analyze" ] }, "body": { "mode": "raw", "raw": "{\n \"spec\": \"\",\n \"spec_file_name\": \"\"\n}", "options": { "raw": { "language": "json" } } }, "description": "Lee la spec y devuelve lo que se importaría — título, servidores, esquemas de seguridad, autenticación sugerida y operaciones — sin guardar nada." }, "response": [] }, { "name": "Crear fuente MCP", "request": { "method": "POST", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/data_sources/mcp", "host": [ "{{baseUrl}}" ], "path": [ "v1", "data_sources", "mcp" ] }, "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"url\": \"\",\n \"transport\": \"http\",\n \"headers\": \"\",\n \"oauth\": {\n \"mode\": \"none\",\n \"client_id\": \"\",\n \"client_secret\": \"\",\n \"scopes\": \"\"\n }\n}", "options": { "raw": { "language": "json" } } }, "description": "Guarda un servidor MCP. Sin OAuth, conecta y descubre las tools al momento; con OAuth, devuelve `authorization_url`, que una persona con sesión en el dashboard debe abrir en el navegador para terminar." }, "response": [] }, { "name": "Crear fuente de base de datos", "request": { "method": "POST", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/data_sources/database", "host": [ "{{baseUrl}}" ], "path": [ "v1", "data_sources", "database" ] }, "body": { "mode": "raw", "raw": "{\n \"engine\": \"postgres\",\n \"name\": \"\",\n \"host\": \"\",\n \"port\": 0,\n \"database\": \"\",\n \"username\": \"\",\n \"password\": \"\",\n \"connection_string\": \"\",\n \"ssl\": false,\n \"ssl_verify\": false\n}", "options": { "raw": { "language": "json" } } }, "description": "Guarda una base de solo lectura (PostgreSQL, MySQL, MariaDB, SQL Server o MongoDB), conecta y cataloga sus tablas o colecciones." }, "response": [] }, { "name": "Probar conexión antes de guardar", "request": { "method": "POST", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/data_sources/test", "host": [ "{{baseUrl}}" ], "path": [ "v1", "data_sources", "test" ] }, "body": { "mode": "raw", "raw": "{\n \"kind\": \"openapi\",\n \"spec\": \"\",\n \"spec_file_name\": \"\",\n \"certificate\": {\n \"filename\": \"\",\n \"content_base64\": \"\"\n },\n \"name\": \"\",\n \"base_url\": \"\",\n \"auth\": {\n \"kind\": \"none\",\n \"headers\": [\n {\n \"name\": \"\",\n \"value\": \"\"\n }\n ],\n \"params\": [\n {\n \"name\": \"\",\n \"value\": \"\"\n }\n ]\n },\n \"credentials\": {\n \"token\": \"\",\n \"username\": \"\",\n \"password\": \"\",\n \"certificate_password\": \"\"\n },\n \"response_format\": \"json\"\n}", "options": { "raw": { "language": "json" } } }, "description": "Prueba una conexión aún no guardada. Informe `kind` (`openapi`, `mcp`, `database` o `catalog`) y el cuerpo de la ruta de creación correspondiente. No se persiste nada." }, "response": [] }, { "name": "Consultar fuente de datos", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/data_sources/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "data_sources", ":id" ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" } ] }, "description": "La fuente de datos y sus operaciones (endpoints, tools o tablas que puede leer)." }, "response": [] }, { "name": "Actualizar fuente de datos", "request": { "method": "PATCH", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/data_sources/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "data_sources", ":id" ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" } ] }, "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"is_active\": false,\n \"base_url\": \"\",\n \"auth\": {\n \"kind\": \"none\",\n \"headers\": [\n {\n \"name\": \"\",\n \"value\": \"\"\n }\n ],\n \"params\": [\n {\n \"name\": \"\",\n \"value\": \"\"\n }\n ]\n },\n \"credentials\": {\n \"token\": \"\",\n \"username\": \"\",\n \"password\": \"\",\n \"certificate_password\": \"\"\n },\n \"certificate\": {\n \"filename\": \"\",\n \"content_base64\": \"\"\n },\n \"probe_operation_key\": \"\",\n \"default_params\": {},\n \"response_format\": \"json\",\n \"url\": \"\",\n \"transport\": \"http\",\n \"headers\": \"\",\n \"oauth\": {\n \"mode\": \"none\",\n \"client_id\": \"\",\n \"client_secret\": \"\",\n \"scopes\": \"\"\n },\n \"engine\": \"postgres\",\n \"host\": \"\",\n \"port\": 0,\n \"database\": \"\",\n \"username\": \"\",\n \"password\": \"\",\n \"connection_string\": \"\",\n \"ssl\": false,\n \"ssl_verify\": false\n}", "options": { "raw": { "language": "json" } } }, "description": "Actualiza nombre, `is_active` y los campos de conexión del tipo de la fuente. Los campos secretos en blanco mantienen los guardados. Una fuente OpenAPI recibe un nuevo certificado en `certificate`." }, "response": [] }, { "name": "Eliminar fuente de datos", "request": { "method": "DELETE", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/data_sources/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "data_sources", ":id" ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" } ] }, "description": "Elimina la fuente, sus operaciones y la agenda de sincronización. Rechazado (409) mientras una entidad lee la fuente: elimine las entidades antes. No se puede deshacer." }, "response": [] }, { "name": "Probar fuente de datos", "request": { "method": "POST", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/data_sources/:id/test", "host": [ "{{baseUrl}}" ], "path": [ "v1", "data_sources", ":id", "test" ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" } ] }, "description": "Prueba la fuente guardada y registra el resultado (estado, último error). En un servidor MCP, también actualiza la lista de tools." }, "response": [] }, { "name": "Sincronizar fuente de datos", "request": { "method": "POST", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/data_sources/:id/sync", "host": [ "{{baseUrl}}" ], "path": [ "v1", "data_sources", ":id", "sync" ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" } ] }, "body": { "mode": "raw", "raw": "{\n \"full\": false\n}", "options": { "raw": { "language": "json" } } }, "description": "Encola la sincronización de todas las entidades alimentadas por la fuente. La ejecución es asíncrona." }, "response": [] }, { "name": "Agendar sincronización de la fuente", "request": { "method": "PUT", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/data_sources/:id/schedule", "host": [ "{{baseUrl}}" ], "path": [ "v1", "data_sources", ":id", "schedule" ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" } ] }, "body": { "mode": "raw", "raw": "{\n \"cron\": \"\",\n \"timezone\": \"\"\n}", "options": { "raw": { "language": "json" } } }, "description": "Define con qué frecuencia sincroniza la fuente: `{ cron, timezone }`, o `{ cron: null }` para solo bajo demanda. Devuelve las próximas ejecuciones." }, "response": [] }, { "name": "Reemplazar spec de la fuente", "request": { "method": "PUT", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/data_sources/:id/spec", "host": [ "{{baseUrl}}" ], "path": [ "v1", "data_sources", ":id", "spec" ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" } ] }, "body": { "mode": "raw", "raw": "{\n \"spec\": \"\",\n \"spec_file_name\": \"\"\n}", "options": { "raw": { "language": "json" } } }, "description": "Reemplaza la spec OpenAPI y resincroniza las operaciones: las que mantienen la clave mantienen su configuración; las que desaparecieron de la spec se eliminan." }, "response": [] }, { "name": "Autorizar fuente MCP", "request": { "method": "POST", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/data_sources/:id/authorize", "host": [ "{{baseUrl}}" ], "path": [ "v1", "data_sources", ":id", "authorize" ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" } ] }, "description": "Reinicia la autorización OAuth de un servidor MCP. Devuelve `authorization_url` para que una persona con sesión en el dashboard la abra en el navegador, o `null` y la prueba de conexión cuando los tokens guardados aún funcionan." }, "response": [] }, { "name": "Listar log de solicitudes de la fuente", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/data_sources/:id/logs?page=1&per_page=20&sort_by=&sort_order=asc&method=&success=true&search=&date_from=2026-01-01&date_to=2026-01-01", "host": [ "{{baseUrl}}" ], "path": [ "v1", "data_sources", ":id", "logs" ], "query": [ { "key": "page", "value": "1", "disabled": true }, { "key": "per_page", "value": "20", "disabled": true }, { "key": "sort_by", "value": "", "disabled": true }, { "key": "sort_order", "value": "asc", "disabled": true }, { "key": "method", "value": "", "disabled": true }, { "key": "success", "value": "true", "disabled": true }, { "key": "search", "value": "", "disabled": true }, { "key": "date_from", "value": "2026-01-01", "disabled": true }, { "key": "date_to", "value": "2026-01-01", "disabled": true } ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" } ] }, "description": "Llamadas que hizo la fuente (solicitudes HTTP, consultas a la base), de las más nuevas a las más antiguas, sin cabeceras ni cuerpos." }, "response": [] }, { "name": "Consultar solicitud de la fuente", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/data_sources/:id/logs/:log_id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "data_sources", ":id", "logs", ":log_id" ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" }, { "key": "log_id", "value": "00000000-0000-0000-0000-000000000000" } ] }, "description": "Una llamada completa: cabeceras y cuerpos de la solicitud y de la respuesta, con secretos enmascarados." }, "response": [] }, { "name": "Activar o desactivar operación de la fuente", "request": { "method": "PATCH", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/data_sources/:id/operations/:operation_id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "data_sources", ":id", "operations", ":operation_id" ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" }, { "key": "operation_id", "value": "00000000-0000-0000-0000-000000000000" } ] }, "body": { "mode": "raw", "raw": "{\n \"enabled\": false\n}", "options": { "raw": { "language": "json" } } }, "description": "Activa o desactiva una operación de la fuente (`enabled`). Las operaciones desactivadas no alimentan entidades." }, "response": [] } ] }, { "name": "Entidades", "item": [ { "name": "Listar entidades", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/entities", "host": [ "{{baseUrl}}" ], "path": [ "v1", "entities" ] }, "description": "Todas las entidades del workspace, con campos, origen y estado de la sincronización, ordenadas por nombre. Sin paginación." }, "response": [] }, { "name": "Crear entidad", "request": { "method": "POST", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/entities", "host": [ "{{baseUrl}}" ], "path": [ "v1", "entities" ] }, "body": { "mode": "raw", "raw": "{\n \"integration_id\": \"00000000-0000-0000-0000-000000000000\",\n \"operation_id\": \"00000000-0000-0000-0000-000000000000\",\n \"sql\": \"\",\n \"params\": {},\n \"pagination\": {\n \"style\": \"none\",\n \"page_param\": \"\",\n \"offset_param\": \"\",\n \"cursor_param\": \"\",\n \"size_param\": \"\",\n \"limit_param\": \"\",\n \"next_cursor_path\": \"\",\n \"page_size\": 0\n },\n \"sync_filters\": [\n {\n \"target\": \"\",\n \"op\": \"eq\",\n \"value\": {}\n }\n ],\n \"source_kind\": \"push\",\n \"key\": \"\",\n \"name\": \"\",\n \"name_plural\": \"\",\n \"description\": \"\",\n \"identifier_field_key\": \"\",\n \"label_field_key\": \"\",\n \"owner_field_key\": \"\",\n \"owner_match\": \"external_id\",\n \"sync_mode\": \"scheduled\",\n \"freshness_seconds\": 0,\n \"fields\": [\n {\n \"key\": \"\",\n \"name\": \"\",\n \"data_type\": \"string\",\n \"semantic_role\": \"identifier\",\n \"source_path\": \"\",\n \"expression\": \"\",\n \"format\": \"\",\n \"enum_options\": [\n {}\n ],\n \"visible\": false,\n \"filterable\": false,\n \"sortable\": false\n }\n ],\n \"records_path\": \"\",\n \"sample\": [\n {}\n ]\n}", "options": { "raw": { "language": "json" } } }, "description": "Registra una entidad a partir de una operación de lectura (o consulta SQL) de la fuente de datos con los campos elegidos, y encola la primera sincronización completa." }, "response": [] }, { "name": "Vista previa de un origen", "request": { "method": "POST", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/entities/preview", "host": [ "{{baseUrl}}" ], "path": [ "v1", "entities", "preview" ] }, "body": { "mode": "raw", "raw": "{\n \"integration_id\": \"00000000-0000-0000-0000-000000000000\",\n \"operation_id\": \"00000000-0000-0000-0000-000000000000\",\n \"sql\": \"\",\n \"params\": {},\n \"pagination\": {\n \"style\": \"none\",\n \"page_param\": \"\",\n \"offset_param\": \"\",\n \"cursor_param\": \"\",\n \"size_param\": \"\",\n \"limit_param\": \"\",\n \"next_cursor_path\": \"\",\n \"page_size\": 0\n },\n \"sync_filters\": [\n {\n \"target\": \"\",\n \"op\": \"eq\",\n \"value\": {}\n }\n ],\n \"limit\": 0\n}", "options": { "raw": { "language": "json" } } }, "description": "Llama a la operación de lectura elegida (o ejecuta la consulta SQL) y devuelve la muestra con la entidad inferida de ella. No se guarda nada; la llamada queda en el registro de solicitudes del conector." }, "response": [] }, { "name": "Crear entidad de relación", "request": { "method": "POST", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/entities/join", "host": [ "{{baseUrl}}" ], "path": [ "v1", "entities", "join" ] }, "body": { "mode": "raw", "raw": "{\n \"key\": \"\",\n \"name\": \"\",\n \"name_plural\": \"\",\n \"description\": \"\",\n \"join\": {\n \"base_entity_id\": \"00000000-0000-0000-0000-000000000000\",\n \"related_entity_id\": \"00000000-0000-0000-0000-000000000000\",\n \"base_field\": \"\",\n \"related_field\": \"\",\n \"type\": \"inner\",\n \"match\": \"exact\"\n },\n \"fields\": [\n {\n \"from\": \"base\",\n \"field_key\": \"\",\n \"key\": \"\",\n \"name\": \"\"\n }\n ],\n \"label_field_key\": \"\",\n \"owner_field_key\": \"\"\n}", "options": { "raw": { "language": "json" } } }, "description": "Registra una entidad que relaciona otras dos (join) con los campos elegidos de cada una, y encola la primera sincronización." }, "response": [] }, { "name": "Vista previa de una relación", "request": { "method": "POST", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/entities/join/preview", "host": [ "{{baseUrl}}" ], "path": [ "v1", "entities", "join", "preview" ] }, "body": { "mode": "raw", "raw": "{\n \"base_entity_id\": \"00000000-0000-0000-0000-000000000000\",\n \"related_entity_id\": \"00000000-0000-0000-0000-000000000000\",\n \"base_field\": \"\",\n \"related_field\": \"\",\n \"type\": \"inner\",\n \"match\": \"exact\"\n}", "options": { "raw": { "language": "json" } } }, "description": "Cómo coinciden dos entidades en los campos indicados (recuentos) y las primeras filas combinadas, antes de guardar la relación. Lee solo los registros ya sincronizados." }, "response": [] }, { "name": "Consultar entidad", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/entities/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "entities", ":id" ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" } ] }, "description": "Una entidad con campos, origen, modo de sincronización, campo del titular y estado de la sincronización." }, "response": [] }, { "name": "Actualizar entidad", "request": { "method": "PATCH", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/entities/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "entities", ":id" ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" } ] }, "body": { "mode": "raw", "raw": "{\n \"key\": \"\",\n \"name\": \"\",\n \"name_plural\": \"\",\n \"description\": \"\",\n \"identifier_field_key\": \"\",\n \"label_field_key\": \"\",\n \"owner_field_key\": \"\",\n \"owner_match\": \"external_id\",\n \"sync_mode\": \"scheduled\",\n \"freshness_seconds\": 0,\n \"fields\": [\n {\n \"key\": \"\",\n \"name\": \"\",\n \"data_type\": \"string\",\n \"semantic_role\": \"identifier\",\n \"source_path\": \"\",\n \"expression\": \"\",\n \"format\": \"\",\n \"enum_options\": [\n {}\n ],\n \"visible\": false,\n \"filterable\": false,\n \"sortable\": false\n }\n ],\n \"pagination\": {\n \"style\": \"none\",\n \"page_param\": \"\",\n \"offset_param\": \"\",\n \"cursor_param\": \"\",\n \"size_param\": \"\",\n \"limit_param\": \"\",\n \"next_cursor_path\": \"\",\n \"page_size\": 0\n },\n \"sync_filters\": [\n {\n \"target\": \"\",\n \"op\": \"eq\",\n \"value\": {}\n }\n ]\n}", "options": { "raw": { "language": "json" } } }, "description": "Nombre, clave, campos especiales, paginación, filtros y modo de la sincronización, y la lista de campos (emparejada por clave). Cuando cambia el mapeo, los registros se vuelven a leer." }, "response": [] }, { "name": "Eliminar entidad", "request": { "method": "DELETE", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/entities/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "entities", ":id" ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" } ] }, "description": "Elimina (soft delete) la entidad y sus campos. Rechazado (409) mientras una entidad de relación la lee." }, "response": [] }, { "name": "Modificar relación", "request": { "method": "PUT", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/entities/:id/join", "host": [ "{{baseUrl}}" ], "path": [ "v1", "entities", ":id", "join" ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" } ] }, "body": { "mode": "raw", "raw": "{\n \"key\": \"\",\n \"name\": \"\",\n \"name_plural\": \"\",\n \"description\": \"\",\n \"join\": {\n \"base_entity_id\": \"00000000-0000-0000-0000-000000000000\",\n \"related_entity_id\": \"00000000-0000-0000-0000-000000000000\",\n \"base_field\": \"\",\n \"related_field\": \"\",\n \"type\": \"inner\",\n \"match\": \"exact\"\n },\n \"fields\": [\n {\n \"from\": \"base\",\n \"field_key\": \"\",\n \"key\": \"\",\n \"name\": \"\"\n }\n ],\n \"label_field_key\": \"\",\n \"owner_field_key\": \"\"\n}", "options": { "raw": { "language": "json" } } }, "description": "Cambia la relación de una entidad join y los campos que trae, y vuelve a leer sus registros. 422 cuando la entidad no es una relación." }, "response": [] }, { "name": "Consultar registros", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/entities/:id/records?limit=50&offset=0&sort=due_date:desc,name&filter={\"status\":\"open\",\"amount\":{\"gte\":100}}&preview_as=00000000-0000-0000-0000-000000000000", "host": [ "{{baseUrl}}" ], "path": [ "v1", "entities", ":id", "records" ], "query": [ { "key": "limit", "value": "50", "disabled": true }, { "key": "offset", "value": "0", "disabled": true }, { "key": "sort", "value": "due_date:desc,name", "disabled": true }, { "key": "filter", "value": "{\"status\":\"open\",\"amount\":{\"gte\":100}}", "disabled": true }, { "key": "preview_as", "value": "00000000-0000-0000-0000-000000000000", "disabled": true } ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" } ] }, "description": "Los registros sincronizados de la entidad, con filtro por campo, ordenación y paginación por `limit`/`offset` (la misma consulta de los bloques del portal)." }, "response": [] }, { "name": "Limpiar registros", "request": { "method": "DELETE", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/entities/:id/records", "host": [ "{{baseUrl}}" ], "path": [ "v1", "entities", ":id", "records" ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" } ] }, "description": "Elimina todos los registros sincronizados de la entidad y reinicia el estado de la sincronización, para que la próxima lea el origen desde cero." }, "response": [] }, { "name": "Enviar registros", "request": { "method": "POST", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/entities/:id/records", "host": [ "{{baseUrl}}" ], "path": [ "v1", "entities", ":id", "records" ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" } ] }, "body": { "mode": "raw", "raw": "{\n \"records\": [\n {\n \"id\": \"42\",\n \"nome\": \"Ana Souza\",\n \"valor\": 1250.5,\n \"cliente_id\": \"C-001\"\n }\n ],\n \"mode\": \"upsert\"\n}", "options": { "raw": { "language": "json" } } }, "description": "Envía registros a una entidad sin conexión (`source_kind: \"push\"`): cada uno se guarda por su identificador — enviado de nuevo, se actualiza; sin cambios, no se reescribe. Las relaciones y los usuarios del portal que dependen de la entidad se actualizan después. 422 en una entidad que lee de una conexión." }, "response": [] }, { "name": "Consultar registro", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/entities/:id/records/:record_id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "entities", ":id", "records", ":record_id" ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" }, { "key": "record_id", "value": "00000000-0000-0000-0000-000000000000" } ] }, "description": "Un registro sincronizado — valores por campo y el registro tal como lo envió el origen — con su entidad." }, "response": [] }, { "name": "Eliminar registro", "request": { "method": "DELETE", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/entities/:id/records/:record_id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "entities", ":id", "records", ":record_id" ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" }, { "key": "record_id", "value": "" } ] }, "description": "Elimina un registro de una entidad sin conexión. 422 en una entidad que lee de una conexión: sus registros salen cuando salen del origen." }, "response": [] }, { "name": "Importar CSV", "request": { "method": "POST", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/entities/:id/records/import", "host": [ "{{baseUrl}}" ], "path": [ "v1", "entities", ":id", "records", "import" ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" } ] }, "body": { "mode": "raw", "raw": "{\n \"content\": \"id;nome;valor\\n42;Ana Souza;1250,50\",\n \"content_base64\": \"\",\n \"mode\": \"upsert\"\n}", "options": { "raw": { "language": "json" } } }, "description": "Importa un CSV a una entidad sin conexión: un registro por línea, cada columna que lee un campo convertida a su tipo (números, fechas, booleanos). Las líneas sin identificador se rechazan y se listan por número de línea (la 1 es el encabezado)." }, "response": [] }, { "name": "Agregar registros", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/entities/:id/aggregate?op=count&field=&group_by=&filter={\"status\":\"open\",\"amount\":{\"gte\":100}}&preview_as=00000000-0000-0000-0000-000000000000", "host": [ "{{baseUrl}}" ], "path": [ "v1", "entities", ":id", "aggregate" ], "query": [ { "key": "op", "value": "count", "disabled": true }, { "key": "field", "value": "", "disabled": true }, { "key": "group_by", "value": "", "disabled": true }, { "key": "filter", "value": "{\"status\":\"open\",\"amount\":{\"gte\":100}}", "disabled": true }, { "key": "preview_as", "value": "00000000-0000-0000-0000-000000000000", "disabled": true } ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" } ] }, "description": "Recuento, suma, promedio, mínimo o máximo sobre los registros sincronizados, opcionalmente agrupados por un campo — lo que muestran los bloques de KPI y gráfico." }, "response": [] }, { "name": "Uso de la entidad", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/entities/:id/usage", "host": [ "{{baseUrl}}" ], "path": [ "v1", "entities", ":id", "usage" ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" } ] }, "description": "Las páginas del portal (borrador y publicada) cuyos bloques leen la entidad — lo que se rompe si se elimina o cambia su clave." }, "response": [] }, { "name": "Registro de la sincronización", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/entities/:id/logs?page=1&per_page=20&method=&success=true&search=&date_from=2026-01-01&date_to=2026-01-31", "host": [ "{{baseUrl}}" ], "path": [ "v1", "entities", ":id", "logs" ], "query": [ { "key": "page", "value": "1", "disabled": true }, { "key": "per_page", "value": "20", "disabled": true }, { "key": "method", "value": "", "disabled": true }, { "key": "success", "value": "true", "disabled": true }, { "key": "search", "value": "", "disabled": true }, { "key": "date_from", "value": "2026-01-01", "disabled": true }, { "key": "date_to", "value": "2026-01-31", "disabled": true } ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" } ] }, "description": "Las llamadas que la sincronización de la entidad hizo al conector, de las más nuevas a las más antiguas: el registro de solicitudes del conector restringido a la entidad." }, "response": [] }, { "name": "Consultar llamada de la sincronización", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/entities/:id/logs/:log_id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "entities", ":id", "logs", ":log_id" ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" }, { "key": "log_id", "value": "00000000-0000-0000-0000-000000000000" } ] }, "description": "Una llamada de la sincronización de la entidad, completa (secretos enmascarados)." }, "response": [] }, { "name": "Sincronizar entidad", "request": { "method": "POST", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/entities/:id/sync?full=true", "host": [ "{{baseUrl}}" ], "path": [ "v1", "entities", ":id", "sync" ], "query": [ { "key": "full", "value": "true", "disabled": true } ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" } ] }, "description": "Encola una sincronización de la entidad y responde 202 con el ID; el avance está en `GET /entities/{id}/sync`. Una entidad `on_access` no tiene sincronización general (422): use `POST /entities/{id}/tenant_syncs`." }, "response": [] }, { "name": "Estado de la sincronización", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/entities/:id/sync", "host": [ "{{baseUrl}}" ], "path": [ "v1", "entities", ":id", "sync" ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" } ] }, "description": "Dónde está la sincronización de la entidad: estado, último error, últimas sincronizaciones, total de registros y estadísticas." }, "response": [] }, { "name": "Sincronizaciones por titular", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/entities/:id/tenant_syncs?page=1&per_page=20&status=queued&search=", "host": [ "{{baseUrl}}" ], "path": [ "v1", "entities", ":id", "tenant_syncs" ], "query": [ { "key": "page", "value": "1", "disabled": true }, { "key": "per_page", "value": "20", "disabled": true }, { "key": "status", "value": "queued", "disabled": true }, { "key": "search", "value": "", "disabled": true } ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" } ] }, "description": "En una entidad `on_access`: dónde está la sincronización de cada titular, de los accedidos más recientemente a los más antiguos." }, "response": [] }, { "name": "Sincronizar un titular", "request": { "method": "POST", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/entities/:id/tenant_syncs", "host": [ "{{baseUrl}}" ], "path": [ "v1", "entities", ":id", "tenant_syncs" ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" } ] }, "body": { "mode": "raw", "raw": "{\n \"tenant_id\": \"\",\n \"full\": false\n}", "options": { "raw": { "language": "json" } } }, "description": "Encola ahora la sincronización de un titular de una entidad `on_access`. 404 cuando ningún usuario del portal tiene ese Tenant ID; 422 cuando la entidad no es `on_access`." }, "response": [] } ] }, { "name": "Constructor del Portal", "item": [ { "name": "Consultar el constructor del portal", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/builder", "host": [ "{{baseUrl}}" ], "path": [ "v1", "builder" ] }, "description": "Devuelve el portal del workspace como lo ve el constructor: identidad del portal, borrador (páginas en el orden del menú, cada una con su marca respecto a la versión publicada, `revision` y `dirty`), número de la versión publicada, versiones publicadas, tema y SEO predeterminado. Lea la `revision` aquí antes de guardar el borrador." }, "response": [] }, { "name": "Guardar el borrador del portal", "request": { "method": "PUT", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/builder/draft", "host": [ "{{baseUrl}}" ], "path": [ "v1", "builder", "draft" ] }, "body": { "mode": "raw", "raw": "{\n \"revision\": 0,\n \"pages\": [\n {\n \"id\": \"\",\n \"name\": \"\",\n \"path\": \"\",\n \"title\": \"\",\n \"seo\": {\n \"description\": \"\",\n \"keywords\": \"\",\n \"robots\": \"\",\n \"canonical\": \"\",\n \"og_title\": \"\",\n \"og_description\": \"\",\n \"og_image\": \"\",\n \"og_image_url\": \"\",\n \"og_image_meta\": \"\"\n },\n \"show_in_menu\": false,\n \"content\": {}\n }\n ],\n \"editor_state\": {},\n \"theme\": {\n \"light\": {},\n \"dark\": {},\n \"radius\": \"0.5rem\"\n },\n \"seo_defaults\": {\n \"description\": \"\",\n \"keywords\": \"\",\n \"robots\": \"\",\n \"og_title\": \"\",\n \"og_description\": \"\",\n \"og_image\": \"\",\n \"og_image_url\": \"\",\n \"og_image_meta\": \"\"\n }\n}", "options": { "raw": { "language": "json" } } }, "description": "Sustituye el borrador completo — páginas en el orden del menú, estado del editor y, opcionalmente, tema y SEO predeterminado — protegido por la última `revision` leída. Una `revision` desactualizada responde 409 y no cambia nada. Nada se publica: para publicar, use `POST /builder/publish`." }, "response": [] }, { "name": "Publicar el portal", "request": { "method": "POST", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/builder/publish", "host": [ "{{baseUrl}}" ], "path": [ "v1", "builder", "publish" ] }, "body": { "mode": "raw", "raw": "{\n \"revision\": 0,\n \"pages\": [\n {\n \"id\": \"\",\n \"name\": \"\",\n \"path\": \"\",\n \"title\": \"\",\n \"seo\": {\n \"description\": \"\",\n \"keywords\": \"\",\n \"robots\": \"\",\n \"canonical\": \"\",\n \"og_title\": \"\",\n \"og_description\": \"\",\n \"og_image\": \"\",\n \"og_image_url\": \"\",\n \"og_image_meta\": \"\"\n },\n \"show_in_menu\": false,\n \"content\": {}\n }\n ],\n \"editor_state\": {},\n \"theme\": {\n \"light\": {},\n \"dark\": {},\n \"radius\": \"0.5rem\"\n },\n \"seo_defaults\": {\n \"description\": \"\",\n \"keywords\": \"\",\n \"robots\": \"\",\n \"og_title\": \"\",\n \"og_description\": \"\",\n \"og_image\": \"\",\n \"og_image_url\": \"\",\n \"og_image_meta\": \"\"\n },\n \"note\": \"\"\n}", "options": { "raw": { "language": "json" } } }, "description": "Guarda el borrador tal como se envía (mismo cuerpo que el guardado, más una `note` opcional) y lo congela como la próxima versión, en una sola transacción: los visitantes del portal la ven de inmediato. Un campo de formulario cuya expresión regular puede bloquear la validación responde 422 `UNSAFE_FIELD_PATTERN`." }, "response": [] }, { "name": "Consultar una versión publicada", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/builder/versions/:number", "host": [ "{{baseUrl}}" ], "path": [ "v1", "builder", "versions", ":number" ], "variable": [ { "key": "number", "value": "3" } ] }, "description": "Devuelve una versión publicada del portal, por número, con las páginas que congeló." }, "response": [] }, { "name": "Restaurar una versión", "request": { "method": "POST", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/builder/versions/:number/rollback", "host": [ "{{baseUrl}}" ], "path": [ "v1", "builder", "versions", ":number", "rollback" ], "variable": [ { "key": "number", "value": "3" } ] }, "description": "Vuelve a publicar esa versión como el próximo número — los visitantes del portal la ven de inmediato. Devuelve la nueva versión y el constructor tal como quedó." }, "response": [] }, { "name": "Cifrar un secreto de bloque", "request": { "method": "POST", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/builder/secrets", "host": [ "{{baseUrl}}" ], "path": [ "v1", "builder", "secrets" ] }, "body": { "mode": "raw", "raw": "{\n \"value\": \"\",\n \"url\": \"https://hooks.example.com/in\"\n}", "options": { "raw": { "language": "json" } } }, "description": "Cifra un valor que un bloque guarda en el JSON de la página (una cabecera de webhook como `Authorization`). Devuelve `secret:`, vinculado a este workspace y al origen de `url` (obligatoria), que solo el servidor abre para enviar la solicitud a ese origen. Nada se almacena: guarde el valor devuelto en el bloque junto con el borrador." }, "response": [] }, { "name": "Subir una imagen og:image", "request": { "method": "POST", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/builder/og_image", "host": [ "{{baseUrl}}" ], "path": [ "v1", "builder", "og_image" ] }, "body": { "mode": "raw", "raw": "{\n \"filename\": \"cover.png\",\n \"content_type\": \"image/png\",\n \"content_base64\": \"\"\n}", "options": { "raw": { "language": "json" } } }, "description": "Sube la og:image de una página (o del SEO predeterminado) — la imagen que muestran las vistas previas de enlaces — y devuelve su URL pública, para guardar en `seo.og_image_url` (o `seo_defaults.og_image_url`) en el próximo guardado del borrador. PNG, JPEG o WebP, en base64; hasta 2 MB de imagen, pero el cuerpo completo de la solicitud tiene un límite de 2 MB (cerca de 1,5 MB de imagen ya codificada)." }, "response": [] }, { "name": "Probar un formulario del borrador", "request": { "method": "POST", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/builder/form_submissions", "host": [ "{{baseUrl}}" ], "path": [ "v1", "builder", "form_submissions" ] }, "body": { "mode": "raw", "raw": "{\n \"form_id\": \"\",\n \"form_title\": \"\",\n \"page_path\": \"\",\n \"fields\": [\n {\n \"label\": \"\",\n \"name\": \"\",\n \"type\": \"text\",\n \"required\": false,\n \"pattern\": \"\"\n }\n ],\n \"action\": {\n \"type\": \"email\",\n \"email_to\": \"\",\n \"email_subject\": \"\",\n \"email_template\": \"\",\n \"webhook_endpoint_id\": \"\"\n },\n \"values\": {},\n \"submitter\": {\n \"name\": \"\",\n \"email\": \"\"\n }\n}", "options": { "raw": { "language": "json" } } }, "description": "Ejecuta la acción de un bloque Formulario como la vista previa del constructor: el correo configurado se envía de verdad (o el webhook elegido se dispara de verdad), marcado como `preview: true`. La configuración del formulario viene en el cuerpo. El correo de prueba va solo al correo del operador del token (un token sin operador no prueba la acción de correo). Limitado a 20 ejecuciones por minuto por operador, 60 por minuto y 500 por día por organización, compartiendo el límite con la vista previa del panel." }, "response": [] }, { "name": "Probar un botón de acción del borrador", "request": { "method": "POST", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/builder/action_runs", "host": [ "{{baseUrl}}" ], "path": [ "v1", "builder", "action_runs" ] }, "body": { "mode": "raw", "raw": "{\n \"block_id\": \"\",\n \"label\": \"\",\n \"page_path\": \"\",\n \"request\": {\n \"method\": \"POST\",\n \"url\": \"\",\n \"headers\": [\n {\n \"key\": \"\",\n \"value\": \"\"\n }\n ],\n \"body\": \"\"\n },\n \"submitter\": {\n \"name\": \"\",\n \"email\": \"\"\n }\n}", "options": { "raw": { "language": "json" } } }, "description": "Ejecuta el webhook de un Botón de acción como la vista previa del constructor: la solicitud sale de verdad, marcada como `preview: true`, y la respuesta trae el estado HTTP devuelto por el destino. Las cabeceras pueden llevar valores `secret:` creados por `POST /builder/secrets`, que solo se abren para el origen para el que fueron creados. Limitado a 20 ejecuciones por minuto por operador, 60 por minuto y 500 por día por organización." }, "response": [] }, { "name": "Listar los tipos de bloque", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/builder/tools/list_block_types", "host": [ "{{baseUrl}}" ], "path": [ "v1", "builder", "tools", "list_block_types" ] }, "description": "Lists the block catalog: every block type the portal can render, with what it is for. Only these types exist." }, "response": [] }, { "name": "Describir un tipo de bloque", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/builder/tools/describe_block_type?type=", "host": [ "{{baseUrl}}" ], "path": [ "v1", "builder", "tools", "describe_block_type" ], "query": [ { "key": "type", "value": "", "description": "Block type, e.g. DataTable.", "disabled": false } ] }, "description": "The props of one block type: JSON Schema, defaults and slots. Read it before inserting or changing a block you have not used yet." }, "response": [] }, { "name": "Listar las acciones del botón", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/builder/tools/list_actions", "host": [ "{{baseUrl}}" ], "path": [ "v1", "builder", "tools", "list_actions" ] }, "description": "What an ActionButton can do (its actionType): open a link (a portal page or a URL) or fire a webhook, and the {{variables}} its webhook URL, headers and body may use." }, "response": [] }, { "name": "Consultar los colores del tema", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/builder/tools/get_theme", "host": [ "{{baseUrl}}" ], "path": [ "v1", "builder", "tools", "get_theme" ] }, "description": "The colors of the portal pages (the Visual tab of the draft), in hex, for light and dark mode: what each color is for and its current value." }, "response": [] }, { "name": "Listar las páginas del borrador", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/builder/tools/list_pages", "host": [ "{{baseUrl}}" ], "path": [ "v1", "builder", "tools", "list_pages" ] }, "description": "Lists the pages of the draft in menu order: id, name, path, title and block count." }, "response": [] }, { "name": "Consultar una página del borrador", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/builder/tools/get_page?page_id=", "host": [ "{{baseUrl}}" ], "path": [ "v1", "builder", "tools", "get_page" ], "query": [ { "key": "page_id", "value": "", "description": "Page id (list_pages).", "disabled": false } ] }, "description": "One page of the draft: its settings (name, path, title, SEO) and its block tree, each block with id, type, props and slots." }, "response": [] }, { "name": "Leer el contenido de un archivo", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/builder/tools/read_asset?asset_id=00000000-0000-0000-0000-000000000000", "host": [ "{{baseUrl}}" ], "path": [ "v1", "builder", "tools", "read_asset" ], "query": [ { "key": "asset_id", "value": "00000000-0000-0000-0000-000000000000", "description": "Asset id (list_assets, or the asset_id of a file sent in the chat).", "disabled": false } ] }, "description": "Opens a file of the Assets library to look at its content: an image or a PDF is shown to you, a text file (txt, csv, json, md, xml) or an .xlsx spreadsheet comes as text. Word/PowerPoint/zip cannot be read (only their details)." }, "response": [] }, { "name": "Previsualizar el mapeo de usuarios del portal", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/builder/tools/preview_portal_user_mapping?entity=&tenant_id_field=&email_field=&name_field=", "host": [ "{{baseUrl}}" ], "path": [ "v1", "builder", "tools", "preview_portal_user_mapping" ], "query": [ { "key": "entity", "value": "", "description": "Entity key.", "disabled": false }, { "key": "tenant_id_field", "value": "", "description": "The value the other entities' owners hold (the owner field of the entity, or its identifier).", "disabled": false }, { "key": "email_field", "value": "", "description": "The field with the customer's e-mail.", "disabled": false }, { "key": "name_field", "value": "", "description": "The field with the customer's name, if any.", "disabled": true } ] }, "description": "Checks a portal user mapping before saving it with `dashboards_portal_user_mappings_update`: the entity whose records would become the portal users, its tenant ID, e-mail and name fields, how many users that is, and how the tenant IDs match the owners of the other entities' records. Saves nothing." }, "response": [] }, { "name": "Crear una página", "request": { "method": "POST", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/builder/tools/create_page", "host": [ "{{baseUrl}}" ], "path": [ "v1", "builder", "tools", "create_page" ] }, "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"path\": \"\",\n \"title\": \"\",\n \"template\": \"blank\",\n \"entity\": \"\",\n \"show_in_menu\": false,\n \"position\": 0,\n \"revision\": 0\n}", "options": { "raw": { "language": "json" } } }, "description": "Creates a page in the draft and adds it to the portal menu. template: blank (title only), list (title + KPIs + table of `entity`), detail (title + record detail + documents). The title is a PageHeader block: the answer lists the blocks it created — change them with update_block instead of inserting them again." }, "response": [] }, { "name": "Modificar una página", "request": { "method": "POST", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/builder/tools/update_page", "host": [ "{{baseUrl}}" ], "path": [ "v1", "builder", "tools", "update_page" ] }, "body": { "mode": "raw", "raw": "{\n \"page_id\": \"\",\n \"name\": \"\",\n \"path\": \"\",\n \"title\": \"\",\n \"show_in_menu\": false,\n \"seo\": {\n \"description\": \"\",\n \"keywords\": \"\",\n \"robots\": \"\",\n \"canonical\": \"\",\n \"og_title\": \"\",\n \"og_description\": \"\",\n \"og_image\": \"\"\n },\n \"revision\": 0\n}", "options": { "raw": { "language": "json" } } }, "description": "Changes the settings of a page: menu name, route, browser title, whether it is listed in the portal menu, and SEO / Open Graph tags. Only the fields sent change." }, "response": [] }, { "name": "Eliminar una página", "request": { "method": "POST", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/builder/tools/delete_page", "host": [ "{{baseUrl}}" ], "path": [ "v1", "builder", "tools", "delete_page" ] }, "body": { "mode": "raw", "raw": "{\n \"page_id\": \"\",\n \"revision\": 0\n}", "options": { "raw": { "language": "json" } } }, "description": "Removes a page (and its blocks) from the draft and from the menu. Only when the operator asks for it." }, "response": [] }, { "name": "Mover una página en el menú", "request": { "method": "POST", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/builder/tools/move_page", "host": [ "{{baseUrl}}" ], "path": [ "v1", "builder", "tools", "move_page" ] }, "body": { "mode": "raw", "raw": "{\n \"page_id\": \"\",\n \"position\": 0,\n \"revision\": 0\n}", "options": { "raw": { "language": "json" } } }, "description": "Moves a page to another place in the portal menu." }, "response": [] }, { "name": "Insertar un bloque", "request": { "method": "POST", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/builder/tools/insert_block", "host": [ "{{baseUrl}}" ], "path": [ "v1", "builder", "tools", "insert_block" ] }, "body": { "mode": "raw", "raw": "{\n \"page_id\": \"\",\n \"type\": \"\",\n \"props\": {},\n \"parent_block_id\": \"\",\n \"slot\": \"\",\n \"position\": 0,\n \"revision\": 0\n}", "options": { "raw": { "language": "json" } } }, "description": "Inserts a block of the catalog in a page: at the page root, or inside a slot of a Columns/Tabs block (parent_block_id + slot). Props not sent take the defaults." }, "response": [] }, { "name": "Modificar un bloque", "request": { "method": "POST", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/builder/tools/update_block", "host": [ "{{baseUrl}}" ], "path": [ "v1", "builder", "tools", "update_block" ] }, "body": { "mode": "raw", "raw": "{\n \"block_id\": \"\",\n \"props\": {},\n \"revision\": 0\n}", "options": { "raw": { "language": "json" } } }, "description": "Changes props of a block. Only the props sent change; the result is validated against the block type." }, "response": [] }, { "name": "Mover un bloque", "request": { "method": "POST", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/builder/tools/move_block", "host": [ "{{baseUrl}}" ], "path": [ "v1", "builder", "tools", "move_block" ] }, "body": { "mode": "raw", "raw": "{\n \"block_id\": \"\",\n \"parent_block_id\": \"\",\n \"slot\": \"\",\n \"position\": 0,\n \"revision\": 0\n}", "options": { "raw": { "language": "json" } } }, "description": "Moves a block inside its page: to another position at the root (parent_block_id null) or into a slot of a Columns/Tabs block." }, "response": [] }, { "name": "Quitar un bloque", "request": { "method": "POST", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/builder/tools/remove_block", "host": [ "{{baseUrl}}" ], "path": [ "v1", "builder", "tools", "remove_block" ] }, "body": { "mode": "raw", "raw": "{\n \"block_id\": \"\",\n \"revision\": 0\n}", "options": { "raw": { "language": "json" } } }, "description": "Removes a block (and the blocks inside it) from its page." }, "response": [] }, { "name": "Duplicar un bloque", "request": { "method": "POST", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/builder/tools/duplicate_block", "host": [ "{{baseUrl}}" ], "path": [ "v1", "builder", "tools", "duplicate_block" ] }, "body": { "mode": "raw", "raw": "{\n \"block_id\": \"\",\n \"revision\": 0\n}", "options": { "raw": { "language": "json" } } }, "description": "Copies a block (with the blocks inside it) right after itself, with new ids." }, "response": [] }, { "name": "Registrar una entidad desde una fuente de datos", "request": { "method": "POST", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/builder/tools/register_entity", "host": [ "{{baseUrl}}" ], "path": [ "v1", "builder", "tools", "register_entity" ] }, "body": { "mode": "raw", "raw": "{\n \"data_source_id\": \"00000000-0000-0000-0000-000000000000\",\n \"operation_key\": \"\",\n \"params\": {},\n \"key\": \"\",\n \"name\": \"\",\n \"name_plural\": \"\",\n \"fields\": [\n \"\"\n ],\n \"field_names\": {},\n \"owner_field\": \"\",\n \"owner_match\": \"external_id\"\n}", "options": { "raw": { "language": "json" } } }, "description": "Registers an entity (data blocks bind to it) from an operation of a connected data source (describe_data_source), with the fields inferred from a sample of its records, and starts its first sync. Use it when the operator wants data that no entity has yet. It takes effect in the workspace right away (it is not part of the draft); the new entity can be used by blocks in this same answer. The workspace caps how many fields a new entity keeps: when the source has more, the refusal lists every field with a sample value — call again with `fields` set to the ones the portal needs (what it shows, filters or sums, and whatever identifies the customer the record belongs to)." }, "response": [] }, { "name": "Renombrar los campos de una entidad", "request": { "method": "POST", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/builder/tools/rename_entity_fields", "host": [ "{{baseUrl}}" ], "path": [ "v1", "builder", "tools", "rename_entity_fields" ] }, "body": { "mode": "raw", "raw": "{\n \"entity\": \"\",\n \"names\": {},\n \"name\": \"\",\n \"name_plural\": \"\",\n \"owner_field\": \"\",\n \"owner_match\": \"external_id\"\n}", "options": { "raw": { "language": "json" } } }, "description": "Changes an existing entity: renames its fields — the labels the blocks show (table headers, card labels) — and, optionally, the entity itself, and can set its owner field (the titular: whose record it is). Use it when the labels came from the source in English or as raw keys (\"Expire at\", \"customer_cnpj_cpf\"): customers read them, so they go in Brazilian Portuguese; and when the owner is wrong or missing (a customers entity owns its records by its own id). Keys stay; a new owner maps the stored records again. It takes effect in the workspace right away, not in the draft." }, "response": [] }, { "name": "Guardar un campo calculado", "request": { "method": "POST", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/builder/tools/save_computed_field", "host": [ "{{baseUrl}}" ], "path": [ "v1", "builder", "tools", "save_computed_field" ] }, "body": { "mode": "raw", "raw": "{\n \"entity\": \"\",\n \"key\": \"\",\n \"name\": \"\",\n \"expression\": \"\",\n \"data_type\": \"string\"\n}", "options": { "raw": { "language": "json" } } }, "description": "Adds a computed field to an entity — a value derived from the other fields by an expression (n8n style) — or changes the expression of a computed field it already has (same key). Use it when the operator wants a value the source does not give as is: part of a text, a join of fields, a formatted date or amount, a label from a condition. It is tried on stored records first (an expression that fails on all of them is refused, nothing saved), then saved to the entity in the workspace right away (not part of the draft) and computed on every stored record from the data it already has (no new fetch from the source). Blocks and sample_records see it in this same answer." }, "response": [] }, { "name": "Restaurar una versión en el borrador", "request": { "method": "POST", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/builder/versions/:number/restore", "host": [ "{{baseUrl}}" ], "path": [ "v1", "builder", "versions", ":number", "restore" ], "variable": [ { "key": "number", "value": "3" } ] }, "body": { "mode": "raw", "raw": "{\n \"revision\": 0\n}", "options": { "raw": { "language": "json" } } }, "description": "Copia una versión publicada al borrador, reemplazando sus páginas — para seguir editando desde una versión antigua. Nada se publica: el portal solo cambia cuando se publique el borrador. (Poner una versión antigua en línea es `.../rollback`.) `revision` es opcional: enviada y desactualizada, responde 409." }, "response": [] }, { "name": "Modificar los colores del tema del portal", "request": { "method": "PATCH", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/builder/theme", "host": [ "{{baseUrl}}" ], "path": [ "v1", "builder", "theme" ] }, "body": { "mode": "raw", "raw": "{\n \"light\": {\n \"primary\": \"\",\n \"primary_foreground\": \"\",\n \"accent\": \"\",\n \"background\": \"\",\n \"foreground\": \"\",\n \"card\": \"\",\n \"muted\": \"\",\n \"muted_foreground\": \"\",\n \"border\": \"\"\n },\n \"dark\": {\n \"primary\": \"\",\n \"primary_foreground\": \"\",\n \"accent\": \"\",\n \"background\": \"\",\n \"foreground\": \"\",\n \"card\": \"\",\n \"muted\": \"\",\n \"muted_foreground\": \"\",\n \"border\": \"\"\n }\n}", "options": { "raw": { "language": "json" } } }, "description": "Cambia colores del tema de las páginas del portal (la pestaña Visual del constructor) en el borrador, por modo, en hex. Solo cambian los colores enviados; el portal publicado cambia cuando se publique el borrador. Para leer los colores actuales, y para qué sirve cada uno, usa `GET /builder/tools/get_theme`." }, "response": [] } ] }, { "name": "Configuración del Portal", "item": [ { "name": "Obtener configuración del portal", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/portal_settings", "host": [ "{{baseUrl}}" ], "path": [ "v1", "portal_settings" ] }, "description": "Devuelve la configuración del portal del workspace: marca, idioma de la página, colores, dirección, opciones de inicio de sesión y SSO, notificaciones y remitente, y configuración del sitio (cabeceras de seguridad, SEO, rastreadores, chat y código propio)." }, "response": [] }, { "name": "Actualizar configuración del portal", "request": { "method": "PATCH", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/portal_settings", "host": [ "{{baseUrl}}" ], "path": [ "v1", "portal_settings" ] }, "body": { "mode": "raw", "raw": "{\n \"company_name\": \"\",\n \"title\": \"\",\n \"subtitle\": \"\",\n \"html_lang\": \"pt-BR\",\n \"light_colors\": {\n \"primary\": \"222 47% 11%\"\n },\n \"signup_slug\": \"\",\n \"enable_login\": false,\n \"enable_email_login\": false,\n \"allow_password_change\": false,\n \"sso_enabled\": false,\n \"sso_public_key\": \"\",\n \"sso_algorithm\": \"RS256\",\n \"sso_issuer\": \"\",\n \"notification_type_statuses\": {\n \"account_suspended\": \"ACTIVE\",\n \"account_activated\": \"ACTIVE\",\n \"portal_invitation\": \"ACTIVE\",\n \"welcome\": \"ACTIVE\"\n },\n \"notification_bcc_emails\": [\n {\n \"label\": \"\",\n \"address\": \"user@example.com\"\n }\n ],\n \"notification_sender_name\": \"\",\n \"notification_sender_email\": \"\",\n \"notification_reply_to_email\": \"\",\n \"hsts_include_subdomains\": false,\n \"hsts_preload\": false,\n \"secure_frame_headers\": false,\n \"seo_indexing_enabled\": false,\n \"seo_robots_txt\": \"\",\n \"seo_sitemap_enabled\": false,\n \"seo_google_site_verification\": \"\",\n \"seo_canonical_url\": \"\",\n \"tracking_integrations\": {},\n \"chat_integrations\": {},\n \"custom_code\": \"\"\n}", "options": { "raw": { "language": "json" } } }, "description": "Actualiza la configuración del portal del workspace. Parcial: solo cambian los campos enviados. Devuelve la configuración completa." }, "response": [] }, { "name": "Subir imagen del portal", "request": { "method": "POST", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/portal_settings/logo", "host": [ "{{baseUrl}}" ], "path": [ "v1", "portal_settings", "logo" ] }, "body": { "mode": "raw", "raw": "{\n \"filename\": \"logo.png\",\n \"content_type\": \"image/png\",\n \"content_base64\": \"\",\n \"variant\": \"logo\"\n}", "options": { "raw": { "language": "json" } } }, "description": "Sube el logo, el logo para fondos oscuros o el favicon del portal, en base64 en el cuerpo JSON. Reemplaza la imagen anterior." }, "response": [] }, { "name": "Eliminar imagen del portal", "request": { "method": "DELETE", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/portal_settings/logo?variant=logo", "host": [ "{{baseUrl}}" ], "path": [ "v1", "portal_settings", "logo" ], "query": [ { "key": "variant", "value": "logo", "disabled": true } ] }, "description": "Elimina el logo, el logo para fondos oscuros o el favicon; el portal vuelve al predeterminado." }, "response": [] }, { "name": "Definir dirección del portal", "request": { "method": "PATCH", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/portal_settings/domain", "host": [ "{{baseUrl}}" ], "path": [ "v1", "portal_settings", "domain" ] }, "body": { "mode": "raw", "raw": "{\n \"slug\": \"acme\",\n \"domain\": \"\"\n}", "options": { "raw": { "language": "json" } } }, "description": "Define la dirección del portal en la plataforma, `https://{slug}.{domain}`, o la elimina cuando ambos son `null`." }, "response": [] }, { "name": "Verificar disponibilidad de la dirección", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/portal_settings/domain/check_slug?slug=acme&domain=", "host": [ "{{baseUrl}}" ], "path": [ "v1", "portal_settings", "domain", "check_slug" ], "query": [ { "key": "slug", "value": "acme", "disabled": false }, { "key": "domain", "value": "", "disabled": false } ] }, "description": "Indica si `slug.domain` está libre para el portal de este workspace (su dirección actual cuenta como libre)." }, "response": [] }, { "name": "Verificar remitente de las notificaciones", "request": { "method": "POST", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/portal_settings/sender_identity", "host": [ "{{baseUrl}}" ], "path": [ "v1", "portal_settings", "sender_identity" ] }, "description": "Solicita o consulta la verificación del remitente en AWS SES. Si la dirección nunca se envió a SES o la verificación falló, SES le envía un enlace de confirmación; si no, consulta el estado actual." }, "response": [] } ] }, { "name": "Dominios Propios del Portal", "item": [ { "name": "Listar dominios propios", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/portal_custom_domains", "host": [ "{{baseUrl}}" ], "path": [ "v1", "portal_custom_domains" ] }, "description": "Lista los dominios propios del portal del workspace (conjunto completo, sin paginación). Vacía donde los dominios propios no son compatibles." }, "response": [] }, { "name": "Agregar dominio propio", "request": { "method": "POST", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/portal_custom_domains", "host": [ "{{baseUrl}}" ], "path": [ "v1", "portal_custom_domains" ] }, "body": { "mode": "raw", "raw": "{\n \"hostname\": \"portal.example.com\"\n}", "options": { "raw": { "language": "json" } } }, "description": "Registra un dominio propio como `pending_verification`, sin tocar AWS, y devuelve los registros DNS a publicar. Luego llame a `POST /portal_custom_domains/{id}/verify`. El registro es solo un reclamo: el dominio queda con el primer portal que publique su TXT de verificación (los demás reclamos no comprobados se liberan), y un reclamo no comprobado vence a los 7 días. Cada portal tiene como máximo 10 dominios. Los dominios de la plataforma (`kobana.com.br`, `kobana.tech` y los dominios compartidos de portal) no se aceptan. 403 donde los dominios propios no están disponibles." }, "response": [] }, { "name": "Eliminar dominio propio", "request": { "method": "DELETE", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/portal_custom_domains/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "portal_custom_domains", ":id" ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" } ] }, "description": "Elimina el dominio propio y deshace su tenant de CloudFront y el certificado, cuando están aprovisionados. El portal deja de responder en esa dirección." }, "response": [] }, { "name": "Verificar y aprovisionar dominio propio", "request": { "method": "POST", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/portal_custom_domains/:id/verify", "host": [ "{{baseUrl}}" ], "path": [ "v1", "portal_custom_domains", ":id", "verify" ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" } ] }, "description": "Mientras está pendiente, verifica el DNS y aprovisiona el dominio en AWS (certificado y tenant de CloudFront); una vez aprovisionado, actualiza su estado. Devuelve el dominio con su nuevo `status`." }, "response": [] }, { "name": "Consultar DNS del dominio propio", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/portal_custom_domains/:id/dns_status", "host": [ "{{baseUrl}}" ], "path": [ "v1", "portal_custom_domains", ":id", "dns_status" ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" } ] }, "description": "Consulta de solo lectura de los CNAME requeridos, registro por registro, sin cambiar nada en AWS." }, "response": [] } ] }, { "name": "Proveedores OIDC del Portal", "item": [ { "name": "Listar proveedores OIDC", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/portal_oauth_providers", "host": [ "{{baseUrl}}" ], "path": [ "v1", "portal_oauth_providers" ] }, "description": "Lista los proveedores OpenID Connect con los que los usuarios entran al portal (conjunto completo, sin paginación)." }, "response": [] }, { "name": "Agregar proveedor OIDC", "request": { "method": "POST", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/portal_oauth_providers", "host": [ "{{baseUrl}}" ], "path": [ "v1", "portal_oauth_providers" ] }, "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"button_label\": \"\",\n \"issuer_url\": \"https://example.com\",\n \"client_id\": \"\",\n \"client_secret\": \"\",\n \"scopes\": \"\",\n \"email_claim\": \"\",\n \"enabled\": false\n}", "options": { "raw": { "language": "json" } } }, "description": "Agrega un proveedor OpenID Connect al inicio de sesión del portal." }, "response": [] }, { "name": "Actualizar proveedor OIDC", "request": { "method": "PATCH", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/portal_oauth_providers/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "portal_oauth_providers", ":id" ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" } ] }, "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"button_label\": \"\",\n \"issuer_url\": \"https://example.com\",\n \"client_id\": \"\",\n \"client_secret\": \"\",\n \"scopes\": \"\",\n \"email_claim\": \"\",\n \"enabled\": false\n}", "options": { "raw": { "language": "json" } } }, "description": "Actualiza un proveedor OpenID Connect. Parcial: solo cambian los campos enviados." }, "response": [] }, { "name": "Eliminar proveedor OIDC", "request": { "method": "DELETE", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/portal_oauth_providers/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "portal_oauth_providers", ":id" ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" } ] }, "description": "Elimina el proveedor; su botón desaparece del inicio de sesión y nadie más puede entrar por él." }, "response": [] }, { "name": "Probar emisor OIDC", "request": { "method": "POST", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/portal_oauth_providers/test", "host": [ "{{baseUrl}}" ], "path": [ "v1", "portal_oauth_providers", "test" ] }, "body": { "mode": "raw", "raw": "{\n \"issuer_url\": \"https://example.com\"\n}", "options": { "raw": { "language": "json" } } }, "description": "Obtiene el documento de descubrimiento del emisor e informa sus endpoints, para validar la URL antes de guardar. Una falla en el descubrimiento es un 200 con `ok: false`." }, "response": [] } ] }, { "name": "Webhooks", "item": [ { "name": "Listar endpoints de webhook", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/webhooks?page=1&per_page=20&sort_by=&sort_order=asc&status=active&search=", "host": [ "{{baseUrl}}" ], "path": [ "v1", "webhooks" ], "query": [ { "key": "page", "value": "1", "disabled": true }, { "key": "per_page", "value": "20", "disabled": true }, { "key": "sort_by", "value": "", "disabled": true }, { "key": "sort_order", "value": "asc", "disabled": true }, { "key": "status", "value": "active", "disabled": true }, { "key": "search", "value": "", "disabled": true } ] }, "description": "Lista los endpoints de webhook del workspace, del más reciente al más antiguo, con el total de entregas de cada uno." }, "response": [] }, { "name": "Crear endpoint de webhook", "request": { "method": "POST", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/webhooks", "host": [ "{{baseUrl}}" ], "path": [ "v1", "webhooks" ] }, "body": { "mode": "raw", "raw": "{\n \"url\": \"https://example.com/webhooks\",\n \"events\": [\n \"api_key.db.created\"\n ],\n \"description\": \"\",\n \"auth_type\": \"none\",\n \"auth_config\": {\n \"token\": \"token-123\"\n }\n}", "options": { "raw": { "language": "json" } } }, "description": "Crea un endpoint activo en el workspace. La respuesta trae el `secret` de firma — solo aparece aquí (y en la rotación)." }, "response": [] }, { "name": "Consultar endpoint de webhook", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/webhooks/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "webhooks", ":id" ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" } ] }, "description": "Devuelve un endpoint de webhook del workspace. Las entregas están en `GET /webhooks/{id}/deliveries`." }, "response": [] }, { "name": "Actualizar endpoint de webhook", "request": { "method": "PATCH", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/webhooks/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "webhooks", ":id" ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" } ] }, "body": { "mode": "raw", "raw": "{\n \"url\": \"\",\n \"events\": [\n \"\"\n ],\n \"description\": \"\",\n \"active\": false,\n \"auth_type\": \"none\",\n \"auth_config\": {\n \"token\": \"token-123\"\n }\n}", "options": { "raw": { "language": "json" } } }, "description": "Cambia la URL, la descripción, los eventos suscritos, `active` o la autenticación. Los campos ausentes quedan como están. Cuando la `url` cambia de origen, de ruta o de query string (el orden de los parámetros no cuenta) y `auth_type` no viene en la misma solicitud, las credenciales guardadas se descartan (`auth_type` pasa a `none`): fueron dadas para el destino anterior. El secreto de firma se mantiene — use `rotate_secret` si el endpoint cambió de dueño." }, "response": [] }, { "name": "Eliminar endpoint de webhook", "request": { "method": "DELETE", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/webhooks/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "webhooks", ":id" ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" } ] }, "description": "Elimina el endpoint definitivamente, junto con el log de entregas. Los eventos dejan de enviarse de inmediato." }, "response": [] }, { "name": "Enviar webhook de prueba", "request": { "method": "POST", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/webhooks/:id/test", "host": [ "{{baseUrl}}" ], "path": [ "v1", "webhooks", ":id", "test" ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" } ] }, "description": "Envía ahora un evento `test.webhook` firmado a la URL del endpoint y lo registra en el log de entregas. Responde 200 con `success: false` cuando el endpoint responde fuera de 2xx o no se alcanza, y 422 cuando la URL apunta a una dirección bloqueada (red privada)." }, "response": [] }, { "name": "Rotar el secreto del webhook", "request": { "method": "POST", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/webhooks/:id/rotate_secret", "host": [ "{{baseUrl}}" ], "path": [ "v1", "webhooks", ":id", "rotate_secret" ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" } ] }, "description": "Genera un nuevo secreto de firma. El anterior deja de valer de inmediato; el nuevo `secret` solo aparece en esta respuesta." }, "response": [] }, { "name": "Listar entregas de un webhook", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/webhooks/:id/deliveries?page=1&per_page=20&sort_by=&sort_order=asc&status=pending", "host": [ "{{baseUrl}}" ], "path": [ "v1", "webhooks", ":id", "deliveries" ], "query": [ { "key": "page", "value": "1", "disabled": true }, { "key": "per_page", "value": "20", "disabled": true }, { "key": "sort_by", "value": "", "disabled": true }, { "key": "sort_order", "value": "asc", "disabled": true }, { "key": "status", "value": "pending", "disabled": true } ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" } ] }, "description": "Log de entregas de un endpoint, de la más reciente a la más antigua." }, "response": [] }, { "name": "Reintentar entrega de webhook", "request": { "method": "POST", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/webhooks/:id/deliveries/:delivery_id/retry", "host": [ "{{baseUrl}}" ], "path": [ "v1", "webhooks", ":id", "deliveries", ":delivery_id", "retry" ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" }, { "key": "delivery_id", "value": "00000000-0000-0000-0000-000000000000" } ] }, "description": "Devuelve la entrega a `pending` y la encola para un nuevo envío. El envío es asíncrono: siga el resultado en el log de entregas." }, "response": [] }, { "name": "Listar entregas de webhook", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/webhook_deliveries?page=1&per_page=20&sort_by=&sort_order=asc&status=pending&webhook_id=00000000-0000-0000-0000-000000000000&date_from=&date_to=", "host": [ "{{baseUrl}}" ], "path": [ "v1", "webhook_deliveries" ], "query": [ { "key": "page", "value": "1", "disabled": true }, { "key": "per_page", "value": "20", "disabled": true }, { "key": "sort_by", "value": "", "disabled": true }, { "key": "sort_order", "value": "asc", "disabled": true }, { "key": "status", "value": "pending", "disabled": true }, { "key": "webhook_id", "value": "00000000-0000-0000-0000-000000000000", "disabled": true }, { "key": "date_from", "value": "", "disabled": true }, { "key": "date_to", "value": "", "disabled": true } ] }, "description": "Entregas de todos los endpoints del workspace, de la más reciente a la más antigua, con el tipo de evento y el resumen del endpoint." }, "response": [] }, { "name": "Consultar entrega de webhook", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/webhook_deliveries/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "webhook_deliveries", ":id" ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" } ] }, "description": "Devuelve una entrega: la solicitud (redactada), la respuesta, los intentos y el endpoint de destino." }, "response": [] } ] }, { "name": "Eventos", "item": [ { "name": "Listar eventos", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/events?page=1&per_page=20&sort_by=&sort_order=asc&type=&resource_type=&resource_id=00000000-0000-0000-0000-000000000000&date_from=&date_to=", "host": [ "{{baseUrl}}" ], "path": [ "v1", "events" ], "query": [ { "key": "page", "value": "1", "disabled": true }, { "key": "per_page", "value": "20", "disabled": true }, { "key": "sort_by", "value": "", "disabled": true }, { "key": "sort_order", "value": "asc", "disabled": true }, { "key": "type", "value": "", "disabled": true }, { "key": "resource_type", "value": "", "disabled": true }, { "key": "resource_id", "value": "00000000-0000-0000-0000-000000000000", "disabled": true }, { "key": "date_from", "value": "", "disabled": true }, { "key": "date_to", "value": "", "disabled": true } ] }, "description": "Log de eventos del workspace y de la organización, del más reciente al más antiguo. Los eventos son evidencia: no se pueden cambiar ni eliminar." }, "response": [] }, { "name": "Consultar evento", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/events/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "events", ":id" ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" } ] }, "description": "Devuelve un evento con el payload completo." }, "response": [] } ] }, { "name": "Auditoría", "item": [ { "name": "Listar registros de auditoría", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/audit_logs?page=1&per_page=20&sort_by=&sort_order=asc&user_id=&action=&resource_type=&resource_id=&search=&date_from=&date_to=", "host": [ "{{baseUrl}}" ], "path": [ "v1", "audit_logs" ], "query": [ { "key": "page", "value": "1", "disabled": true }, { "key": "per_page", "value": "20", "disabled": true }, { "key": "sort_by", "value": "", "disabled": true }, { "key": "sort_order", "value": "asc", "disabled": true }, { "key": "user_id", "value": "", "disabled": true }, { "key": "action", "value": "", "disabled": true }, { "key": "resource_type", "value": "", "disabled": true }, { "key": "resource_id", "value": "", "disabled": true }, { "key": "search", "value": "", "disabled": true }, { "key": "date_from", "value": "", "disabled": true }, { "key": "date_to", "value": "", "disabled": true } ] }, "description": "Auditoría del workspace y de la organización, del más reciente al más antiguo. La auditoría no se puede cambiar." }, "response": [] }, { "name": "Resumen de la actividad auditada", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/audit_logs/summary?hours=24", "host": [ "{{baseUrl}}" ], "path": [ "v1", "audit_logs", "summary" ], "query": [ { "key": "hours", "value": "24", "disabled": true } ] }, "description": "Actividad de las últimas `hours` horas: total de registros, las 10 acciones más frecuentes y los 20 registros más recientes. Requiere el permiso de exportar auditoría." }, "response": [] }, { "name": "Consultar registro de auditoría", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/audit_logs/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "audit_logs", ":id" ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" } ] }, "description": "Devuelve un registro de auditoría con los valores anteriores y nuevos." }, "response": [] } ] }, { "name": "Plantillas de Correo", "item": [ { "name": "Listar plantillas de correo", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/email_templates?type=api_key_expiring&is_active=true", "host": [ "{{baseUrl}}" ], "path": [ "v1", "email_templates" ], "query": [ { "key": "type", "value": "api_key_expiring", "disabled": true }, { "key": "is_active", "value": "true", "disabled": true } ] }, "description": "Lista las plantillas de correo de la propia organización, ordenadas por tipo y nombre. Devuelve el conjunto completo, sin paginación." }, "response": [] }, { "name": "Crear plantilla de correo", "request": { "method": "POST", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/email_templates", "host": [ "{{baseUrl}}" ], "path": [ "v1", "email_templates" ] }, "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"type\": \"api_key_expiring\",\n \"subject\": \"\",\n \"html_body\": \"\",\n \"text_body\": \"\",\n \"bcc\": [\n \"\"\n ],\n \"variables\": [\n \"\"\n ],\n \"is_active\": false\n}", "options": { "raw": { "language": "json" } } }, "description": "Crea una plantilla para un tipo de notificación. Queda como borrador, salvo que `is_active` sea `true` — entonces la plantilla activa anterior del tipo pasa a borrador." }, "response": [] }, { "name": "Restaurar plantillas predeterminadas", "request": { "method": "POST", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/email_templates/init_defaults", "host": [ "{{baseUrl}}" ], "path": [ "v1", "email_templates", "init_defaults" ] }, "description": "Crea o restaura la plantilla de cada tipo de notificación con el contenido predeterminado y la activa. Sobrescribe el contenido de las plantillas existentes de la organización." }, "response": [] }, { "name": "Consultar plantilla de correo", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/email_templates/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "email_templates", ":id" ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" } ] }, "description": "Devuelve una plantilla de la organización o una predeterminada de la plataforma." }, "response": [] }, { "name": "Actualizar plantilla de correo", "request": { "method": "PATCH", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/email_templates/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "email_templates", ":id" ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" } ] }, "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"subject\": \"\",\n \"html_body\": \"\",\n \"text_body\": \"\",\n \"bcc\": [\n \"\"\n ],\n \"variables\": [\n \"\"\n ],\n \"is_active\": false,\n \"public_id\": \"00000000-0000-0000-0000-000000000000\"\n}", "options": { "raw": { "language": "json" } } }, "description": "Actualiza una plantilla de la organización. Solo cambian los campos enviados. Las predeterminadas de la plataforma no se pueden modificar (404)." }, "response": [] }, { "name": "Eliminar plantilla de correo", "request": { "method": "DELETE", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/email_templates/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "email_templates", ":id" ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" } ] }, "description": "Elimina definitivamente una plantilla inactiva de la organización. La plantilla activa de un tipo no se puede eliminar (422): active otra antes." }, "response": [] }, { "name": "Duplicar plantilla de correo", "request": { "method": "POST", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/email_templates/:id/duplicate", "host": [ "{{baseUrl}}" ], "path": [ "v1", "email_templates", ":id", "duplicate" ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" } ] }, "body": { "mode": "raw", "raw": "{\n \"new_name\": \"\"\n}", "options": { "raw": { "language": "json" } } }, "description": "Copia una plantilla como borrador (inactiva)." }, "response": [] }, { "name": "Previsualizar plantilla de correo", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/email_templates/:id/preview", "host": [ "{{baseUrl}}" ], "path": [ "v1", "email_templates", ":id", "preview" ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" } ] }, "description": "Renderiza la plantilla con datos de ejemplo, dentro del diseño de la organización. No se envía nada." }, "response": [] }, { "name": "Renderizar plantilla con variables", "request": { "method": "POST", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/email_templates/:id/preview", "host": [ "{{baseUrl}}" ], "path": [ "v1", "email_templates", ":id", "preview" ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" } ] }, "body": { "mode": "raw", "raw": "{\n \"variables\": {}\n}", "options": { "raw": { "language": "json" } } }, "description": "Renderiza la plantilla con las `variables` enviadas, sin diseño. No se envía nada." }, "response": [] } ] }, { "name": "Diseños de Correo", "item": [ { "name": "Listar diseños de correo", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/email_layouts", "host": [ "{{baseUrl}}" ], "path": [ "v1", "email_layouts" ] }, "description": "Lista los diseños de correo de la organización, el predeterminado primero. Devuelve el conjunto completo, sin paginación." }, "response": [] }, { "name": "Crear diseño de correo", "request": { "method": "POST", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/email_layouts", "host": [ "{{baseUrl}}" ], "path": [ "v1", "email_layouts" ] }, "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"html_body\": \"\",\n \"is_default\": false\n}", "options": { "raw": { "language": "json" } } }, "description": "Crea un diseño. El HTML debe contener el marcador `{{content}}`." }, "response": [] }, { "name": "Crear diseño predeterminado", "request": { "method": "POST", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/email_layouts/init_defaults", "host": [ "{{baseUrl}}" ], "path": [ "v1", "email_layouts", "init_defaults" ] }, "description": "Garantiza que la organización tenga un diseño predeterminado: devuelve el actual o crea el incorporado. Nunca sobrescribe un diseño." }, "response": [] }, { "name": "Consultar diseño de correo", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/email_layouts/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "email_layouts", ":id" ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" } ] }, "description": "Devuelve un diseño de la organización." }, "response": [] }, { "name": "Actualizar diseño de correo", "request": { "method": "PATCH", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/email_layouts/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "email_layouts", ":id" ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" } ] }, "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"html_body\": \"\",\n \"is_default\": false,\n \"is_active\": false\n}", "options": { "raw": { "language": "json" } } }, "description": "Actualiza nombre, HTML (que debe mantener `{{content}}`), predeterminado o activo. Solo cambian los campos enviados." }, "response": [] }, { "name": "Eliminar diseño de correo", "request": { "method": "DELETE", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/email_layouts/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "email_layouts", ":id" ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" } ] }, "description": "Elimina definitivamente un diseño. Los correos pasan a usar el diseño predeterminado (o el incorporado)." }, "response": [] } ] }, { "name": "Notificaciones", "item": [ { "name": "Listar notificaciones", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/notifications?page=1&per_page=20&sort_by=&sort_order=asc&type=api_key_expiring&channel=email&status=pending&created_after=&created_before=&search=", "host": [ "{{baseUrl}}" ], "path": [ "v1", "notifications" ], "query": [ { "key": "page", "value": "1", "disabled": true }, { "key": "per_page", "value": "20", "disabled": true }, { "key": "sort_by", "value": "", "disabled": true }, { "key": "sort_order", "value": "asc", "disabled": true }, { "key": "type", "value": "api_key_expiring", "disabled": true }, { "key": "channel", "value": "email", "disabled": true }, { "key": "status", "value": "pending", "disabled": true }, { "key": "created_after", "value": "", "disabled": true }, { "key": "created_before", "value": "", "disabled": true }, { "key": "search", "value": "", "disabled": true } ] }, "description": "Lista las notificaciones del workspace y las de toda la organización, de las más nuevas a las más antiguas." }, "response": [] }, { "name": "Crear notificación", "request": { "method": "POST", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/notifications", "host": [ "{{baseUrl}}" ], "path": [ "v1", "notifications" ] }, "body": { "mode": "raw", "raw": "{\n \"type\": \"api_key_expiring\",\n \"recipient\": \"\",\n \"channel\": \"email\",\n \"portal_user_id\": \"00000000-0000-0000-0000-000000000000\",\n \"resource_type\": \"\",\n \"resource_id\": \"00000000-0000-0000-0000-000000000000\",\n \"scheduled_for\": \"2026-01-01T00:00:00Z\",\n \"variables\": {}\n}", "options": { "raw": { "language": "json" } } }, "description": "Renderiza la plantilla activa del tipo con las variables, guarda la notificación y la envía en el momento — la respuesta trae el resultado (`sent`, o `failed` con `failure_reason`). Con un `scheduled_for` en el futuro, queda `pending` hasta la hora marcada. Cada creación cuenta en el límite de envíos manuales por destinatario (429)." }, "response": [] }, { "name": "Estadísticas de notificaciones", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/notifications/stats?days=30", "host": [ "{{baseUrl}}" ], "path": [ "v1", "notifications", "stats" ], "query": [ { "key": "days", "value": "30", "disabled": true } ] }, "description": "Conteos por estado, tipo y canal de las notificaciones creadas en los últimos `days` días, con las tasas de entrega y de lectura." }, "response": [] }, { "name": "Enviar notificación", "request": { "method": "POST", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/notifications/:id/send", "host": [ "{{baseUrl}}" ], "path": [ "v1", "notifications", ":id", "send" ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" } ] }, "description": "Envía ahora una notificación guardada: el primer envío de una `pending` (programada) o `skipped`, o el reenvío de una `sent`, `delivered`, `read` o `failed`. Cada llamada envía el correo de nuevo y cuenta en el límite de envíos manuales por destinatario (429)." }, "response": [] } ] }, { "name": "Claves de API", "item": [ { "name": "Listar claves de API", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/api_keys?page=1&per_page=20&sort_by=&sort_order=asc&status=active", "host": [ "{{baseUrl}}" ], "path": [ "v1", "api_keys" ], "query": [ { "key": "page", "value": "1", "disabled": true }, { "key": "per_page", "value": "20", "disabled": true }, { "key": "sort_by", "value": "", "disabled": true }, { "key": "sort_order", "value": "asc", "disabled": true }, { "key": "status", "value": "active", "disabled": true } ] }, "description": "Lista las claves de API (`kb_…`) de la organización, sin el secreto. Estas claves ya no autentican la API v1 ni el MCP — ambos usan tokens de acceso emitidos por el servidor de autorización de Kobana; los registros siguen como inventario de claves de la organización (ciclo de vida, avisos de vencimiento y webhooks `api_key.*`). Recurso de la organización: ignora `X-Workspace-Id`." }, "response": [] }, { "name": "Crear clave de API", "request": { "method": "POST", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/api_keys", "host": [ "{{baseUrl}}" ], "path": [ "v1", "api_keys" ] }, "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"description\": \"\",\n \"source\": \"api\",\n \"notification_emails\": [\n \"\"\n ],\n \"expires_at\": \"2026-01-01T00:00:00Z\"\n}", "options": { "raw": { "language": "json" } } }, "description": "Crea una clave activa, válida por un año salvo `expires_at`. El secreto (`key`) vuelve UNA sola vez en esta respuesta — solo se guarda su hash. Exige una persona que alcance todos los workspaces (dueña de la organización o con acceso a cada uno), como en el panel." }, "response": [] }, { "name": "Consultar clave de API", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/api_keys/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "api_keys", ":id" ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" } ] }, "description": "Devuelve una clave de la organización — metadatos y marcas del ciclo de vida, nunca el secreto." }, "response": [] }, { "name": "Actualizar clave de API", "request": { "method": "PATCH", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/api_keys/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "api_keys", ":id" ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" } ] }, "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"description\": \"\",\n \"source\": \"api\",\n \"notification_emails\": [\n \"\"\n ],\n \"expires_at\": \"2026-01-01T00:00:00Z\",\n \"enabled\": false\n}", "options": { "raw": { "language": "json" } } }, "description": "Edita nombre, descripción, origen, correos de aviso y vencimiento, y/o activa ⇄ desactiva la clave con `enabled`. Una clave revocada es definitiva (409)." }, "response": [] }, { "name": "Eliminar clave revocada", "request": { "method": "DELETE", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/api_keys/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "api_keys", ":id" ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" } ] }, "description": "Quita de la lista una clave YA REVOCADA (borrado lógico; el historial se conserva). Una clave activa o desactivada debe revocarse antes (409)." }, "response": [] }, { "name": "Revocar clave de API", "request": { "method": "POST", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/api_keys/:id/revoke", "host": [ "{{baseUrl}}" ], "path": [ "v1", "api_keys", ":id", "revoke" ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" } ] }, "description": "Revoca la clave de forma definitiva — no puede reactivarse. 409 si ya está revocada." }, "response": [] }, { "name": "Rotar clave de API", "request": { "method": "POST", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/api_keys/:id/rotate", "host": [ "{{baseUrl}}" ], "path": [ "v1", "api_keys", ":id", "rotate" ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" } ] }, "body": { "mode": "raw", "raw": "{\n \"grace_days\": 0\n}", "options": { "raw": { "language": "json" } } }, "description": "Emite una clave sucesora (mismo nombre y configuración) y mantiene la anterior funcionando durante `grace_days` días (por defecto 7, máximo 30). Solo una clave activa puede rotarse (409). El nuevo secreto vuelve UNA sola vez." }, "response": [] } ] }, { "name": "Exportaciones", "item": [ { "name": "Listar exportaciones", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/exports?page=1&per_page=20&sort_by=&sort_order=asc&resource_type=&status=pending", "host": [ "{{baseUrl}}" ], "path": [ "v1", "exports" ], "query": [ { "key": "page", "value": "1", "disabled": true }, { "key": "per_page", "value": "20", "disabled": true }, { "key": "sort_by", "value": "", "disabled": true }, { "key": "sort_order", "value": "asc", "disabled": true }, { "key": "resource_type", "value": "", "disabled": true }, { "key": "status", "value": "pending", "disabled": true } ] }, "description": "Lista las solicitudes de exportación del workspace." }, "response": [] }, { "name": "Solicitar exportación", "request": { "method": "POST", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/exports", "host": [ "{{baseUrl}}" ], "path": [ "v1", "exports" ] }, "body": { "mode": "raw", "raw": "{\n \"resource_type\": \"portal_users\",\n \"format\": \"csv\",\n \"filters\": {}\n}", "options": { "raw": { "language": "json" } } }, "description": "Programa la exportación de los usuarios del portal del workspace en CSV, XLSX o JSON. Asíncrono: responde 202 con la exportación `pending`; consulte `GET /exports/{id}` hasta `completed` y descargue en `/download`. El archivo vence en 7 días." }, "response": [] }, { "name": "Consultar exportación", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/exports/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "exports", ":id" ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" } ] }, "description": "Estado y metadatos de una solicitud de exportación." }, "response": [] }, { "name": "Descargar archivo de la exportación", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/exports/:id/download", "host": [ "{{baseUrl}}" ], "path": [ "v1", "exports", ":id", "download" ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" } ] }, "description": "Devuelve el archivo de una exportación terminada (el panel redirige a una URL firmada; la API entrega los bytes). 404 mientras no esté lista." }, "response": [] } ] }, { "name": "Importaciones", "item": [ { "name": "Listar importaciones", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/imports?page=1&per_page=20&sort_by=&sort_order=asc&resource_type=&status=pending", "host": [ "{{baseUrl}}" ], "path": [ "v1", "imports" ], "query": [ { "key": "page", "value": "1", "disabled": true }, { "key": "per_page", "value": "20", "disabled": true }, { "key": "sort_by", "value": "", "disabled": true }, { "key": "sort_order", "value": "asc", "disabled": true }, { "key": "resource_type", "value": "", "disabled": true }, { "key": "status", "value": "pending", "disabled": true } ] }, "description": "Lista las solicitudes de importación del workspace, con contadores de éxito y error." }, "response": [] }, { "name": "Importar CSV (POST /imports)", "request": { "method": "POST", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/imports", "host": [ "{{baseUrl}}" ], "path": [ "v1", "imports" ] }, "body": { "mode": "raw", "raw": "{\n \"resource_type\": \"portal_users\",\n \"file_name\": \"\",\n \"content_type\": \"\",\n \"content_base64\": \"\"\n}", "options": { "raw": { "language": "json" } } }, "description": "Envía un CSV en base64 y programa la importación de usuarios del portal en el workspace. El panel sube el archivo antes; la API lo recibe en el cuerpo (límite de 2 MB por solicitud). Sigue la configuración de la organización \"permitir crear usuarios del portal\" (403 si está desactivada). Asíncrono: 202; consulte `GET /imports/{id}`." }, "response": [] }, { "name": "Consultar importación", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/imports/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "imports", ":id" ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" } ] }, "description": "Estado, contadores y errores por fila de una importación. Una importación aún `pending` 2 minutos después de la solicitud aparece como `failed` (cola detenida), sin que la consulta modifique el registro." }, "response": [] } ] }, { "name": "Copias de seguridad", "item": [ { "name": "Listar copias de seguridad", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/backups?page=1&per_page=20&sort_by=&sort_order=asc&type=backup&status=pending", "host": [ "{{baseUrl}}" ], "path": [ "v1", "backups" ], "query": [ { "key": "page", "value": "1", "disabled": true }, { "key": "per_page", "value": "20", "disabled": true }, { "key": "sort_by", "value": "", "disabled": true }, { "key": "sort_order", "value": "asc", "disabled": true }, { "key": "type", "value": "backup", "disabled": true }, { "key": "status", "value": "pending", "disabled": true } ] }, "description": "Lista copias de seguridad y restauraciones de la organización (solo metadatos) e informa si puede pedirse una nueva copia ahora (`backup_allowed`, `next_backup_at` — una cada 12 horas en producción). Recurso de la organización." }, "response": [] }, { "name": "Solicitar copia de seguridad", "request": { "method": "POST", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/backups", "host": [ "{{baseUrl}}" ], "path": [ "v1", "backups" ] }, "description": "Programa una copia completa (ZIP) de la organización, con todos los workspaces. Asíncrono: 202; consulte `GET /backups/{id}`." }, "response": [] }, { "name": "Restaurar copia de seguridad", "request": { "method": "POST", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/backups/restore", "host": [ "{{baseUrl}}" ], "path": [ "v1", "backups", "restore" ] }, "body": { "mode": "raw", "raw": "{\n \"backup_id\": \"00000000-0000-0000-0000-000000000000\",\n \"file_name\": \"\",\n \"content_base64\": \"\"\n}", "options": { "raw": { "language": "json" } } }, "description": "DESTRUCTIVO: restaura una copia en el workspace de la llamada (`X-Workspace-Id`), reescribiendo usuarios del portal emparejados por correo/ID público. Envíe `backup_id` (una copia terminada de esta organización — el archivo se copia) O `file_name` (`.zip`) + `content_base64` (limitado a los 2 MB de la solicitud). Exige `settings.update` y acceso a todos los workspaces. Asíncrono: 202; sígala en `GET /backups/{id}` y cancele con `/cancel`." }, "response": [] }, { "name": "Consultar copia de seguridad", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/backups/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "backups", ":id" ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" } ] }, "description": "Estado y progreso de una copia o restauración. Una restauración en curso cuyo job desapareció de la cola se marca como `failed`." }, "response": [] }, { "name": "Eliminar copia de seguridad", "request": { "method": "DELETE", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/backups/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "backups", ":id" ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" } ] }, "description": "Elimina el registro y su archivo del almacenamiento. Definitivo." }, "response": [] }, { "name": "Cancelar restauración", "request": { "method": "POST", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/backups/:id/cancel", "host": [ "{{baseUrl}}" ], "path": [ "v1", "backups", ":id", "cancel" ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" } ] }, "description": "Detiene una restauración pendiente o en curso. Lo ya restaurado permanece. 422 para una copia o una restauración ya terminada." }, "response": [] }, { "name": "Descargar copia de seguridad", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/backups/:id/download", "host": [ "{{baseUrl}}" ], "path": [ "v1", "backups", ":id", "download" ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" } ] }, "description": "Devuelve el ZIP de la copia. Exige `backups.export` y, para el token de una persona, ser dueña de la organización o tener acceso a todos los workspaces — la copia los contiene a todos. Queda en la auditoría." }, "response": [] } ] }, { "name": "Limpieza de Datos", "item": [ { "name": "Contar datos eliminables", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/data_purges", "host": [ "{{baseUrl}}" ], "path": [ "v1", "data_purges" ] }, "description": "Cuántos registros tiene cada recurso eliminable (`portal_users`, `people`, `usage_history`) sumando todos los workspaces. Exige `data.purge` (por defecto solo dueños de la organización) y acceso a todos los workspaces." }, "response": [] }, { "name": "Eliminar datos de la organización", "request": { "method": "POST", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/data_purges", "host": [ "{{baseUrl}}" ], "path": [ "v1", "data_purges" ] }, "body": { "mode": "raw", "raw": "{\n \"resources\": [\n \"portal_users\"\n ],\n \"confirm\": \"\"\n}", "options": { "raw": { "language": "json" } } }, "description": "IRREVERSIBLE: elimina definitivamente los recursos elegidos en TODOS los workspaces de la organización. En el panel la operación se confirma con un código enviado por correo. Por eso, un token que identifica a una persona (token personal, OAuth o llamada por el MCP) recibe 403: la persona hace la limpieza desde el panel. Solo los tokens de máquina pueden limpiar por la API, y solo cuando el token trae el scope dedicado `dashboards/data_purges:write` — concedido explícitamente: ningún otro scope lo implica (ni `write`, `all`, `dashboards/all` o `dashboards/admin:write`); sin él, 403 `insufficient_scope`. Su confirmación es `confirm`, que debe repetir el ID de la organización (de `GET /organization`) — una llamada repetida o dirigida a la organización equivocada no pasa por error. Exige `data.purge` (por defecto solo dueños de la organización) y acceso a todos los workspaces. Asíncrono: 202 con `job_id`." }, "response": [] }, { "name": "Seguir limpieza", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/data_purges/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "data_purges", ":id" ], "variable": [ { "key": "id", "value": "" } ] }, "description": "Progreso y resultado de un job de limpieza. Job de otra organización: 404." }, "response": [] } ] }, { "name": "Mantenimiento", "item": [ { "name": "Poner nombres en mayúsculas", "request": { "method": "POST", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/maintenance/uppercase_names", "host": [ "{{baseUrl}}" ], "path": [ "v1", "maintenance", "uppercase_names" ] }, "description": "Convierte a mayúsculas el nombre de todo contacto vinculado a un usuario del portal del workspace. No es reversible (la grafía anterior no se guarda)." }, "response": [] } ] }, { "name": "Configuración", "item": [ { "name": "Consultar configuración de la organización", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/settings", "host": [ "{{baseUrl}}" ], "path": [ "v1", "settings" ] }, "description": "Nombre, correo de soporte, zona horaria y las opciones de registros de la organización. Recurso de la organización." }, "response": [] }, { "name": "Actualizar configuración de la organización", "request": { "method": "PUT", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/settings", "host": [ "{{baseUrl}}" ], "path": [ "v1", "settings" ] }, "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"support_email\": \"user@example.com\",\n \"timezone\": \"\",\n \"crm_uppercase_names\": false,\n \"crm_allow_edit_public_id\": false,\n \"crm_allow_edit_document\": false,\n \"crm_allow_create_customers\": false,\n \"crm_allow_create_portal_users\": false,\n \"crm_allow_edit_portal_user_email\": false\n}", "options": { "raw": { "language": "json" } } }, "description": "Cambia parcialmente la configuración: envíe solo lo que cambia. Los campos desconocidos se rechazan (400)." }, "response": [] } ] }, { "name": "Consumo", "item": [ { "name": "Consultar consumo de la plataforma", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/usage?start_date=2026-01-15&end_date=2026-01-15", "host": [ "{{baseUrl}}" ], "path": [ "v1", "usage" ], "query": [ { "key": "start_date", "value": "2026-01-15", "disabled": true }, { "key": "end_date", "value": "2026-01-15", "disabled": true } ] }, "description": "Para cada métrica (miembros, clientes, usuarios del portal, integraciones…), la serie diaria en el período, el valor más reciente y el pico. Por defecto: mes actual; como máximo 12 meses atrás. Recurso de la organización." }, "response": [] } ] }, { "name": "Uso de IA", "item": [ { "name": "Consultar uso de IA", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/ai_usage?start_date=2026-01-15&end_date=2026-01-15&days=0", "host": [ "{{baseUrl}}" ], "path": [ "v1", "ai_usage" ], "query": [ { "key": "start_date", "value": "2026-01-15", "disabled": true }, { "key": "end_date", "value": "2026-01-15", "disabled": true }, { "key": "days", "value": "0", "disabled": true } ] }, "description": "Consumo de IA, solo precio (costo y margen nunca salen): totales, detalle diario y últimos turnos del workspace de la llamada, más el acumulado del mes, franquicias, límites, saldo de crédito y si el próximo turno está permitido — estos de toda la organización, pues el límite y el crédito son compartidos. Período por defecto: mes actual (America/Sao_Paulo), como máximo 366 días." }, "response": [] } ] }, { "name": "Límites de Solicitudes", "item": [ { "name": "Consultar límites de solicitudes", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/rate_limits", "host": [ "{{baseUrl}}" ], "path": [ "v1", "rate_limits" ] }, "description": "Los límites de solicitudes vigentes para la organización, si son personalizados (definidos por el equipo Kobana) y los valores por defecto de la plataforma. Solo lectura." }, "response": [] } ] }, { "name": "Archivos", "item": [ { "name": "Listar archivos", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/assets?page=1&per_page=20&sort_by=&sort_order=asc&kind=image&visibility=public&tenant_id=&type_id=00000000-0000-0000-0000-000000000000&tag=&search=", "host": [ "{{baseUrl}}" ], "path": [ "v1", "assets" ], "query": [ { "key": "page", "value": "1", "disabled": true }, { "key": "per_page", "value": "20", "disabled": true }, { "key": "sort_by", "value": "", "disabled": true }, { "key": "sort_order", "value": "asc", "disabled": true }, { "key": "kind", "value": "image", "disabled": true }, { "key": "visibility", "value": "public", "disabled": true }, { "key": "tenant_id", "value": "", "disabled": true }, { "key": "type_id", "value": "00000000-0000-0000-0000-000000000000", "disabled": true }, { "key": "tag", "value": "", "disabled": true }, { "key": "search", "value": "", "disabled": true } ] }, "description": "La biblioteca de archivos del workspace — imágenes y documentos que el portal muestra u ofrece para descargar. Ordenable por `created_at` (por defecto), `name` o `size_bytes`." }, "response": [] }, { "name": "Agregar archivo", "request": { "method": "POST", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/assets", "host": [ "{{baseUrl}}" ], "path": [ "v1", "assets" ] }, "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"key\": \"\",\n \"content_base64\": \"\",\n \"content_type\": \"\",\n \"alt_text\": \"\",\n \"visibility\": \"public\",\n \"tenant_id\": \"\",\n \"type_id\": \"00000000-0000-0000-0000-000000000000\",\n \"tags\": [\n \"\"\n ]\n}", "options": { "raw": { "language": "json" } } }, "description": "Registra un archivo en la biblioteca, de una de dos formas: el `key` de un archivo ya enviado por la URL de `POST /assets/presign`, o el propio contenido en `content_base64`. El archivo empieza `restricted`, salvo que `visibility` diga otra cosa. Dispara el webhook `asset.created`." }, "response": [] }, { "name": "Generar URL de envío", "request": { "method": "POST", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/assets/presign", "host": [ "{{baseUrl}}" ], "path": [ "v1", "assets", "presign" ] }, "body": { "mode": "raw", "raw": "{\n \"filename\": \"\",\n \"content_type\": \"\",\n \"size\": 0\n}", "options": { "raw": { "language": "json" } } }, "description": "Una URL firmada y de corta duración para enviar el archivo directo al storage con `PUT` — el camino para archivos que superan el límite de 2 MB del cuerpo. Después del `PUT`, registre el archivo en `POST /assets` con el `key` devuelto." }, "response": [] }, { "name": "Consultar archivo", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/assets/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "assets", ":id" ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" } ] }, "description": "Un archivo de la biblioteca, con su enlace, visibilidad, tipo y tamaño." }, "response": [] }, { "name": "Actualizar archivo", "request": { "method": "PATCH", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/assets/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "assets", ":id" ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" } ] }, "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"alt_text\": \"\",\n \"visibility\": \"public\",\n \"tenant_id\": \"\",\n \"type_id\": \"00000000-0000-0000-0000-000000000000\",\n \"tags\": [\n \"\"\n ]\n}", "options": { "raw": { "language": "json" } } }, "description": "Renombra el archivo, cambia el texto alternativo o la visibilidad. Hacerlo público abre la URL del storage a cualquiera; `restricted` o `private` la cierra." }, "response": [] }, { "name": "Eliminar archivo", "request": { "method": "DELETE", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/assets/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "assets", ":id" ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" } ] }, "description": "Quita el archivo de la biblioteca. El archivo guardado sigue en el storage, para que los enlaces ya publicados no se rompan. Dispara el webhook `asset.deleted`." }, "response": [] }, { "name": "Descargar archivo", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/assets/:id/download?inline=true", "host": [ "{{baseUrl}}" ], "path": [ "v1", "assets", ":id", "download" ], "query": [ { "key": "inline", "value": "true", "disabled": true } ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" } ] }, "description": "El contenido del archivo, sea cual sea la visibilidad, con su propio `Content-Type`." }, "response": [] } ] }, { "name": "Tipos de archivo", "item": [ { "name": "Listar tipos de archivo", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/asset_types", "host": [ "{{baseUrl}}" ], "path": [ "v1", "asset_types" ] }, "description": "Los tipos de archivo del workspace, por nombre. Un bloque Archivos del Usuario del portal lista los archivos de los tipos que elige." }, "response": [] }, { "name": "Crear tipo de archivo", "request": { "method": "POST", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/asset_types", "host": [ "{{baseUrl}}" ], "path": [ "v1", "asset_types" ] }, "body": { "mode": "raw", "raw": "{\n \"name\": \"\"\n}", "options": { "raw": { "language": "json" } } }, "description": "Crea un tipo de archivo. Después, use el `id` en el `type_id` de los archivos." }, "response": [] }, { "name": "Obtener tipo de archivo", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/asset_types/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "asset_types", ":id" ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" } ] }, "description": "Un tipo de archivo." }, "response": [] }, { "name": "Renombrar tipo de archivo", "request": { "method": "PATCH", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/asset_types/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "asset_types", ":id" ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" } ] }, "body": { "mode": "raw", "raw": "{\n \"name\": \"\"\n}", "options": { "raw": { "language": "json" } } }, "description": "Cambia el nombre de un tipo de archivo." }, "response": [] }, { "name": "Eliminar tipo de archivo", "request": { "method": "DELETE", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/asset_types/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "asset_types", ":id" ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" } ] }, "description": "Elimina el tipo. Sus archivos siguen, sin tipo — y salen de los bloques Archivos del Usuario que listaban ese tipo." }, "response": [] } ] }, { "name": "Checklists", "item": [ { "name": "Listar checklists", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/checklists", "host": [ "{{baseUrl}}" ], "path": [ "v1", "checklists" ] }, "description": "Los bloques Lista de Tareas del portal publicado del workspace, página por página. Las tareas se escriben en el builder; el progreso es de cada tenant (`GET /checklists/{id}/progress`)." }, "response": [] }, { "name": "Ver checklist", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/checklists/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "checklists", ":id" ], "variable": [ { "key": "id", "value": "" } ] }, "description": "Una checklist del portal publicado: etapas y tareas visibles." }, "response": [] }, { "name": "Ver progreso del tenant", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/checklists/:id/progress?tenant_id=&portal_user_id=", "host": [ "{{baseUrl}}" ], "path": [ "v1", "checklists", ":id", "progress" ], "query": [ { "key": "tenant_id", "value": "", "disabled": true }, { "key": "portal_user_id", "value": "", "disabled": true } ], "variable": [ { "key": "id", "value": "" } ] }, "description": "Dónde está un tenant en una checklist, tarea por tarea, con completadas/total por etapa. Todos los usuarios del portal del mismo tenant ven este mismo progreso." }, "response": [] }, { "name": "Cambiar progreso del tenant", "request": { "method": "PUT", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/checklists/:id/progress", "host": [ "{{baseUrl}}" ], "path": [ "v1", "checklists", ":id", "progress" ], "variable": [ { "key": "id", "value": "" } ] }, "body": { "mode": "raw", "raw": "{\n \"tenant_id\": \"\",\n \"portal_user_id\": \"\",\n \"task_ids\": [\n \"\"\n ],\n \"status\": \"pending\"\n}", "options": { "raw": { "language": "json" } } }, "description": "Define el estado de una o más tareas para el tenant (crea el progreso en el primer uso). Los usuarios del tenant ven el cambio en el portal." }, "response": [] }, { "name": "Reiniciar progreso del tenant", "request": { "method": "DELETE", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/checklists/:id/progress?tenant_id=&portal_user_id=&task_ids=", "host": [ "{{baseUrl}}" ], "path": [ "v1", "checklists", ":id", "progress" ], "query": [ { "key": "tenant_id", "value": "", "disabled": true }, { "key": "portal_user_id", "value": "", "disabled": true }, { "key": "task_ids", "value": "", "disabled": true } ], "variable": [ { "key": "id", "value": "" } ] }, "description": "Vuelve las tareas de `task_ids` (todas, sin él) a pendiente y olvida los archivos enviados. Es una actualización: el historial queda en los eventos y la auditoría." }, "response": [] }, { "name": "Descargar archivo de la tarea", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/checklists/:id/progress/file?tenant_id=&portal_user_id=&task_id=", "host": [ "{{baseUrl}}" ], "path": [ "v1", "checklists", ":id", "progress", "file" ], "query": [ { "key": "tenant_id", "value": "", "disabled": true }, { "key": "portal_user_id", "value": "", "disabled": true }, { "key": "task_id", "value": "", "disabled": false } ], "variable": [ { "key": "id", "value": "" } ] }, "description": "El archivo que el tenant envió a una tarea de tipo Solicitud." }, "response": [] }, { "name": "Enviar archivo de la tarea", "request": { "method": "POST", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/checklists/:id/progress/file", "host": [ "{{baseUrl}}" ], "path": [ "v1", "checklists", ":id", "progress", "file" ], "variable": [ { "key": "id", "value": "" } ] }, "body": { "mode": "raw", "raw": "{\n \"tenant_id\": \"\",\n \"portal_user_id\": \"\",\n \"task_id\": \"\",\n \"name\": \"\",\n \"content_base64\": \"\",\n \"content_type\": \"\"\n}", "options": { "raw": { "language": "json" } } }, "description": "Envía, por el tenant, el archivo de una tarea de tipo Solicitud (`content_base64`), reemplazando el anterior." }, "response": [] }, { "name": "Quitar archivo de la tarea", "request": { "method": "DELETE", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/checklists/:id/progress/file?tenant_id=&portal_user_id=&task_id=", "host": [ "{{baseUrl}}" ], "path": [ "v1", "checklists", ":id", "progress", "file" ], "query": [ { "key": "tenant_id", "value": "", "disabled": true }, { "key": "portal_user_id", "value": "", "disabled": true }, { "key": "task_id", "value": "", "disabled": false } ], "variable": [ { "key": "id", "value": "" } ] }, "description": "Retira el archivo que el tenant envió a una tarea." }, "response": [] } ] }, { "name": "Comentarios", "item": [ { "name": "Listar comentarios", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/comments?page=1&per_page=20&sort_by=&sort_order=asc&tenant_id=&portal_user_id=&internal=true&author_type=portal_user", "host": [ "{{baseUrl}}" ], "path": [ "v1", "comments" ], "query": [ { "key": "page", "value": "1", "disabled": true }, { "key": "per_page", "value": "20", "disabled": true }, { "key": "sort_by", "value": "", "disabled": true }, { "key": "sort_order", "value": "asc", "disabled": true }, { "key": "tenant_id", "value": "", "disabled": true }, { "key": "portal_user_id", "value": "", "disabled": true }, { "key": "internal", "value": "true", "disabled": true }, { "key": "author_type", "value": "portal_user", "disabled": true } ] }, "description": "Los comentarios de la conversación de un tenant (`tenant_id` o `portal_user_id`) o, sin ninguno de los dos, de todas las conversaciones del workspace. Más recientes primero, paginado." }, "response": [] }, { "name": "Crear comentario", "request": { "method": "POST", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/comments", "host": [ "{{baseUrl}}" ], "path": [ "v1", "comments" ] }, "body": { "mode": "raw", "raw": "{\n \"tenant_id\": \"\",\n \"portal_user_id\": \"\",\n \"body\": \"\",\n \"internal\": false,\n \"author_name\": \"\"\n}", "options": { "raw": { "language": "json" } } }, "description": "Agrega un comentario a la conversación de un tenant, en nombre del equipo. Todos los usuarios del portal de ese tenant lo ven en el bloque Comentarios — a menos que `internal` sea `true`." }, "response": [] }, { "name": "Obtener comentario", "request": { "method": "GET", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/comments/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "comments", ":id" ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" } ] }, "description": "Un comentario." }, "response": [] }, { "name": "Eliminar comentario", "request": { "method": "DELETE", "header": [ { "key": "User-Agent", "value": "Kevin Mitnick ", "type": "text" }, { "key": "X-Idempotency-Key", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source", "value": "api", "type": "text" }, { "key": "X-Workspace-Id", "value": "00000000-0000-0000-0000-000000000000", "type": "text" }, { "key": "X-Request-Source-Other", "value": "Zapier", "type": "text" } ], "url": { "raw": "{{baseUrl}}/v1/comments/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "comments", ":id" ], "variable": [ { "key": "id", "value": "00000000-0000-0000-0000-000000000000" } ] }, "description": "Quita el comentario de la conversación (eliminación lógica): desaparece del portal y del dashboard para todos." }, "response": [] } ] } ] }