Skip to main content

API Changelog

Changes to the Faturamento Automático API v1, newest first. An additive change asks nothing of existing integrations; a deprecation keeps the old path working, but it receives no further changes — migrate at your own pace.

2026-11-02​

POST /v1/usage/credits/publish replaces POST /v1/usage/credits/daily (deprecation)​

  • New: POST /v1/usage/credits/publish publishes prepaid credit usage. It is the same operation as the old path — same body (a single record or { records: [...] } with up to 100 items, each carrying its own usage_date), same responses (200, 207, 400) and the same overwrite rule per account × product × day.
  • Deprecated: POST /v1/usage/credits/daily keeps answering exactly as before and is marked deprecated in the OpenAPI specification. There is no shutdown date; new integrations should use /publish.
  • Why: the kobana CLI derives each command name from the route, and the last segment of an action must be the verb. credits daily read as a resource; the command becomes kobana billing usage credits publish.
  • MCP: the operation gets the billing_usage_credits_publish tool, which calls the new path. The deprecated path has no tool.