# Stream Conversation (REST)

## Endpoint

The endpoint to access this history summary is working with a POST request, this time the API Token is not necessary.

```url
https://www.owlbot.ai/api/chatbot/ask
```

## Parameters needed

This post request required at least 3 parameters :

| Property        | Type   | Description                                                                |
| --------------- | ------ | -------------------------------------------------------------------------- |
| **prompt**      | string | Required. The question ask to the chatbot (can not exceed 3000 characters) |
| **chatbotUuid** | uuid   | Required. The `UUID` of the chatbot your speaking with.                    |
| **session**     | uuid   | Required. The `UUID` of the session your in.                               |

The `session` parameter can be : 

* "anonymous" : in this case, you will not be able to manage user conversation history and to get sources from the answer provided by chatbot. Each question asked by users are treated separately and user can not see his own history when ending session.
* `uuid` :  in this case, you have to provide a *valid and unique UUID* to distinguish every users. In this case, you will be able to recover each user history and to get sources.

## Examples

### In Vanilla Javascript 

```javascript
 async function _sendMessage(message) {
   
    let post = { prompt: message, chatbotUuid: "3c895cd5-1298-4f30-8417-XXXX", 
    session: "d48a5374-e952-4c5f-8c0f-XXXXXXX"}
    
    const response = await fetch(`https://www.owlbot.ai/api/chatbot/ask`, {
      method: 'POST',
      body: JSON.stringify(post),
    })

    if (!response.ok) {
      throw new Error(response.statusText)
    }

    const data = response.body
    if (!data) {
      return
    }

    const reader = data.getReader()
    const decoder = new TextDecoder()
    let done = false

     let answer = "";

    while (!done) {
      const { value, done: doneReading } = await reader.read()
      done = doneReading
      const chunkValue = decoder.decode(value)
      answer  += chunkValue 
        return answer  
      })

    }

    if (done) {
      answer   = ''

      console.log('done')
    }
  }
```