Listening

Backfill listening images

POST https://api.rewind.rest/v1/listening/admin/backfill-images

Backfills missing images for albums and/or artists.

Authorization

Authorizationheaderstringrequired

API key. Read keys (rw_live_...) access GET endpoints. Admin keys (rw_admin_...) access all endpoints.

Body

typebodyenum (string)

Allowed valuesalbumsartistsall

limitbodyinteger

retrybodyboolean

Retry albums/artists that previously failed (source=none placeholders)

artistbodystring

Filter to a specific artist name (case-insensitive partial match)

Response

application/json

Backfill results

successbooleanrequired

resultsobjectrequired

cURL

curl -X POST 'https://api.rewind.rest/v1/listening/admin/backfill-images' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -d '{"type": "albums", "limit": 50, "retry": true, "artist": "Beastie Boys"}'

200

{
  "success": true,
  "results": {}
}