Saltar al contenido principal

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_available y excess_consumed_usd.
  • Nuevo prepaid_credits: balance_usd y consumed_usd.
  • entitlement (has_plan, monthly_limit_usd) y credit_balance_usd siguen, con el sentido de los nombres nuevos: créditos de la suscripción y saldo prepago.
  • Valores cambiados: next_turn.funded_by pasa a ser subscription, courtesy, prepaid o subscription_excess (antes entitlement, courtesy o balance), y recent[].funded_by pasa a ser SUBSCRIPTION, COURTESY, PREPAID o SUBSCRIPTION_EXCESS (antes ENTITLEMENT, COURTESY o BALANCE). 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 nuevaSustituye aQué hace
POST /v1/builder/test_actionPOST /v1/builder/action_runsPrueba un botón de acción del borrador
POST /v1/builder/test_formPOST /v1/builder/form_submissionsPrueba un formulario del borrador
POST /v1/builder/encrypt_secretPOST /v1/builder/secretsCifra un secreto de bloque
POST /v1/builder/upload_og_imagePOST /v1/builder/og_imageSube la og:image
POST /v1/portal_settings/verify_senderPOST /v1/portal_settings/sender_identityVerifica el e-mail remitente de las notificaciones
POST /v1/data_sources con kind: "openapi"POST /v1/data_sources/openapiCrea una fuente OpenAPI
POST /v1/data_sources con kind: "mcp"POST /v1/data_sources/mcpCrea una fuente MCP
POST /v1/data_sources con kind: "database"POST /v1/data_sources/databaseCrea 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 nuevaNombre antiguo
dashboards_builder_test_actiondashboards_builder_action_runs_create
dashboards_builder_test_formdashboards_builder_form_submissions_create
dashboards_builder_encrypt_secretdashboards_builder_seal_secret
dashboards_builder_upload_og_imagedashboards_builder_og_image_upload
dashboards_portal_settings_verify_senderdashboards_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