v8

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

Remove Media From List

Remove one or multiple media from a list.

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

Request body

mediaIdsstring[] required

Array of media IDs to delete.

Example request

{
  "mediaIds": [
    1234567890
  ]
}

Response

Example response

{
  "data": {
    "id": 123,
    "type": "custom",
    "name": "My list",
    "hasMedia": false,
    "canUpdate": true,
    "canDelete": true,
    "videosCount": 0,
    "photosCount": 0,
    "gifsCount": 0,
    "audiosCount": 0,
    "medias": []
  },
  "_meta": {
    "_credits": {
      "used": 1,
      "balance": 971,
      "note": "Always"
    },
    "_cache": {
      "is_cached": false,
      "note": "Cache disabled for this endpoint"
    },
    "_rate_limits": {
      "limit_minute": 1000,
      "limit_day": 50000,
      "remaining_minute": 999,
      "remaining_day": 49916
    }
  }
}