Sign in

v37

latestOpenAPI 3.1.0raw.githubusercontent.com2026-06-1170194628.0 KB
v1
Feedback

Submit Feedback V1

Submit feedback on search results to help improve model performance.

This endpoint allows developers to provide feedback on:
- Overall answer quality (thumbs up/down, ratings)
- Specific memory relevance and accuracy
- User engagement signals (copy, save, create document actions)
- Corrections and improvements

The feedback is used to train and improve:
- Router model tier predictions
- Memory retrieval ranking
- Answer generation quality
- Agentic graph search performance

**Authentication Required**:
One of the following authentication methods must be used:
- Bearer token in `Authorization` header
- API Key in `X-API-Key` header
- Session token in `X-Session-Token` header

**Required Headers**:
- Content-Type: application/json
- X-Client-Type: (e.g., 'papr_plugin', 'browser_extension')
post/v1/feedback

Request body

search_idstring required

The search_id from SearchResponse that this feedback relates to

user_idstring nullable

Internal user ID (if not provided, will be resolved from authentication)

external_user_idstring nullable

External user ID for developer API keys acting on behalf of end users

organization_idstring nullable

Optional organization ID for multi-tenant feedback scoping. When provided, feedback is scoped to this organization.

namespace_idstring nullable

Optional namespace ID for multi-tenant feedback scoping. When provided, feedback is scoped to this namespace.

Example request

{
  "external_user_id": "dev_api_key_123",
  "feedbackData": {
    "assistantMessage": {
      "__type": "Pointer",
      "className": "PostMessage",
      "objectId": "abc123def456"
    },
    "citedMemoryIds": [
      "mem_123",
      "mem_456"
    ],
    "citedNodeIds": [
      "node_123",
      "node_456"
    ],
    "feedbackImpact": "positive",
    "feedbackProcessed": true,
    "feedbackScore": 1,
    "feedbackSource": "inline",
    "feedbackText": "This answer was very helpful and accurate",
    "feedbackType": "thumbs_up",
    "feedbackValue": "helpful",
    "userMessage": {
      "__type": "Pointer",
      "className": "PostMessage",
      "objectId": "abc123def456"
    }
  },
  "search_id": "abc123def456",
  "user_id": "abc123def456"
}

Response

Feedback submitted successfully

codeinteger required

HTTP status code

statusstring required

'success' or 'error'

feedback_idstring nullable

Unique feedback ID

messagestring required

Human-readable message

errorstring nullable

Error message if status is 'error'

detailsobject nullable

Additional error details