Suggestions

Suggest a genre

Suggest a better genre for a track. Suggestions are reviewed by the Sonovault team before they affect the catalog. A successful call returns the suggestion with status: "pending". Requires a paid plan.

Requires a paid plan: the free tier returns 403 for this endpoint.

Limits

  • Up to 100 suggestions per day per account. Can be increased upon request.
post/v1/tracks/{id}/suggestions

Request

  • Base URL: https://api.sonovault.now
  • URL: https://api.sonovault.now/v1/tracks/{id}/suggestions
  • Auth: API key in header x-api-key

Path parameters

idinteger required

Internal Sonovault track ID.

Request body

genreIdinteger required

a genre id from GET /v1/genres.

notestring

a short explanation for the reviewer, max 100 characters.

Response

Successful response

idinteger required

Suggestion ID.

track_idinteger required

The track the suggestion applies to.

field'genre' required

Which field is being corrected. Genre is the only field open to suggestions today.

notestring nullable required

Your note to the reviewer. null when none was given.

status'pending' | 'approved' | 'rejected' required

Review state. New suggestions come back as pending.

review_notestring nullable required

The reviewer's reply. null until reviewed, and often after.

created_atstring required

When you submitted it, ISO-8601 UTC.

reviewed_atstring nullable required

When it was reviewed, ISO-8601 UTC. null while pending.

Changes

No recorded changes to this operation across all 1 revision of this API.