I just don't see why I would use any other API, including for programmatic access, rather than one optimized for agents. Do you have an example of where a custom API is better?
My custom MCP server for example handles long running tasks by returning a handle that can be cancelled/queried. This is done in a generic way that all agents can deal with and needed no special instructions.
(Excluding for performance reasons here...)