AIMERICAAPI · Developers

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/v1 with 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.