Vault

Attach Tags To Vault Media

Tags the people who appear in a vault item — creators, guests and partners. Use it after uploading to tag the creators in a new file: see Uploading Media. Requires permission api_media_upload.

https://public-api.fansmetric.com
PUT/v1/{account_id}/vault/media/{media_id}/attach
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.

  • media_id*integer

    The vault media ID.

Request Body

application/json
  • rfTagarray

    OnlyFans user IDs of the creators to tag.

  • rfGuestarray

    Release-form guest IDs.

  • rfPartnerarray

    Release-form partner IDs.

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 PUT "https://public-api.fansmetric.com/v1/100000001/vault/media/sample_media_id/attach" \
  --header "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "rfTag":     [12345, 67890],
  "rfGuest":   [],
  "rfPartner": []
}'

Response

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

Behavior

Upstream OnlyFans endpoint: PUT /api2/v2/vault/media/{media_id}/attach.

Send at least one list. Each list you send replaces that kind of tag on the item, so an empty list removes them. A list you leave out is not sent.

A file that was only just sent can take a few seconds to reach the vault. If this fails right after sending, wait and try again — the FansMetric app waits 3 seconds and tries up to 3 times.

To see who is tagged now, use Get Vault Media Release Forms.

It uses the upload permission, api_media_upload, because tagging creators is part of uploading.

  • 400 when no list is sent, or a list holds anything but whole-number IDs