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.fansmetric.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.

Response Fields

  • dataobject | array

    Endpoint-specific payload. See the fields below for this route.

  • _meta._credits.usedinteger

    Credits consumed by this request (currently always 1).

  • _meta._rate_limits.limit_minuteinteger

    Maximum requests per minute for the organization.

  • _meta._rate_limits.remaining_minuteinteger

    Remaining requests in the current minute window.

  • _meta._rate_limits.limit_dayinteger

    Maximum requests per day for the organization.

  • _meta._rate_limits.remaining_dayinteger

    Remaining requests in the current day window.

curl --request POST "https://public-api.fansmetric.com/v1/100000001/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