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_availableeexcess_consumed_usd. - Novo
prepaid_credits:balance_usdeconsumed_usd. entitlement(has_plan,monthly_limit_usd) ecredit_balance_usdseguem, com o mesmo sentido pelos nomes novos: créditos da assinatura e saldo pré-pago.- Valores trocados:
next_turn.funded_bypassa a sersubscription,courtesy,prepaidousubscription_excess(antesentitlement,courtesyoubalance), erecent[].funded_bypassa a serSUBSCRIPTION,COURTESY,PREPAIDouSUBSCRIPTION_EXCESS(antesENTITLEMENT,COURTESYouBALANCE). 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 novo | Substitui | O que faz |
|---|---|---|
POST /v1/builder/test_action | POST /v1/builder/action_runs | Testa um botão de ação do rascunho |
POST /v1/builder/test_form | POST /v1/builder/form_submissions | Testa um formulário do rascunho |
POST /v1/builder/encrypt_secret | POST /v1/builder/secrets | Criptografa um segredo de bloco |
POST /v1/builder/upload_og_image | POST /v1/builder/og_image | Envia a og:image |
POST /v1/portal_settings/verify_sender | POST /v1/portal_settings/sender_identity | Verifica o e-mail remetente das notificações |
POST /v1/data_sources com kind: "openapi" | POST /v1/data_sources/openapi | Cria uma fonte OpenAPI |
POST /v1/data_sources com kind: "mcp" | POST /v1/data_sources/mcp | Cria uma fonte MCP |
POST /v1/data_sources com kind: "database" | POST /v1/data_sources/database | Cria 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 nova | Nome antigo |
|---|---|
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 (com kind) | dashboards_data_sources_create_openapi, dashboards_data_sources_create_mcp, dashboards_data_sources_create_database |