Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.ofauth.com/llms.txt

Use this file to discover all available pages before exploring further.

API responses include media.ofauth.com URLs for all media. These URLs automatically route to either edge cache or persistent storage (Vault+), and trigger auto-caching based on your configuration.
Media ProxyVault+
What it doesEdge-cached URLsPersistent storage with access by ID
SetupAutomaticEnable per connection
Best forDisplaying contentMedia libraries, PPV features

​
Displaying Media

Use media.ofauth.com URLs directly in your app: 
<img src="https://media.ofauth.com/abc123..." />
<video src="https://media.ofauth.com/xyz789..." controls />
When requested:
  1. If stored in Vault+ → serves from persistent storage
  2. Otherwise → fetches from OnlyFans, caches at edge

​
Setting Up Vault+

​
Enable for a Connection

curl -X PATCH 'https://api.ofauth.com/v2/account/connections/:connectionId/settings' \
  -H 'apikey: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{ "vaultPlus": { "enabled": true } }'

​
Configure Auto-Caching (Organization Defaults)

curl -X PATCH 'https://api.ofauth.com/v2/account/settings' \
  -H 'apikey: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "vaultPlus": {
      "autoEnableForNewConnections": true,
      "defaultSettings": {
        "autoCacheVault": true,
        "autoCacheMessages": false,
        "autoCachePosts": false
      }
    }
  }'
When autoCacheVault (or similar) is enabled, media is automatically queued for persistent storage when accessed via media.ofauth.com.

​
Triggering Caching

​
Via Media Proxy URL

POST to any media.ofauth.com URL to immediately queue for persistent storage: 
curl -X POST 'https://media.ofauth.com/abc123...'

​
Cache an Entire Vault List

curl -X POST 'https://api.ofauth.com/v2/vault-plus/store/list/:listId' \
  -H 'apikey: YOUR_API_KEY' \
  -H 'x-connection-id: conn_xxx'

​
Accessing Stored Media

​
Get by Media ID

curl -X GET 'https://api.ofauth.com/v2/vault-plus/:mediaId' \
  -H 'apikey: YOUR_API_KEY' \
  -H 'x-connection-id: conn_xxx'
Response: 
{
  "id": "12345",
  "type": "image",
  "duration": null,
  "media": {
    "full": {
      "id": "variant_abc123",
      "status": "stored",
      "quality": "full",
      "sizeBytes": 1024000,
      "contentType": "image/jpeg",
      "source": "vault",
      "accessCount": 12,
      "createdAt": 1715800000,
      "expiresAt": 1715886400,
      "storedAt": 1715800100,
      "lastAccessedAt": 1715800500,
      "url": "https://..."
    }
  }
}

​
Batch Get URLs (up to 100)

curl -X POST 'https://api.ofauth.com/v2/vault-plus/batch' \
  -H 'apikey: YOUR_API_KEY' \
  -H 'x-connection-id: conn_xxx' \
  -H 'Content-Type: application/json' \
  -d '{ "mediaIds": ["12345", "12346", "12347"] }'

​
List Stored Media

curl -X GET 'https://api.ofauth.com/v2/vault-plus/list?status=stored' \
  -H 'apikey: YOUR_API_KEY' \
  -H 'x-connection-id: conn_xxx'

​
Purging Stored Media

​
Via Media Proxy URL

curl -X DELETE 'https://media.ofauth.com/abc123...'

​
Via API

curl -X DELETE 'https://api.ofauth.com/v2/vault-plus/:mediaId' \
  -H 'apikey: YOUR_API_KEY' \
  -H 'x-connection-id: conn_xxx'

​
Purge All for a Connection

curl -X DELETE 'https://api.ofauth.com/v2/vault-plus/purge' \
  -H 'apikey: YOUR_API_KEY' \
  -H 'x-connection-id: conn_xxx'

Media & Vault

Full media operations guide

Access API

Complete API reference