I can't give you feedback on your specific API. However, I will say that if you're not already about 80% sure that it's correct, it's probably wrong somehow.

I can't give you feedback on your specific API. However, I will say that if you're not already about 80% sure that it's correct, it's probably wrong somehow. Allow me to explain. An API is a pretty abstract thing. For it to be useful, you need to have a use-case for it. Generally, once you've defined what the problem is that you're solving, you know about 80% of what the API needs to look like. The rest is just a matter of iteration and trial and error. The best way to get at this is to write an application that uses the API. This should give you a pretty good idea of what kind of interface should be provided. Alternatively, your customers should give you an idea of what they want the API to do. Don't be afraid to ask probing questions if their needs are ambiguous.