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

# Admin Votes API

> Admin vote management — list, view, delete votes, and get voting statistics per model.

## GET /api/admin/votes

List all votes with pagination.

### Query parameters

| Parameter | Type    | Default | Description              |
| --------- | ------- | ------- | ------------------------ |
| `page`    | integer | 1       | Page number              |
| `limit`   | integer | 50      | Items per page (max 500) |

### Response

```json filename="Response" theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
{
  "success": true,
  "data": [
    {
      "vote_id": "v1-uuid",
      "user_id": "u1-uuid",
      "comparison_id": "c1-uuid",
      "winner_model_id": "m1-uuid",
      "created_at": "2025-01-15T10:00:00Z"
    }
  ],
  "count": 50,
  "total": 8765,
  "page": 1,
  "limit": 50
}
```

## GET /api/admin/votes/{id}

Get a single vote by UUID.

## GET /api/admin/votes/user/{userId}

Get all votes cast by a specific user.

## GET /api/admin/votes/model/{modelId}

Get all votes where a specific model was the winner.

## GET /api/admin/votes/comparison/{comparisonId}

Get all votes for a specific comparison.

## POST /api/admin/votes

Create a new vote (admin override).

### Request body

```json filename="Request Body" theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
{
  "user_id": "u1-uuid",
  "comparison_id": "c1-uuid",
  "winner_model_id": "m1-uuid"
}
```

## DELETE /api/admin/votes/{id}

Delete a vote by UUID.

## DELETE /api/admin/votes/user/{userId}

Delete all votes for a specific user.

## GET /api/admin/votes/stats

Get voting statistics per model — win counts for each model.

### Response

```json filename="Response" theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
{
  "success": true,
  "data": {
    "Llama 3.3 70B": {
      "model_id": "m1-uuid",
      "model_name": "llama-3.3-70b-versatile",
      "wins": 245
    },
    "Mixtral 8x7B": {
      "model_id": "m2-uuid",
      "model_name": "mixtral-8x7b-32768",
      "wins": 189
    }
  },
  "total_votes": 8765
}
```