# SleekFlow API Questions

## General

1. API responses are not standardized including data and errors. It would be hard for various frontends to handle API responses.

2. The request body is not quite defined for each API, which it sometimes accepts array or object.

3. The requested fields are not defined as well. It would be taking up much times to guess the API according to API Docs.

4. Error messages are not defined, which would lead to hardly debug.

5. Too much nested duplicated data.

## Error API List
- `GET Get Conversation by userprofileId`
- `POST Update conversation status`
- `POST Conversation New Ticket`
- `GET Search Message In Conversation`

## Conversation API
- Difference between `POST Update conversation status` & `POST Set conversation HashTags` ?
- `GET GetConversations All` -> Get all the conversations from the company?
- `GET GetConversations Me` -> Get all the conversations including the user only?
- `GET Search Message all`, `GET Search Message assigned`, `Search Message In Conversation` -> What are the usecases for these 3 APIs?
- `GET Get conversation summary` -> Totally no idea about this

## Message API

- Sometimes it will return date, sometimes it will return empty array even success.

- Only `POST SendFacebookMessage ` will return data.

## UserProfile API
- `POST Search UserProfile` -> What are the search fields?
- Cannot distinguish the usage between `POST Update Custom Field ByID` & `POST Update Custom Field`
- `GET Get UserProfile` -> Get all the users from database?

## Company API

- Sometimes it will return the whole data, sometimes it will only return success message.

#### Examples
- `POST Update Staff Info` -> only success message
- `POST Add Profile Picture` -> detailed data
- `DEL Delete Profile Picture` -> only success message

#### Others
- Which APIs should we use for retriving, updating the contacts?