Feedback Management - Open WebUI

List All Feedbacks

Retrieve all feedback entries in the system. Admin only.

Response

array

Array of all feedback objects

Show FeedbackResponse properties

string

Unique feedback identifier

string

ID of the user who created the feedback

object

Feedback data including model_id, rating, sibling_model_ids, tags, etc.

integer

Unix timestamp of creation

integer

Unix timestamp of last update

curl -X GET "https://your-instance.com/api/evaluations/feedbacks/all" \
  -H "Authorization: Bearer $OPENWEBUI_API_KEY"

import requests

response = requests.get(
    "https://your-instance.com/api/evaluations/feedbacks/all",
    headers={"Authorization": f"Bearer {api_key}"}
)
feedbacks = response.json()

Get All Feedback IDs

Retrieve only the IDs of all feedback entries. Admin only. Useful for batch operations or checking feedback existence.

Response

array

Array of feedback ID objects

Show FeedbackIdResponse properties

string

Unique feedback identifier

curl -X GET "https://your-instance.com/api/evaluations/feedbacks/all/ids" \
  -H "Authorization: Bearer $OPENWEBUI_API_KEY"

[
  {"id": "feedback-uuid-1"},
  {"id": "feedback-uuid-2"},
  {"id": "feedback-uuid-3"}
]

Delete All Feedbacks

Delete all feedback entries from the system. Admin only. This action cannot be undone.

Response

boolean

Whether the deletion was successful

curl -X DELETE "https://your-instance.com/api/evaluations/feedbacks/all" \
  -H "Authorization: Bearer $OPENWEBUI_API_KEY"

import requests

response = requests.delete(
    "https://your-instance.com/api/evaluations/feedbacks/all",
    headers={"Authorization": f"Bearer {api_key}"}
)
result = response.json()

Export All Feedbacks

Export all feedback entries including full data models. Admin only. Returns the complete feedback objects for data export or backup.

Response

array

Array of complete feedback model objects

Show FeedbackModel properties

string

Unique feedback identifier

string

ID of the user who created the feedback

string

Type of feedback (e.g., “rating”, “comparison”)

object

Complete feedback data payload

object

Additional metadata

integer

Unix timestamp of creation

integer

Unix timestamp of last update

curl -X GET "https://your-instance.com/api/evaluations/feedbacks/all/export" \
  -H "Authorization: Bearer $OPENWEBUI_API_KEY" \
  -o feedbacks_export.json

import requests
import json

response = requests.get(
    "https://your-instance.com/api/evaluations/feedbacks/all/export",
    headers={"Authorization": f"Bearer {api_key}"}
)

with open('feedbacks_export.json', 'w') as f:
    json.dump(response.json(), f, indent=2)

Get User Feedbacks

Retrieve all feedback entries created by the authenticated user.

Response

array

Array of user’s feedback objects

Show FeedbackUserResponse properties

string

Unique feedback identifier

object

Feedback data

integer

Unix timestamp of creation

curl -X GET "https://your-instance.com/api/evaluations/feedbacks/user" \
  -H "Authorization: Bearer $OPENWEBUI_API_KEY"

import requests

response = requests.get(
    "https://your-instance.com/api/evaluations/feedbacks/user",
    headers={"Authorization": f"Bearer {api_key}"}
)
my_feedbacks = response.json()

Delete User Feedbacks

Delete all feedback entries created by the authenticated user.

Response

boolean

Whether the deletion was successful

curl -X DELETE "https://your-instance.com/api/evaluations/feedbacks" \
  -H "Authorization: Bearer $OPENWEBUI_API_KEY"

List Feedbacks (Paginated)

Retrieve a paginated list of feedback entries with sorting options. Admin only.

Query Parameters

string

Field to order results by (e.g., “created_at”, “updated_at”)

string

Sort direction: “asc” or “desc”

integer

default:"1"

Page number (1-indexed, minimum: 1)

Response

array

Array of feedback entries for the current page (30 items per page)

integer

Total number of feedback entries

integer

Current page number

integer

Total number of pages

curl -X GET "https://your-instance.com/api/evaluations/feedbacks/list?page=1&order_by=created_at&direction=desc" \
  -H "Authorization: Bearer $OPENWEBUI_API_KEY"

import requests

response = requests.get(
    "https://your-instance.com/api/evaluations/feedbacks/list",
    params={
        "page": 1,
        "order_by": "created_at",
        "direction": "desc"
    },
    headers={"Authorization": f"Bearer {api_key}"}
)
feedback_list = response.json()

{
  "items": [
    {
      "id": "feedback-uuid-1",
      "user_id": "user-123",
      "data": {
        "model_id": "gpt-4",
        "rating": "1",
        "sibling_model_ids": ["claude-3"],
        "tags": ["coding", "helpful"]
      },
      "created_at": 1709395200,
      "updated_at": 1709395200
    }
  ],
  "total": 150,
  "page": 1,
  "pages": 5
}

Create Feedback

Create a new feedback entry for model evaluation.

Request Body

string

Type of feedback (e.g., “rating”, “comparison”)

object

required

Feedback data payload

Show Common data properties

string

ID of the model being evaluated

string

Rating value: “1” (positive/win) or “-1” (negative/loss)

