How agent-ready is Twilio?
Independent agentability audit of Twilio, scored across the 8 principles of Agent Factors Engineering — how well AI agents can parse, navigate, and operate it.
Audit summary
Twilio's agentability score of 40/100 indicates that autonomous AI agents will encounter moderate to significant friction when attempting to parse and operate its public website. Scores across the homepage (40), pricing (42), and documentation (37) are relatively consistent, suggesting systemic patterns rather than isolated problem areas.
The audit identified transparency (0/100) and shadow UI avoidance (15/100) as critical weaknesses, meaning agents have minimal visibility into system reasoning or confidence levels, and encounter UI elements that lack machine-readable affordances. Defaults (33/100) and chunking (39/100) also scored poorly, indicating that forms lack helpful pre-filled values and content structure does not align with common agent navigation patterns. Machine readability (70/100) and status (65/100) represent relative strengths, though both still have room for improvement.
These gaps mean that agents attempting to integrate Twilio services, navigate pricing options, or consume documentation will face challenges understanding output provenance, controlling long-running operations, and extracting structured information efficiently.
Score by principle
Key findings
How Twilio could improve its score
To improve agentability, Twilio should focus on the following concrete enhancements:
- Implement transparency mechanisms by adding confidence fields to API responses, attaching source references or input citations to generated outputs, and exposing machine-readable activity logs or 'why this result' affordances that record system actions.
- Pre-fill form inputs with sensible defaults wherever reasonable values exist, reducing the cognitive and operational burden on agents attempting to complete common workflows.
- Add labelled pause, cancel, or stop controls for long-running actions with accessible names like 'Cancel import' rather than relying on unlabelled icons.
- Restructure content headings to answer explicit questions (for example, 'How do I cancel?') to align with agent query patterns and improve navigability.
- Replace generic and elements with semantic HTML5 landmarks such as
, Work at Twilio? Re-audit any page free.
Scores refresh automatically when we re-crawl — or run an instant audit on any URL now.
Run a free auditEmbed this score
Show your agent-readiness in your docs or README. The badge links back to this live report.