> ## 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 cached media to a vault list

> Fetches the current OF list and reconciles it against the previous sync baseline. First sync removes nothing. Later syncs purge only media missing from the current list and present in the previous baseline, unless another cached list still owns that media.



## OpenAPI

````yaml https://api.ofauth.com/openapi.json put /v2/vault-plus/lists/:listId/sync
openapi: 3.1.0
info:
  title: OFAuth API
  version: 1.0.0
  description: >-
    OFAuth API including Account, Connections, Link, Access, Dynamic Rules,
    Vault+, and Realtime webhook contracts
  contact:
    email: support@ofauth.com
    url: https://ofauth.com/
servers:
  - url: https://api.ofauth.com
security:
  - ApiKey: []
tags:
  - name: Account
    description: Account management endpoints.
  - name: Connections
    description: Connection management endpoints.
  - name: Link
    description: Link authentication and session endpoints.
  - name: Access
    description: All Access related endpoints.
  - name: Analytics
    description: 'Access: charts, tops, and performance metrics.'
  - 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: authenticated account details and settings.'
  - name: Stories
    description: 'Access: stories listing and management.'
  - name: Subscriptions
    description: 'Access: subscription offers, discounts, and management.'
  - name: Realtime
    description: >-
      Realtime webhook delivery contracts, including relayed OnlyFans websocket
      events.
  - name: Dynamic Rules
    description: Dynamic signing rules operations.
  - name: Vault+
    description: Vault+ caching and management.
externalDocs:
  description: OFAuth Developer Documentation
  url: https://docs.ofauth.com
paths:
  /v2/vault-plus/lists/:listId/sync:
    put:
      tags:
        - Vault+ Lists
      summary: Sync cached media to a vault list
      description: >-
        Fetches the current OF list and reconciles it against the previous sync
        baseline. First sync removes nothing. Later syncs purge only media
        missing from the current list and present in the previous baseline,
        unless another cached list still owns that media.
      parameters:
        - schema:
            type: string
            description: OnlyFans vault list ID to use for the authoritative sync.
            example: '28489180'
          required: true
          name: listId
          in: path
        - schema:
            type: string
            minLength: 1
            description: Connection ID whose Vault+ list cache should be read or modified.
            example: conn_v5bsqkzsjfk8cgr7hqbbw09t
          required: true
          name: x-connection-id
          in: header
      responses:
        '200':
          description: >-
            Authoritative list sync completed. First sync establishes the
            baseline and removes nothing. Later syncs remove only media missing
            from the current list and present in the previous sync baseline.
          content:
            application/json:
              schema:
                type: object
                properties:
                  synced:
                    type: boolean
                    description: Whether the sync completed.
                    example: true
                  listId:
                    type: string
                    description: OnlyFans vault list ID.
                    example: '28489180'
                  seen:
                    type: number
                    description: Number of media items seen in the current OF list fetch.
                    example: 42
                  addedItems:
                    type: number
                    description: >-
                      Number of current-list media items not already cached and
                      queued for caching.
                    example: 2
                  updatedItems:
                    type: number
                    description: >-
                      Number of current-list media items with changed
                      fingerprints or stale cached metadata, purged and queued
                      again.
                    example: 1
                  removedItems:
                    type: number
                    description: >-
                      Number of prior-baseline media items purged because they
                      are missing from the current list and not owned by another
                      cached list.
                    example: 4
                  unchangedItems:
                    type: number
                    description: >-
                      Number of current-list media items already present in the
                      previous sync baseline and still current.
                    example: 35
                  adoptedItems:
                    type: number
                    description: >-
                      Number of current-list media items already cached by
                      Vault+ but not present in this list's previous sync
                      baseline.
                    example: 0
                required:
                  - synced
                  - listId
                  - seen
                  - addedItems
                  - updatedItems
                  - removedItems
                  - unchangedItems
                  - adoptedItems
                description: Authoritative list sync response.
              example:
                synced: true
                listId: '28489180'
                seen: 42
                addedItems: 2
                updatedItems: 1
                removedItems: 4
                unchangedItems: 35
                adoptedItems: 0
        '400':
          description: The x-connection-id header is missing or invalid.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Human-readable error message.
                    example: Unauthorized
                required:
                  - error
                description: Error response.
              example:
                error: x-connection-id header is required
        '401':
          description: The API key is missing, invalid, or lacks the ACCOUNT scope.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Human-readable error message.
                    example: Unauthorized
                required:
                  - error
                description: Error response.
              example:
                error: Unauthorized
        '502':
          description: >-
            Vault+ could not fetch the live OnlyFans vault list for this
            connection, or the list exceeded the maximum fetch window.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Human-readable error message.
                    example: Unauthorized
                required:
                  - error
                description: Error response.
              example:
                error: Failed to fetch vault list media
      security:
        - ApiKey: []
components:
  securitySchemes:
    ApiKey:
      type: apiKey
      name: apiKey
      in: header
      description: >-
        Your OFAuth [API key](/quickstart#2-copy-your-api-key) for
        authenticating requests.

````