Submit a release for distribution
Changed onExisting v1 clients may omit expanded metadata and receive server defaults. New clients should provide distribution_store_ids, label, copyright credits, track_type, and role credits explicitly. A 422 validation_failed response carries a details array naming each offending field path, e.g. tracks[0].writers[0].name.
post/releases
Request
- Base URLhttps://once.app/v1
- AuthHTTP bearer
- TypeScriptA function with typed inputs. Its response is checked against the schema.
Request body
Example request
{
"release": {
"audio_language": "en",
"metadata_language": "en",
"language_and_script_code": "ja-Kana",
"contributors": [
{
"role": "Producer"
}
],
"artist_locals": [
{
"language_and_script_code": "ja-Latn"
}
],
"title_locals": [
{
"language_and_script_code": "ja-Latn"
}
]
},
"tracks": [
{
"language": "en",
"language_and_script_code": "ja-Kana",
"contributors": [
{
"role": "Producer"
}
],
"artist_locals": [
{
"language_and_script_code": "ja-Latn"
}
],
"title_locals": [
{
"language_and_script_code": "ja-Latn"
}
]
}
]
}Response
Submitted release
Changes
- info
added the new optional request property
/// - info
added the new optional request property
/ - info
added the new optional request property
/ - info
added the new optional request property
//// - info
added the new optional request property
// - info
added the new optional request property
//
- info