Changelog
What changes in the API, dated. Nothing is removed from v1 without notice here first.
2026-09-25 — API v1.0
- New host
https://api.a1merica.ai/v1with stable public shapes: users, numbers, devices, calls (including live-call control), recordings, transcripts, presence, messages, conversations, voicemails, faxes, webhooks, account. - OAuth 2.0: authorization code + PKCE, client credentials, refresh with rotation, revocation, introspection. Apps are registered under Developer → Apps; sensitive scopes on approval for third-party apps.
- Twenty-one scopes (table); existing keys keep their names and are accepted by v1.
- Second-generation webhooks: handshake at creation, filters by family, renewable expiry, suspension after 20 failures,
test.ping, a delivery log. Same signature as before. - Cursor pagination, sync tokens, rate tiers with headers, one error envelope,
X-Request-Id. - A sandbox per app: a demo company that is never billed, resettable, with its own key.
- This site, and the reference generated from
/v1/openapi.json.
2026-09-24 — API keys and webhooks (first generation)
aim_live_…keys with seven scopes over the app's API (/voip/api); 60 requests a minute per key.- Signed outbound webhooks (
X-AIMERICA-Signature: t=…,v1=…) for nine events, and Slack.
Coming
- Number search, ordering and porting through the API; a Zapier app; SDKs.
