Cover Images

Generate upload URLs for collection and track cover images.

POST /v1/collection/:collection_id/cover

Generates an upload URL for a collection's cover image

Parameters

Name Type Required Description
collection_id uuid Required The ID of the collection (path parameter)

Response

{
  "ok": true,
  "api_request_id": "uuid",
  "collection_id": "uuid",
  "collection": { /* Collection details */ },
  "collection_cover_upload": {
    "method": "POST",
    "upload_url": "url",
    "ttl": 3600,
    "expires_at": "string"
  }
}
POST /v1/track/:track_id/cover

Generates an upload URL for a track's cover image

Parameters

Name Type Required Description
track_id uuid Required The ID of the track (path parameter)

Response

{
  "ok": true,
  "api_request_id": "uuid",
  "track_id": "uuid",
  "track": { /* Track details */ },
  "track_cover_upload": {
    "method": "POST",
    "upload_url": "url",
    "ttl": 3600,
    "expires_at": "string"
  }
}