> ## 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.

# Sync Vault+ list media

> Update saved media to match the current OnlyFans Vault folder. The first sync deletes nothing. Later syncs delete items saved by an earlier sync if they have left the folder. Items saved by another folder are kept.

**Required scope:** `vault:write`



## OpenAPI

````yaml /openapi/v3.json put /v3/vault-plus/lists/:listId/sync
openapi: 3.1.0
info:
  title: OFAuth API
  version: 1.0.0
  description: >-
    OFAuth V3 API for linking accounts, making OnlyFans API requests, and
    receiving events.
  contact:
    email: support@ofauth.com
    url: https://ofauth.com/
servers:
  - url: https://api.ofauth.com
security:
  - ExternalOAuth: []
tags:
  - name: Link
    description: Link accounts, get and refresh tokens, and end access.
  - name: Linked accounts
    description: The linked accounts of one authorization, and their settings.
  - name: Access
    description: Make OnlyFans API requests for a linked account.
  - name: Analytics
    description: 'Access: charts, rankings, and performance data.'
  - name: Earnings
    description: 'Access: earnings charts, transactions, and chargebacks.'
  - name: Messages
    description: 'Access: messaging, chats, queue, and mass messaging.'
  - name: Posts
    description: 'Access: create, edit, list, and manage posts.'
  - name: Promotions
    description: 'Access: promotions, trials, and bundles.'
  - name: Users
    description: 'Access: user profiles, subscriptions, and actions.'
  - name: Vault
    description: 'Access: vault folders, media, and management.'
  - name: Upload
    description: 'Access: media upload and processing.'
  - name: Self
    description: 'Access: linked account profile and settings.'
  - name: Stories
    description: 'Access: stories listing and management.'
  - name: Subscriptions
    description: 'Access: subscription offers, discounts, and management.'
  - name: Realtime
    description: Webhook event formats, including OnlyFans activity events.
externalDocs:
  description: OFAuth Developer Documentation
  url: https://docs.ofauth.com
paths:
  /v3/vault-plus/lists/:listId/sync:
    put:
      tags:
        - Vault+
      summary: Sync Vault+ list media
      description: >-
        Update saved media to match the current OnlyFans Vault folder. The first
        sync deletes nothing. Later syncs delete items saved by an earlier sync
        if they have left the folder. Items saved by another folder are kept.


        **Required scope:** `vault:write`
      operationId: vaultPlus.lists.sync
      parameters:
        - schema:
            type: string
            minLength: 1
            example: '123'
          required: true
          name: listId
          in: path
        - schema:
            type: string
            minLength: 1
            description: The linked account to use for this request.
            example: conn_123
          required: true
          name: x-linked-account-id
          in: header
      responses:
        '200':
          description: Sync result
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VaultPlusListSyncResult'
        '401':
          description: Missing, expired, or invalid OAuth access token
        '403':
          description: >-
            Vault+ is off for this integration environment, or your app lacks
            access to the linked account or the required scope.
        '404':
          description: Not found
        '502':
          description: OnlyFans vault list could not be fetched
        '503':
          description: Vault+ storage is temporarily unavailable
      security:
        - ExternalOAuth: []
          LinkedAccountId: []
components:
  schemas:
    VaultPlusListSyncResult:
      type: object
      properties:
        synced:
          type: boolean
        listId:
          type: string
        seen:
          type: number
        addedItems:
          type: number
        updatedItems:
          type: number
        removedItems:
          type: number
        unchangedItems:
          type: number
        adoptedItems:
          type: number
      required:
        - synced
        - listId
        - seen
        - addedItems
        - updatedItems
        - removedItems
        - unchangedItems
        - adoptedItems
  securitySchemes:
    ExternalOAuth:
      type: http
      scheme: bearer
      bearerFormat: opaque
      description: Link access token for one Sandbox, Test, or Live authorization.
    LinkedAccountId:
      type: apiKey
      name: x-linked-account-id
      in: header
      description: >-
        Selects one of the authorization's linked accounts via the
        x-linked-account-id header.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.