Changelog

Copy Markdown View Source

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[Unreleased]

[0.1.3] - 2026-06-09

Changed

  • Updated Twilio OpenAPI specs from 2.6.7 to 2.6.9.
  • Added generated services and resources for Conversations v2, Intelligence v3, Knowledge v2, Memory v1, and Voice v3 APIs.

Fixed

  • Service generator now merges caller-supplied opts into the Client.request/4 call. Previously, generated service modules passed the caller's opts as a nested opts: key that Client.request/4 never read, and hardcoded base_url: "https://api.twilio.com" so the caller's :base_url could not take effect. Client.request/4 now also supports that legacy generated shape, so existing generated services honor caller-supplied :base_url (for local test simulators, sandbox/staging hosts, and self-hosted Twilio-compatible proxies), :content_type, and other request options without requiring regeneration. The explicit params argument continues to win over any :params key in opts.

[0.1.2] - 2026-04-16

Changed

  • Updated Twilio OpenAPI specs from 2.6.4 to 2.6.7
  • Added IAM v1 role permission service and resource
  • Added Insights v2 voice report services/resources (account, inbound and outbound phone-number reports)
  • Added Numbers v1 sender ID registration with embedded session support
  • Added Messaging v3 typing indicator service
  • Renamed messaging.v1.service.us_app_to_person object type to ..._response
  • Removed deprecated flex.v1.instance object type
  • Miscellaneous field and parameter updates across Assistants, Flex, Studio, Verify, Video, TaskRouter, and other services

[0.1.1] - 2026-03-03

Changed

  • Updated Twilio OpenAPI specs from 2.6.3 to 2.6.4
  • Added BundleSids and EndUserType query params to bundle listing
  • Added Configuration object param to video transcription updates
  • Trimmed redundant inequality descriptions from call StartTime/EndTime params
  • Updated messaging sender vertical enum with new categories
  • Fixed Flex API path capitalization (/v1/Instances)
  • Cleaned IAM Organizations apiStandards from placeholder to v0.1
  • Added OAuth v2 session metadata schema and authorize fields

[0.1.0] - 2026-03-03

Added

API Coverage

  • Auto-generated SDK from Twilio's 54 OpenAPI spec files (v2.6.3)
  • 440+ service modules covering 37+ Twilio products (Messaging, Voice, Verify, Conversations, Flex, Insights, Video, and more)
  • 420+ typed resource structs with automatic JSON-to-struct deserialization
  • Object types registry mapping schema names to Elixir modules

Client & HTTP

  • Twilio.Client with HTTP Basic auth (Account SID + Auth Token)
  • Region and edge URL construction (e.g. ie1, dublin)
  • Subaccount support via :account_sid option
  • Connection pooling via Finch (auto-sized: max(schedulers_online, 10))
  • Request encoding: form-encoded for mutations, query params for reads
  • Opt-in response metadata (return_response: true) exposing status, headers, and request ID

Retry & Resilience

  • Unified retry covering 429, 5xx, and connection errors (opt-in, default: 0)
  • Retry-After header parsing on 429 responses
  • Exponential backoff with full jitter
  • Idempotency token auto-generation (I-Twilio-Idempotency-Token) on retryable POST requests
  • Twilio.Error typed error struct with retryable?/1 helper

Pagination

  • Twilio.Page with dual-format auto-detection:
    • v2010 flat format (next_page_uri)
    • v1/v2/v3 meta wrapper format (meta.next_page_url)
  • stream/1 for lazy auto-pagination via Stream.unfold

Webhooks

  • Twilio.Webhook HMAC-SHA1 signature verification
  • Form-encoded webhook validation (valid?/4)
  • JSON body webhook validation (valid_body?/4)
  • Constant-time comparison to prevent timing attacks

TwiML

  • Twilio.TwiML.VoiceResponse — Say, Play, Gather, Dial, Record, Redirect, Hangup, Reject, Pause, Enqueue, plus nested nouns (Number, Client, Sip, Queue)
  • Twilio.TwiML.MessagingResponse — Message (with Body/Media children), Redirect
  • Automatic snake_case to camelCase attribute conversion
  • XML escaping for text content and attribute values

Testing

  • Twilio.Test per-process HTTP stubs via NimbleOwnership
  • Full async: true support with process isolation
  • allow/1 for sharing stubs with child processes

Observability

  • Structured :telemetry events: start, stop, exception, retry

Code Generation

  • mix twilio.generate Mix task with --clean, --dry-run, --stats
  • scripts/sync_openapi.sh for downloading specs from twilio/twilio-oai
  • Auto-formatting of generated code

CI & Automation

  • GitHub Actions CI: test matrix (Elixir 1.19-1.20, OTP 27-28), quality checks (Credo, format, Dialyzer), codegen determinism verification
  • Weekly OpenAPI spec sync workflow with auto-PR generation
  • scripts/parity_report.sh for endpoint coverage reporting

Documentation

  • Guides: Getting Started, Webhooks, TwiML, Testing, Telemetry
  • ExDoc with module grouping by category