There can only be one root handler. Basically handlers chain together, so the current handler picks the next handler (or generates a response).
It sounds like what you want to do is map the JAX-RS handlers to the root of the servlet deployment, and then use a path handler with the servlet deployment under /api and the resource handler under /.

Yes, that was exactly what I was intending/attempting to do.

Alternatively you just set the Servlet deployment's ResourceManager and then the resources will just be served up by the DefaultServlet.

From the docs I know the "ResourceManager" is a built in handler, but is there more information on it or an example of how to set it?

Thanks.

-Ari