v1

latestSwagger 2.02026-07-17332466.5 KB

elements

Create Element in list

Required security scopes:

post/lists/{list_id}/elements

list_idstring required

The ID of the list to apply the operation on. Can be a to z (both upper/lower case), 0 to 9 or one of these characters _-.

rangeinteger

Return this number of elements above and below the current element in neighbors field.

idinteger required

ID of element

payloadobject

Custom payload. Stored untouched. On updates null means do not update. {} is the empty value.

scoreinteger required

Score of the element. Higher score gives higher placement.

tie_breakerinteger

Tie breaker, used if score matches for consistent sorting. Higher value = higher placement if score is equal.

{
  "id": 100,
  "payload": {
    "country": "dk",
    "name": "Mark Anthony"
  },
  "score": 100,
  "tie_breaker": 2000
}