add type specs to the APIs

User picture
User picture