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.comAuthorization
defaultAuthorizationBearer <token>Send your FansMetric API key as a Bearer token in the Authorization header.
In: header
Path Parameters
account_id*integerOnlyFans numeric account ID.
media_id*integerThe vault media ID.
Request Body
application/jsonrfTagarrayOnlyFans user IDs of the creators to tag.
rfGuestarrayRelease-form guest IDs.
rfPartnerarrayRelease-form partner IDs.
Response Fields
dataobject | arrayEndpoint-specific payload. See the fields below for this route.
_meta._credits.usedintegerCredits consumed by this request (currently always
1)._meta._rate_limits.limit_minuteintegerMaximum requests per minute for the organization.
_meta._rate_limits.remaining_minuteintegerRemaining requests in the current minute window.
_meta._rate_limits.limit_dayintegerMaximum requests per day for the organization.
_meta._rate_limits.remaining_dayintegerRemaining requests in the current day window.
| Field | Type | Description |
|---|---|---|
| data | object | array | Endpoint-specific payload. See the fields below for this route. |
| _meta._credits.used | integer | Credits consumed by this request (currently always 1). |
| _meta._rate_limits.limit_minute | integer | Maximum requests per minute for the organization. |
| _meta._rate_limits.remaining_minute | integer | Remaining requests in the current minute window. |
| _meta._rate_limits.limit_day | integer | Maximum requests per day for the organization. |
| _meta._rate_limits.remaining_day | integer | 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
200Behavior
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.
400when no list is sent, or a list holds anything but whole-number IDs