PUT `/tracks/{track_urn}/storefront` returns 500 Internal Server Error for valid minimal JSON request

[Benjaminhu]

We are seeing a server-side error on the SoundCloud storefront endpoint.

Date observed: July 26, 2026

Endpoint: PUT /tracks/{track_urn}/storefront

Request:

• Authorization: OAuth
• Accept: application/json; charset=utf-8
• Content-Type: application/json

Minimal body:

{
"title": "Test A",
"type": "other",
"link": "https://example.com"
}

Result:

• Response status: 500 Internal Server Error
• Response body: empty

What we verified:

• application/json is required
• wrapped payload like { "storefront": { ... } } returns 400, so the endpoint expects a flat JSON body
• the same 500 happens with:
  • numeric track id path
  • URN path
  • minimal body
  • extended body with link_title, description, price
• POST and PATCH return 405 Method Not Allowed
• regular PUT /tracks/{track_urn} works correctly with the same OAuth token, including metadata updates, so auth/ownership appears valid

Expected behavior:

• The endpoint should either update the storefront successfully or return a structured 4xx error explaining what is invalid in the request.

Actual behavior:

• The endpoint returns 500 Internal Server Error for a valid minimal request.

[Benjaminhu]

curl -i -X PUT 'https://api.soundcloud.com/tracks/soundcloud:tracks:<ID>/storefront' \
    -H 'Authorization: OAuth <TOKEN>' \
    -H 'accept: application/json; charset=utf-8' \
    -H 'Content-Type: application/json' \
    --data '{"title":"Test A","type":"other","link":"<URL>"}'

+Why can't I upload a picture (artwork) here?