> For the complete documentation index, see [llms.txt](https://docs.humata.ai/guides/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.humata.ai/guides/humata-api/how-to-ask.md).

# How to Ask

Humata allows you to chat with your document via the Ask endpoint. Create a conversation and then ask your documents

{% openapi src="/files/ANwcOfL9PysJBUOoneIJ" path="/v1/ask" method="post" %}
[open-api.yaml](https://360245911-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZ8S8wUTipLV0NvvKYznS%2Fuploads%2Fgit-blob-4d955061fc20039380df41606f6cb4a77719b086%2Fopen-api.yaml?alt=media)
{% endopenapi %}

#### Server-Sent Events

The Ask Endpoint returns a stream of [server-sent events](https://developer.mozilla.org/en-US/docs/Web/API/Server-sent_events/Using_server-sent_events). Here is a full example of response to the question "Who is George Washington?":

```
data: { 'content': 'George Washington was ' }
data: { 'content': 'the first ' }
data: { 'content': 'president of the United States[3].' }
data: { 'content': '\n\nReferences - [3]: Page 10 of History of the United States.pdf' }
```

#### References

Each answer from Humata will provide references to the parts of the document that our AI used to answer the question. The format of references is subject to change.

###