Images

Browse image alternatives

GET https://api.rewind.rest/v1/admin/images/{domain}/{entity_type}/{entity_id}/alternatives

Browse available images from all configured sources for an entity. Shows the current source and whether it is an override.

Authorization

Authorizationheaderstringrequired

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

Path Parameters

domainpathenum (string)required

Allowed valueslisteningwatchingcollectingreading

entity_typepathenum (string)required

Allowed valuesalbumsartistsmoviesshowsreleasesarticles

entity_idpathstringrequired

Query Parameters

artist_namequerystring

album_namequerystring

mbidquerystring

tmdb_idquerystring

Response

application/json

List of available image alternatives

entityobjectrequired

properties

current_sourcestringrequired

is_overridebooleanrequired

alternativesarray of objectrequired

properties

cURL

curl -X GET 'https://api.rewind.rest/v1/admin/images/{domain}/{entity_type}/{entity_id}/alternatives' \
  -H 'Authorization: Bearer <token>'

200

{
  "entity": {
    "domain": "string",
    "entity_type": "string",
    "entity_id": "string"
  },
  "current_source": "string",
  "is_override": true,
  "alternatives": [
    {
      "source": "cover-art-archive",
      "url": "uri",
      "width": 0,
      "height": 0
    }
  ]
}