array

Array of model IDs that were compared against

array

Array of tags describing the conversation topic (e.g., [“coding”, “debugging”])

object

Additional metadata

Response

string

Unique identifier for the created feedback

string

ID of the user who created the feedback

string

Type of feedback

object

Feedback data

object

Metadata

integer

Unix timestamp of creation

integer

Unix timestamp of last update

curl -X POST "https://your-instance.com/api/evaluations/feedback" \
  -H "Authorization: Bearer $OPENWEBUI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "comparison",
    "data": {
      "model_id": "gpt-4",
      "rating": "1",
      "sibling_model_ids": ["claude-3", "llama-3"],
      "tags": ["coding", "python", "helpful"]
    },
    "meta": {
      "context": "code generation task"
    }
  }'

import requests

response = requests.post(
    "https://your-instance.com/api/evaluations/feedback",
    headers={"Authorization": f"Bearer {api_key}"},
    json={
        "type": "comparison",
        "data": {
            "model_id": "gpt-4",
            "rating": "1",
            "sibling_model_ids": ["claude-3", "llama-3"],
            "tags": ["coding", "python", "helpful"]
        },
        "meta": {
            "context": "code generation task"
        }
    }
)
feedback = response.json()

{
  "id": "feedback-uuid-new",
  "user_id": "user-123",
  "type": "comparison",
  "data": {
    "model_id": "gpt-4",
    "rating": "1",
    "sibling_model_ids": ["claude-3", "llama-3"],
    "tags": ["coding", "python", "helpful"]
  },
  "meta": {
    "context": "code generation task"
  },
  "created_at": 1709395200,
  "updated_at": 1709395200
}

Get Feedback by ID

Retrieve a specific feedback entry by ID. Users can only access their own feedback unless they are admins.

Path Parameters

string

required

Unique feedback identifier

Response

string

Unique feedback identifier

string

ID of the user who created the feedback

string

Type of feedback

object

Feedback data

object

Metadata

integer

Unix timestamp of creation

integer

Unix timestamp of last update

curl -X GET "https://your-instance.com/api/evaluations/feedback/feedback-uuid-1" \
  -H "Authorization: Bearer $OPENWEBUI_API_KEY"

import requests

feedback_id = "feedback-uuid-1"
response = requests.get(
    f"https://your-instance.com/api/evaluations/feedback/{feedback_id}",
    headers={"Authorization": f"Bearer {api_key}"}
)
feedback = response.json()

Update Feedback by ID

Update an existing feedback entry. Users can only update their own feedback unless they are admins.

Path Parameters

string

required

Unique feedback identifier

Request Body

string

Type of feedback

object

required

Updated feedback data payload

object

Updated metadata

Response

Returns the updated feedback object with the same structure as the create endpoint.

curl -X POST "https://your-instance.com/api/evaluations/feedback/feedback-uuid-1" \
  -H "Authorization: Bearer $OPENWEBUI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "data": {
      "model_id": "gpt-4",
      "rating": "1",
      "sibling_model_ids": ["claude-3"],
      "tags": ["coding", "python", "helpful", "clear"]
    }
  }'

import requests

feedback_id = "feedback-uuid-1"
response = requests.post(
    f"https://your-instance.com/api/evaluations/feedback/{feedback_id}",
    headers={"Authorization": f"Bearer {api_key}"},
    json={
        "data": {
            "model_id": "gpt-4",
            "rating": "1",
            "sibling_model_ids": ["claude-3"],
            "tags": ["coding", "python", "helpful", "clear"]
        }
    }
)
updated_feedback = response.json()

Delete Feedback by ID

Delete a specific feedback entry. Users can only delete their own feedback unless they are admins.

Path Parameters

string

required

Unique feedback identifier

Response

boolean

Whether the deletion was successful

curl -X DELETE "https://your-instance.com/api/evaluations/feedback/feedback-uuid-1" \
  -H "Authorization: Bearer $OPENWEBUI_API_KEY"

import requests

feedback_id = "feedback-uuid-1"
response = requests.delete(
    f"https://your-instance.com/api/evaluations/feedback/{feedback_id}",
    headers={"Authorization": f"Bearer {api_key}"}
)
result = response.json()

true

​List All Feedbacks

​Response

​Get All Feedback IDs

​Response

​Delete All Feedbacks

​Response

​Export All Feedbacks

​Response

​Get User Feedbacks

​Response

​Delete User Feedbacks

​Response

​List Feedbacks (Paginated)

​Query Parameters

​Response

​Create Feedback

​Request Body

​Response

​Get Feedback by ID

​Path Parameters

​Response

​Update Feedback by ID

​Path Parameters

​Request Body

​Response

​Delete Feedback by ID

​Path Parameters

​Response

List All Feedbacks

Response

Get All Feedback IDs

Response

Delete All Feedbacks

Response

Export All Feedbacks

Response

Get User Feedbacks

Response

Delete User Feedbacks

Response

List Feedbacks (Paginated)

Query Parameters

Response

Create Feedback

Request Body

Response

Get Feedback by ID

Path Parameters

Response

Update Feedback by ID

Path Parameters

Request Body

Response

Delete Feedback by ID

Path Parameters

Response