Changes to the HTTP API
Changes to the contract of the Megido HTTP API: its paths, fields, types and error codes. Each entry is dated by the day it took effect; the newest comes first. A change can take effect on the day of its entry.
2026-11-18
Topping up credits, and no estimate demanded of a call that charges nothing.
insufficient_balance, andquota_exhaustedon a registered account, give the page of the Megido portal where an owner of your organization tops up its credits in the new fieldtop_up_url.- A call that charges nothing, such as one the free quota pays in full, is no longer refused with
confirmation_requiredwhen your organization requires an estimate for its tool.
2026-11-14
Your organization's plan, its free quota and estimates above a price.
usageandcapabilitiesname your organization's plan in the new fieldplan.capabilitiesgives the free quota of the plan per period inquota;usagegives it with what is left and the day it renews. Neither givesquotato an agent's task, whose calls the quota does not pay for.- A paid call of an index tool (
search_cohorts,get_cohort,search_projects,get_project_card) reports what the free quota paid inmeta.charge.from_quota. - New error codes:
quota_exhausted(402), when the free quota does not cover a call of an index tool and the available credits do not cover the rest, andquote_outdated(409), when an estimate counted on more free quota than is left now. On a plan with a quota,quota_exhaustedgives what is left of it incalls_leftandfirst_seen_left, and, when a narrower call would fit in it, the parameter and the value to set infitting_paramandfitting_limit. - An estimate the free quota pays part of tells what it took in the new field
from_quota. - An account without registration, made from a chat app, has no key and never calls the HTTP API; its answers are described all the same. Its
usageandcapabilitiestell what registering gives inregistration, and itsquota_exhaustedgives a one-time link to register this account at insign_up_url, which works in any browser for 30 minutes, in place ofpriceandavailable. - On an account without registration, the quality index and its axes of a card (
index) and ofindex_explained, and the median index of a niche (members_index.median), come as bands,{low, high, label}, in place of numbers. Its filters on the index and its axes work by band, and a note inmeta.notesnames a threshold moved to a band's boundary. - A paid call tells what is left of the free quota after it in the new field
meta.quota, with the day it renews; an estimate tells what is left before the call. It comes only on calls the free quota applies to. capabilitiesgiveslimits.estimate_required_abovewhen your organization requires an estimate of any call that may cost more than that many credits; such a call without aquote_tokenis refused withconfirmation_required.
2026-11-09
The HTTP API opens: every tool of the Megido MCP server at POST /v1/tools/<tool>, the tools your key may call at GET /v1/tools, and this reference at GET /v1/openapi.json.