[api] Flesh out the API a bit further.