v8

latestOpenAPI 3.0.3raw.githubusercontent.com2026-05-2526602.8 MB
Media Vault Lists

Add Media To List

Add one or multiple media to a list.

post/api/{account}/media/vault/lists/{list_id}/media

Request body

mediaIdsstring[] required

Array of media IDs to add.

Example request

{
  "mediaIds": [
    1234567890
  ]
}

Response

Example response

{
  "data": {
    "id": 123,
    "type": "custom",
    "name": "My list",
    "hasMedia": true,
    "canUpdate": true,
    "canDelete": true,
    "videosCount": 0,
    "photosCount": 1,
    "gifsCount": 0,
    "audiosCount": 0,
    "medias": [
      {
        "type": "photo",
        "url": "https://cdn2.onlyfans.com/files/..."
      }
    ]
  },
  "_meta": {
    "_credits": {
      "used": 1,
      "balance": 972,
      "note": "Always"
    },
    "_cache": {
      "is_cached": false,
      "note": "Cache disabled for this endpoint"
    },
    "_rate_limits": {
      "limit_minute": 1000,
      "limit_day": 50000,
      "remaining_minute": 996,
      "remaining_day": 49917
    }
  }
}