FMFansMetric API

Vault

Sort Vault Lists

Persists the creator's preferred ordering for vault lists. The chosen sort applies the next time 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
}
}
}

Previous

Get Vault Media Types

Next

Get Vault Media Release Forms