api defined