Collecting

Add music to collection

POST https://api.rewind.rest/v1/admin/collecting/vinyl

Add a release to the Discogs collection. Searches Discogs by title/artist or accepts a discogs_id directly. Adds to Discogs, stores locally, and processes cover image.

Authorization

Authorizationheaderstringrequired

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

Body

discogs_idbodynumber

titlebodystring

artistbodystring

yearbodynumber

Response

application/json

Release added successfully

statusstringrequired

releaseobjectrequired

properties

discogsobjectrequired

properties

image_processedbooleanrequired

cURL

curl -X POST 'https://api.rewind.rest/v1/admin/collecting/vinyl' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -d '{"discogs_id": 0, "title": "string", "artist": "string", "year": 0}'

200

{
  "status": "string",
  "release": {
    "title": "string",
    "artist": "string",
    "year": 0,
    "discogs_id": 0,
    "format": "string"
  },
  "discogs": {
    "instance_id": 0
  },
  "image_processed": true
}