Sync Vault Media Tags
Set the creator tags and release forms on a vault media item that already exists, so they follow the file wherever it is reused. This replaces everything attached to the item with the lists you send. All three lists are required: send [] for a list to remove that category, and send [] for all three to clear the item. To add a tag without losing existing ones, first read the current tags with Get Vault Media Tags, then send the complete lists. Two writes at the same time can overwrite each other. Get creator IDs from List Taggable Users and release form IDs from List Release Forms.
Authorization
default Get your API Key from OnlyFansAPI Console - https://app.onlyfansapi.com/api-keys
In: header
Path Parameters
The Account ID
The ID of the vault media item. This is not a post ID, message ID or upload prefixed_id.
Request Body
application/json
Must be at least 1.
Must be at least 1.
Must be at least 1.
Response Body
application/json
curl -X PUT "https://app.fansapi.com/api/acct_XXXXXXXXXXXXXXX/media/vault/4650084641/attach-tags" \ -H "Content-Type: application/json" \ -d '{}'{
"data": {
"releaseForms": [
{
"id": 1094978,
"name": "test",
"partnerSource": "link",
"type": "link",
"status": "signed",
"code": "exampleReleaseFormCode1234567890",
"signature": "exampleSignature",
"date": "2026-11-19 01:00:00",
"approve_date": "2026-11-19 01:05:00",
"user": {
"view": "tu",
"id": 498947256,
"name": "Example Partner",
"username": "u498947256",
"isIdentityVerified": true,
"ivStatus": "approved",
"isFromGuest": false,
"avatar": null,
"avatarThumbs": null
}
},
{
"id": 15585607,
"name": "OnlyFans",
"partnerSource": "tag",
"type": "user",
"user": {
"view": "tu",
"id": 15585607,
"name": "OnlyFans",
"username": "onlyfans",
"isIdentityVerified": true,
"ivStatus": "approved",
"isFromGuest": false,
"avatar": null,
"avatarThumbs": null
}
}
],
"success": true
},
"_meta": {
"_credits": {
"used": 1,
"balance": 9999,
"note": "Always"
},
"_cache": {
"is_cached": false,
"note": "Cache disabled for this endpoint"
},
"_rate_limits": {
"limit_minute": 1000,
"limit_day": 50000,
"remaining_minute": 999,
"remaining_day": 49999
}
}
}