updated api doco & created snippets for inclusing in connectiondetails page