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

# DataChat

> Sample shape for DataChat.

Sample shape for `DataChat`.

## Sample JSON

Copy, edit, paste. Server-set fields (`id`, `created`, `tenantId`, …) are omitted from the example — they're populated by the server on response.

```json theme={null}
{
  "userId": "<user_id>",
  "title": "Example name",
  "messages": [
    "<chat-entry>"
  ]
}
```

## Fields

| Field       | Type                                          | Required   | Notes                                   |
| ----------- | --------------------------------------------- | ---------- | --------------------------------------- |
| `entity`    | string • nullable                             | Server-set | Set by the server. Read-only on writes. |
| `userId`    | string                                        | Optional   |                                         |
| `title`     | string                                        | Optional   |                                         |
| `messages`  | array\<[`ChatEntry`](/data-model/chat-entry)> | Optional   |                                         |
| `tenantId`  | string                                        | Server-set | Set by the server. Read-only on writes. |
| `id`        | string                                        | Server-set | Set by the server. Read-only on writes. |
| `created`   | string (date-time)                            | Server-set | Set by the server. Read-only on writes. |
| `createdBy` | string                                        | Server-set | Set by the server. Read-only on writes. |
| `updated`   | string (date-time)                            | Server-set | Set by the server. Read-only on writes. |
| `updatedBy` | string                                        | Server-set | Set by the server. Read-only on writes. |
| `deleted`   | boolean                                       | Server-set | Set by the server. Read-only on writes. |

## Used by

### Response body

* `GET /api/ai/conversation`