The API proper is anything published in the javadoc: http://cloudera.github.io/cdk/docs/0.7.0/apidocs/index.html

We should go through the standard deprecation process for any public APIs we want to change. The published jdiff is a good way to check the changes you have made: http://cloudera.github.io/cdk/docs/0.7.0/jdiff/changes.html