Our API docs told AI agents to do the exact thing that fails

A helpdesk API used by AI agents broke common tool chains because ticket IDs were returned as numbers but expected as strings on input.

An audit found most chained calls failed schema validation, exposing a subtle type mismatch between actual API behavior and published contracts.

The team fixed it by preprocessing numeric IDs into strings, avoiding a published schema change while restoring agent workflows.

The case highlights how small input-output mismatches can silently break AI agent tooling, especially in MCP-style integrations.