# Board Chat

Source: https://opvs.ai/docs/api/board-chat

## `GET` /api/v1/board/chat/sessions

**List Sessions**

List the current user's chat sessions for this brand.

**Parameters**

- `agent_persona_code` (query, any, optional)
- `agent_id` (query, any, optional)

```bash
curl -X GET 'https://app.opvs.ai/api/v1/board/chat/sessions' \
  -H 'Authorization: Bearer <token>'
```

```python
import httpx

resp = httpx.get(
    "https://app.opvs.ai/api/v1/board/chat/sessions",
    headers={"Authorization": "Bearer <token>"},
)
resp.raise_for_status()
print(resp.json())
```

```javascript
const resp = await fetch("https://app.opvs.ai/api/v1/board/chat/sessions", {
  method: "GET",
  headers: { "Authorization": "Bearer <token>" }
});
const data = await resp.json();
console.log(data);
```

```go
package main

import (
	"net/http"
)

func main() {
	req, _ := http.NewRequest("GET", "https://app.opvs.ai/api/v1/board/chat/sessions", nil)
	req.Header.Set("Authorization", "Bearer <token>")
	resp, _ := http.DefaultClient.Do(req)
	defer resp.Body.Close()
}
```

**Responses**

- `200` — Successful Response
- `422` — Validation Error

## `GET` /api/v1/board/chat/sessions/{session_id}

**Get Session**

Get a chat session with its message history.

**Parameters**

- `session_id` (path, string, required)

```bash
curl -X GET 'https://app.opvs.ai/api/v1/board/chat/sessions/{session_id}' \
  -H 'Authorization: Bearer <token>'
```

```python
import httpx

resp = httpx.get(
    "https://app.opvs.ai/api/v1/board/chat/sessions/{session_id}",
    headers={"Authorization": "Bearer <token>"},
)
resp.raise_for_status()
print(resp.json())
```

```javascript
const resp = await fetch("https://app.opvs.ai/api/v1/board/chat/sessions/{session_id}", {
  method: "GET",
  headers: { "Authorization": "Bearer <token>" }
});
const data = await resp.json();
console.log(data);
```

```go
package main

import (
	"net/http"
)

func main() {
	req, _ := http.NewRequest("GET", "https://app.opvs.ai/api/v1/board/chat/sessions/{session_id}", nil)
	req.Header.Set("Authorization", "Bearer <token>")
	resp, _ := http.DefaultClient.Do(req)
	defer resp.Body.Close()
}
```

**Responses**

- `200` — Successful Response
- `422` — Validation Error

## `DELETE` /api/v1/board/chat/sessions/{session_id}

**Delete Session**

Delete a chat session.

**Parameters**

- `session_id` (path, string, required)

```bash
curl -X DELETE 'https://app.opvs.ai/api/v1/board/chat/sessions/{session_id}' \
  -H 'Authorization: Bearer <token>'
```

```python
import httpx

resp = httpx.delete(
    "https://app.opvs.ai/api/v1/board/chat/sessions/{session_id}",
    headers={"Authorization": "Bearer <token>"},
)
resp.raise_for_status()
print(resp.json())
```

```javascript
const resp = await fetch("https://app.opvs.ai/api/v1/board/chat/sessions/{session_id}", {
  method: "DELETE",
  headers: { "Authorization": "Bearer <token>" }
});
const data = await resp.json();
console.log(data);
```

```go
package main

import (
	"net/http"
)

func main() {
	req, _ := http.NewRequest("DELETE", "https://app.opvs.ai/api/v1/board/chat/sessions/{session_id}", nil)
	req.Header.Set("Authorization", "Bearer <token>")
	resp, _ := http.DefaultClient.Do(req)
	defer resp.Body.Close()
}
```

**Responses**

- `200` — Successful Response
- `422` — Validation Error

## List Sessions

`GET https://app.opvs.ai/api/v1/board/chat/sessions`

List the current user's chat sessions for this brand.

| Code | When | What to do |
| --- | --- | --- |
| 422 | Validation Error |  |

## Get Session

`GET https://app.opvs.ai/api/v1/board/chat/sessions/{session_id}`

Get a chat session with its message history.

| Code | When | What to do |
| --- | --- | --- |
| 422 | Validation Error |  |

## Delete Session

`DELETE https://app.opvs.ai/api/v1/board/chat/sessions/{session_id}`

Delete a chat session.

| Code | When | What to do |
| --- | --- | --- |
| 422 | Validation Error |  |