Documentation Index
Fetch the complete documentation index at: https://api.lensmor.com/llms.txt
Use this file to discover all available pages before exploring further.
Events rank
Rank multiple events for the authenticated caller.
Endpoint
POST /external/events/rank
Authentication
See Authentication
Success status code
201 Created
Request body
| Field | Required | Type | Notes |
|---|
event_ids | Yes | string[] | Event identifiers returned by Lensmor event endpoints. |
Response body
Top-level fields
| Field | Type | Notes |
|---|
items | object[] | Ranked event summaries in descending match-score order. |
items[] fields
| Field | Type | Notes |
|---|
event_id | string | External event identifier. |
name | string | Event name. |
rank | integer | One-based rank in the returned order. |
match_score | number | Raw profile score rounded to two decimals. |
reasons | array | Optional explanatory labels for the ranking result. |
Response example
{
"items": [
{
"event_id": "139574",
"name": "Shoptalk",
"rank": 1,
"match_score": 0.82,
"reasons": []
}
]
}
Error responses
400 Bad Request when any event_ids entry is invalid.401 Unauthorized when the API key is missing, malformed, or invalid.404 Not Found when any requested event cannot be resolved.409 Conflict when the recommendation dependency is still processing.
