Using APIs to create Segments

We need to pull segments in our Datawarehouse so we can run email campaigns on them. I saw some posts on people doing it it but is there :

1) any documentation on how we do it

2) how does the segment get updated 

Thanks,

Neelima