# Ai Copilot

**Category:** Admin
**Base URL:** `/admin/ai-feedback`
**Authentication:** Required
**Routes:** 3 routes documented

## Overview

This section documents 3 API routes for ai copilot.

> ⚠️ **These endpoints operate on your live store.** `POST`/`PUT`/`DELETE` operations here — including sync, push, resync, and cache operations — modify or delete production data, and some trigger downstream effects such as warehouse orders or customer emails. `DELETE` operations are generally irreversible. Verify IDs and parameters carefully before calling them from scripts.

## Quick Reference

| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | `/admin/ai-feedback` | GET /admin/ai-feedback List AI feedback with optional filter... |
| POST | `/admin/ai-feedback` | POST /admin/ai-feedback Create new AI feedback |
| GET | `/admin/ai-feedback/:id` | GET /admin/ai-feedback/:id Get a specific AI feedback entry |
| POST | `/admin/ai-feedback/:id` | POST /admin/ai-feedback/:id Update an AI feedback entry (typ... |
| DELETE | `/admin/ai-feedback/:id` | DELETE /admin/ai-feedback/:id Delete an AI feedback entry |
| GET | `/admin/ai-interactions` | GET /admin/ai-interactions/stats Get AI usage statistics for... |

---

## GET Admin Ai-feedback

**Endpoint:** `GET /admin/ai-feedback`
**Authentication:** Admin (Required)

### Description

GET /admin/ai-feedback List AI feedback with optional filtering and pagination

### Response

**Success:**
```typescript
{
  feedbacks,
  count,
  offset,
  limit,
}
```

**Error (500):**
```typescript
{
  message,
  error,
}
```

### Example Request

```bash
curl -X GET 'https://your-store.omnicart.cc/admin/ai-feedback' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json'
```

---

## POST Admin Ai-feedback

**Endpoint:** `POST /admin/ai-feedback`
**Authentication:** Admin (Required)

### Description

POST /admin/ai-feedback Create new AI feedback

### Request Body

This route does not declare a validation schema, so the accepted fields are not derivable from the source. Check the handler before relying on a particular body.

### Response

**Success (201):**
```typescript
{
  feedback,
}
```

**Error (400):**
```typescript
{
  message,
}
```
**Error (400):**
```typescript
{
  message,
}
```
**Error (400):**
```typescript
{
  message,
}
```
**Error (400):**
```typescript
{
  message,
}
```
**Error (400):**
```typescript
{
  message,
  error,
}
```

### Example Request

```bash
curl -X POST 'https://your-store.omnicart.cc/admin/ai-feedback' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json'
```

---

## GET Admin Ai-feedback :id

**Endpoint:** `GET /admin/ai-feedback/:id`
**Authentication:** Admin (Required)

### Description

GET /admin/ai-feedback/:id Get a specific AI feedback entry

### URL Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Id identifier |

### Response

**Success:**
```typescript
{
  feedback,
}
```

**Error (400):**
```typescript
{
  message,
}
```
**Error (404):**
```typescript
{
  message,
}
```
**Error (500):**
```typescript
{
  message,
  error,
}
```

### Example Request

```bash
curl -X GET 'https://your-store.omnicart.cc/admin/ai-feedback/:id' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json'
```

---

## POST Admin Ai-feedback :id

**Endpoint:** `POST /admin/ai-feedback/:id`
**Authentication:** Admin (Required)

### Description

POST /admin/ai-feedback/:id Update an AI feedback entry (typically for review purposes)

### URL Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Id identifier |

### Request Body

This route does not declare a validation schema, so the accepted fields are not derivable from the source. Check the handler before relying on a particular body.

### Response

**Success:**
```typescript
{
  feedback,
}
```

**Error (400):**
```typescript
{
  message,
}
```
**Error (400):**
```typescript
{
  message,
  error,
}
```

### Example Request

```bash
curl -X POST 'https://your-store.omnicart.cc/admin/ai-feedback/:id' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json'
```

---

## DELETE Admin Ai-feedback :id

**Endpoint:** `DELETE /admin/ai-feedback/:id`
**Authentication:** Admin (Required)

### Description

DELETE /admin/ai-feedback/:id Delete an AI feedback entry

### URL Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Id identifier |

### Response

**Success (200):**
```typescript
{
  id,
  deleted,
}
```

**Error (400):**
```typescript
{
  message,
}
```
**Error (400):**
```typescript
{
  message,
  error,
}
```

### Example Request

```bash
curl -X DELETE 'https://your-store.omnicart.cc/admin/ai-feedback/:id' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json'
```

---

## GET Admin Ai-interactions

**Endpoint:** `GET /admin/ai-interactions`
**Authentication:** Admin (Required)

### Description

GET /admin/ai-interactions/stats Get AI usage statistics for analytics dashboard

### Response

**Success:**
```typescript
{
  stats,
  recent_queries,
}
```

**Error (500):**
```typescript
{
  message,
  error,
}
```

### Example Request

```bash
curl -X GET 'https://your-store.omnicart.cc/admin/ai-interactions' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json'
```

---