v37

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

Submit Batch Feedback V1

Submit multiple feedback items in a single request.

Useful for submitting session-end feedback or bulk feedback collection.
Each feedback item is processed independently, so partial success is possible.

**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/batch

Request body

session_contextobject nullable

Session-level context for batch feedback

Example request

{
  "feedback_items": [
    {
      "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

Batch feedback processed successfully

codeinteger required

HTTP status code

statusstring required

'success' or 'error'

feedback_idsstring[]

List of feedback IDs

successful_countinteger

Number of successfully processed feedback items

failed_countinteger

Number of failed feedback items

errorsobject[]

List of error details

messagestring required

Human-readable message

errorstring nullable

Error message if status is 'error'