document the user service http api