Vault

Sort Vault Lists

Persists the creator's preferred ordering for vault lists. The chosen sort applies the next time [List Vault Lists](/api-reference/vault/list-vault-lists) is called. Pass one of the named sorts (media, recent, name, default) with a direction, or custom with an explicit customOrder array of list IDs. Requires permission api_vault_lists_sort.

https://public-api.buffmetrics.com
POST/v1/{account_id}/vault/lists/sort
Bearer

Authorization

default
AuthorizationBearer <token>

Send your FansMetric API key as a Bearer token in the Authorization header.

In: header

Path Parameters

  • account_id*integer

    OnlyFans numeric account ID.

Request Body

application/json
  • sort*string

    One of media (item count), recent (last modified), name (alphabetical), default (OF default order), or custom.

  • orderstring

    asc or desc. Required for named sorts. Ignored when sort is custom.

  • customOrderstring

    Array of vault list IDs in the exact order to persist. Required when sort is custom; must include every custom list the account owns.

curl --request POST "https://public-api.buffmetrics.com/v1/acct_XXXXX/vault/lists/sort" \
  --header "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{ "sort": "media", "order": "asc" }'

Response

200
{
"data":{
"success":true
}
"_meta":{
"_credits":{
"used":1
}
"_rate_limits":{
"limit_minute":1000
"remaining_minute":999
"limit_day":50000
"remaining_day":49999
}
}
}