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

# Pathway Chat

> Send a message to a pathway and receive a response.

### Headers

**authorization** `string` *required*

Your API key for authentication.

### Path Parameters

**id** `uuid` *required*

The chat ID created from the /pathway/chat/create endpoint.

### Body

**message** `string`

The message to send to the pathway (optional)

### Response

**data** `object`

Contains the response data for the pathway chat message.

**data properties**

**chat\_id** `uuid`

The ID of the chat instance.

**assistant\_responses** `array`

An array of strings containing the assistant's responses to the message sent.

**current\_node\_id** `string`

The ID of the current node in the pathway after processing the message.

**current\_node\_name** `string`

The name of the current node in the pathway.

**chat\_history** `array`

An array of objects containing the role and content of each message in the external chat history.

**pathway\_id** `string`

The ID of the pathway the chat is associated with.

**pathway\_version** `string | null`

The version of the pathway being used, or null if not specified.

**use\_candidate\_model** `boolean`

Whether the candidate model is being used for this pathway chat.

**variables** `object`

The current state of variables in the pathway execution.

**completed** `boolean`

Whether the pathway has completed execution.

**errors** `null | array`

Will be `null` on success. Contains error details if the request failed.

```json Response theme={null}
{
  "data": {
    "chat_id": "12345678-1234-1234-1234-123456789012",
    "assistant_responses": ["Hey there, this is the Bland Bistro reservation line. Do you want to make a reservation?"],
    "current_node_id": "1",
    "current_node_name": "Start",
    "chat_history": [
      {"role": "user", "content": "hello"},
      {"role": "assistant", "content": "Hey there, this is the Bland Bistro reservation line. Do you want to make a reservation?"}
    ],
    "pathway_id": "87654321-4321-4321-4321-210987654321",
    "pathway_version": null,
    "use_candidate_model": false,
    "variables": {
      "callID": "12345678-1234-1234-1234-123456789012"
    },
    "completed": false
  },
  "errors": null
}
```

***

Docs for agents: [llms.txt](https://docs.bland.ai/llms.txt)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.