API for priorities. closes #5