NewFans API, previously OnlyFans API · A new name. A broader platform.
Fans API
OnlyFansMedia Vault

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.

PUT
/api/{account}/media/vault/{media_id}/attach-tags
AuthorizationBearer <token>

Get your API Key from OnlyFansAPI Console - https://app.onlyfansapi.com/api-keys

In: header

Path Parameters

account*string

The Account ID

media_id*integer

The ID of the vault media item. This is not a post ID, message ID or upload prefixed_id.

Request Body

application/json

rfTag?array<number>

Must be at least 1.

rfPartner?array<number>

Must be at least 1.

rfGuest?array<number>

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
    }
  }
}