pub.chive.discovery.recordInteraction Documentation (EN)

main procedure

Record a user interaction with a recommendation for the feedback loop. Used to improve personalization over time.

Input

Encodingapplication/json

eprintUri stringat-uri Required

AT-URI of the eprint

recommendationId string Optional

ID of the recommendation that led to this interaction

type string Required

Type of interaction: view (viewed detail page), click (clicked recommendation), endorse (endorsed paper), dismiss (dismissed recommendation), claim (claimed authorship)

Output

Encodingapplication/json

recorded boolean Required

Whether the interaction was successfully recorded

Errors

AuthenticationRequired

Try It

Requests are sent directly from your browser. Some servers may block requests due to CORS.

Service Endpoint Base URL for XRPC calls (e.g., https://bsky.social)

Request Body (JSON) Enter valid JSON for the request body

View raw schema

{
  "type": "procedure",
  "input": {
    "schema": {
      "type": "object",
      "required": [
        "eprintUri",
        "type"
      ],
      "properties": {
        "type": {
          "type": "string",
          "description": "Type of interaction: view (viewed detail page), click (clicked recommendation), endorse (endorsed paper), dismiss (dismissed recommendation), claim (claimed authorship)",
          "knownValues": [
            "view",
            "click",
            "endorse",
            "dismiss",
            "claim"
          ]
        },
        "eprintUri": {
          "type": "string",
          "format": "at-uri",
          "description": "AT-URI of the eprint"
        },
        "recommendationId": {
          "type": "string",
          "description": "ID of the recommendation that led to this interaction"
        }
      }
    },
    "encoding": "application/json"
  },
  "errors": [
    {
      "name": "AuthenticationRequired"
    }
  ],
  "output": {
    "schema": {
      "type": "object",
      "required": [
        "recorded"
      ],
      "properties": {
        "recorded": {
          "type": "boolean",
          "description": "Whether the interaction was successfully recorded"
        }
      }
    },
    "encoding": "application/json"
  },
  "description": "Record a user interaction with a recommendation for the feedback loop. Used to improve personalization over time."
}