Pular para o conteúdo principal

Changelog

Mudanças no contrato da API v1 e do servidor MCP, da mais recente para a mais antiga. Uma mudança aditiva não quebra nenhuma integração; uma descontinuação anuncia um caminho que segue respondendo por um ciclo de release e depois sai.

2026-11-02 — créditos de IA da assinatura e pré-pagos​

Aditivo, com uma troca de valores. O uso de IA passou a ser pago por dois créditos: os da assinatura (a franquia mensal do plano, com excedente opcional) e os pré-pagos (comprados à parte). Em GET /v1/ai_usage (tool MCP dashboards_ai_usage_get):

  • Novo subscription_credits: contracted, allowance_usd (a franquia mensal), consumed_usd (o que ela pagou no mês), excess_available e excess_consumed_usd.
  • Novo prepaid_credits: balance_usd e consumed_usd.
  • entitlement (has_plan, monthly_limit_usd) e credit_balance_usd seguem, com o mesmo sentido pelos nomes novos: créditos da assinatura e saldo pré-pago.
  • Valores trocados: next_turn.funded_by passa a ser subscription, courtesy, prepaid ou subscription_excess (antes entitlement, courtesy ou balance), e recent[].funded_by passa a ser SUBSCRIPTION, COURTESY, PREPAID ou SUBSCRIPTION_EXCESS (antes ENTITLEMENT, COURTESY ou BALANCE). Quem compara esses textos precisa atualizar a comparação.

2026-11-02 — ações nomeadas pelo que fazem​

Aditivo. Sete operações POST cujo último segmento era um substantivo ganharam um caminho que diz o que o POST faz. O motivo é o CLI kobana, que deriva o nome de cada comando da rota: kobana dashboards builder secrets lia como uma coleção, enquanto criptografa um único valor.

Caminho novoSubstituiO que faz
POST /v1/builder/test_actionPOST /v1/builder/action_runsTesta um botão de ação do rascunho
POST /v1/builder/test_formPOST /v1/builder/form_submissionsTesta um formulário do rascunho
POST /v1/builder/encrypt_secretPOST /v1/builder/secretsCriptografa um segredo de bloco
POST /v1/builder/upload_og_imagePOST /v1/builder/og_imageEnvia a og:image
POST /v1/portal_settings/verify_senderPOST /v1/portal_settings/sender_identityVerifica o e-mail remetente das notificações
POST /v1/data_sources com kind: "openapi"POST /v1/data_sources/openapiCria uma fonte OpenAPI
POST /v1/data_sources com kind: "mcp"POST /v1/data_sources/mcpCria uma fonte MCP
POST /v1/data_sources com kind: "database"POST /v1/data_sources/databaseCria uma fonte de banco de dados

A criação de fonte de dados virou uma operação na coleção: o corpo leva kind (openapi, mcp ou database) e os campos daquele tipo — os mesmos que cada caminho antigo aceitava. A resposta traz sempre authorization_url (preenchida só para um servidor MCP com OAuth). POST /v1/data_sources/catalog e POST /v1/data_sources/openapi/analyze não mudaram.

Descontinuações. Os oito caminhos da coluna "Substitui" seguem respondendo, com o mesmo comportamento e a mesma resposta de antes, por um ciclo de release. Cada resposta deles traz os cabeçalhos Deprecation: true e Link: </v1/...>; rel="successor-version" apontando para o caminho novo, e a operação aparece como descontinuada na especificação OpenAPI. Troque as chamadas antes da próxima versão.

MCP. As tools correspondentes foram renomeadas e passam a chamar os caminhos novos; os nomes antigos não existem mais no tools/list:

Tool novaNome antigo
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 (com kind)dashboards_data_sources_create_openapi, dashboards_data_sources_create_mcp, dashboards_data_sources_create_database