| Who | Goals | Method | Path | Body | Returns |
|---|---|---|---|---|---|
| consumer | Get access token | POST | /token | user credentials | token |
| consumer | Create user | POST | /users | user credentials | user info |
| user | Update profile | GET | /users/me | - | user profile |
| user | Update profile | PATCH | /users/me | profile details | user profile |
| user | Get user list | GET | users/ | - | List of user profiles |
| user | Get user list | GET | users/{uname} | - | user profile (public) |
| user | Get friend list | GET | /friends | - | friend profile list |
| user | Get friend | GET | /friends/{uname} | - | friend profile |
| user | Post friend req | POST | /friends/{uname} | - | friend profile |
| user | Update Friendship status | UPDATE | /friends/{uname} | - | friend profile |
| user | Get chat ist | GET | /chats | - | list of users who chatted before |
| user | Get messages in a chat | GET | /chats/{uname}/?since= last_known_message | - | List of messages (optionally from a timestamp) |
| user | Post message/Initialize chat | POST | /chats/{uname} | Message Body | Send message |