extract api for client actions