Upload Media to Vault

Upload a media file directly to your vault.

Authorization

default

AuthorizationBearer <token>

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

In: header

Path Parameters

account*string

The Account ID

Request Body

multipart/form-data

file*string

The file to upload to the vault.

Response Body

`application/json`

curl -X POST "https://app.onlyfansapi.com/api/acct_XXXXXXXXXXXXXXX/media/vault" \
  -F file="string"

curl -X POST "https://app.onlyfansapi.com/api/acct_XXXXXXXXXXXXXXX/media/vault" \  -F file="string"

{
  "data": {
    "id": 123,
    "type": "photo",
    "convertedToVideo": false,
    "canView": true,
    "hasError": false,
    "createdAt": "2026-01-01T01:01:01+00:00",
    "isReady": false,
    "files": {
      "full": {
        "url": null,
        "width": 0,
        "height": 0,
        "size": 0,
        "sources": []
      },
      "thumb": null,
      "preview": null,
      "squarePreview": null
    },
    "duration": 0,
    "releaseForms": [],
    "hasCustomPreview": false
  },
  "_meta": {
    "_credits": {
      "used": 3,
      "balance": 999970,
      "note": "Always"
    },
    "_cache": {
      "is_cached": false,
      "note": "Cache disabled for this endpoint"
    },
    "_rate_limits": {
      "limit_minute": 5000,
      "limit_day": null,
      "remaining_minute": 4999,
      "remaining_day": null,
      "notice": "We have decided to remove our daily rate limits. Please remove any references to these in your integrations."
    }
  }
}