> ## Documentation Index
> Fetch the complete documentation index at: https://docs.voiceflow.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Test overview

> Run conversations against an agent over HTTP. Send what a user would say, read the traces that come back, and inspect or reset the state between turns.

A conversation is the agent doing its job: a user says something, the agent
decides what to do, and everything it did comes back as typed events.

Driving that from your own code is how you put the agent behind a different
interface, or check how a change behaves before anyone else sees it.
Conversation state sits alongside, so you can read what the agent currently
believes, change a variable mid-turn, or start over.

## Endpoints

### Conversation

| Endpoint                                                                             | Description                     |
| ------------------------------------------------------------------------------------ | ------------------------------- |
| <Badge color="purple" size="sm">PUT</Badge> [Send](/api-reference/conversation/send) | Send message to a conversation. |

### Conversation state

| Endpoint                                                                                                             | Description                                                                                     |
| -------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- |
| <Badge color="green" size="sm">GET</Badge> [Get state](/api-reference/conversation-state/get-state)                  | Get conversation state for a user.                                                              |
| <Badge color="orange" size="sm">PATCH</Badge> [Update state](/api-reference/conversation-state/update-state)         | Update conversation state for a user.                                                           |
| <Badge color="red" size="sm">DELETE</Badge> [Delete state](/api-reference/conversation-state/delete-state)           | Delete conversation state for a user.                                                           |
| <Badge color="orange" size="sm">PATCH</Badge> [Update variables](/api-reference/conversation-state/update-variables) | Updates variables in the conversation state by merging with the properties in the request body. |

### Knowledge base query

| Endpoint                                                                                                              | Description                                              |
| --------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------- |
| <Badge color="blue" size="sm">POST</Badge> [Query knowledge base](/api-reference/knowledge-base/query-knowledge-base) | Execute a query against documents in the knowledge base. |