Changelog
Cambios en el contrato de la API v1 y del servidor MCP, del más reciente al más antiguo. Un cambio aditivo no rompe ninguna integración; una descontinuación anuncia una ruta que sigue respondiendo durante un ciclo de release y después desaparece.
2026-11-02 — créditos de IA de la suscripción y prepagos
Aditivo, con un cambio de valores. El uso de IA pasó a pagarse con dos créditos: los de la suscripción (la franquicia mensual del plan, con excedente opcional) y los prepagos (comprados aparte). En GET /v1/ai_usage (tool MCP dashboards_ai_usage_get):
- Nuevo
subscription_credits:contracted,allowance_usd(la franquicia mensual),consumed_usd(lo que pagó en el mes),excess_availableyexcess_consumed_usd. - Nuevo
prepaid_credits:balance_usdyconsumed_usd. entitlement(has_plan,monthly_limit_usd) ycredit_balance_usdsiguen, con el sentido de los nombres nuevos: créditos de la suscripción y saldo prepago.- Valores cambiados:
next_turn.funded_bypasa a sersubscription,courtesy,prepaidosubscription_excess(antesentitlement,courtesyobalance), yrecent[].funded_bypasa a serSUBSCRIPTION,COURTESY,PREPAIDoSUBSCRIPTION_EXCESS(antesENTITLEMENT,COURTESYoBALANCE). Si comparas estos textos, actualiza la comparación.
2026-11-02 — acciones nombradas por lo que hacen
Aditivo. Siete operaciones POST cuyo último segmento era un sustantivo recibieron una ruta que dice lo que hace el POST. El motivo es el CLI kobana, que deriva el nombre de cada comando de la ruta: kobana dashboards builder secrets se leía como una colección, mientras cifra un único valor.
| Ruta nueva | Sustituye a | Qué hace |
|---|---|---|
POST /v1/builder/test_action | POST /v1/builder/action_runs | Prueba un botón de acción del borrador |
POST /v1/builder/test_form | POST /v1/builder/form_submissions | Prueba un formulario del borrador |
POST /v1/builder/encrypt_secret | POST /v1/builder/secrets | Cifra un secreto de bloque |
POST /v1/builder/upload_og_image | POST /v1/builder/og_image | Sube la og:image |
POST /v1/portal_settings/verify_sender | POST /v1/portal_settings/sender_identity | Verifica el e-mail remitente de las notificaciones |
POST /v1/data_sources con kind: "openapi" | POST /v1/data_sources/openapi | Crea una fuente OpenAPI |
POST /v1/data_sources con kind: "mcp" | POST /v1/data_sources/mcp | Crea una fuente MCP |
POST /v1/data_sources con kind: "database" | POST /v1/data_sources/database | Crea una fuente de base de datos |
La creación de fuente de datos pasó a ser una operación en la colección: el cuerpo lleva kind (openapi, mcp o database) y los campos de ese tipo — los mismos que aceptaba cada ruta antigua. La respuesta trae siempre authorization_url (con valor solo para un servidor MCP con OAuth). POST /v1/data_sources/catalog y POST /v1/data_sources/openapi/analyze no cambiaron.
Descontinuaciones. Las ocho rutas de la columna "Sustituye a" siguen respondiendo, con el mismo comportamiento y la misma respuesta de antes, durante un ciclo de release. Cada respuesta trae las cabeceras Deprecation: true y Link: </v1/...>; rel="successor-version" apuntando a la ruta nueva, y la operación aparece como descontinuada en la especificación OpenAPI. Cambie sus llamadas antes de la próxima versión.
MCP. Las tools correspondientes fueron renombradas y pasan a llamar a las rutas nuevas; los nombres antiguos ya no existen en tools/list:
| Tool nueva | Nombre antiguo |
|---|---|
dashboards_builder_test_action | dashboards_builder_action_runs_create |
dashboards_builder_test_form | dashboards_builder_form_submissions_create |
dashboards_builder_encrypt_secret | dashboards_builder_seal_secret |
dashboards_builder_upload_og_image | dashboards_builder_og_image_upload |
dashboards_portal_settings_verify_sender | dashboards_portal_settings_verify_sender_identity |
dashboards_data_sources_create (con kind) | dashboards_data_sources_create_openapi, dashboards_data_sources_create_mcp, dashboards_data_sources_create_database |