curl --fail-with-body -X GET "$RAWCHUNKS_API/api/editing/history/$(jq -nr --arg v "$SONG_ID" '$v|@uri')" \
-H "x-session-user-address: $USER_ADDRESS"
{
"stems": [
{
"id": "<string>",
"song_id": "<string>",
"name": "<string>",
"url": "<string>",
"volume": 123,
"pan": 123,
"is_muted": true,
"is_solo": true,
"waveform_peaks_url": {},
"created_at": "<string>"
}
],
"takes": [
{
"id": "<string>",
"song_id": "<string>",
"stem_id": {},
"take_number": 123,
"model": "<string>",
"task": "<string>",
"url": "<string>",
"is_active": true,
"prompt": {},
"lyrics": {},
"repainting_start": {},
"repainting_end": {},
"seed": {},
"provenance": {
"target": "<string>",
"targetStemId": {},
"region": {
"start": 123,
"end": 123
},
"regions": [
{
"start": 123,
"end": 123
}
],
"audioOffset": 123,
"outputDuration": {},
"mergedInto": "<string>",
"layerName": "<string>"
},
"created_at": "<string>"
}
],
"commits": [
{
"id": "<string>",
"song_id": "<string>",
"user_address": "<string>",
"parent_commit_id": {},
"message": "<string>",
"timeline_snapshot": {},
"created_at": "<string>"
}
]
}Editing
Read editor history
Read stems, takes and newest-first commits.
GET
/
api
/
editing
/
history
/
{songId}
curl --fail-with-body -X GET "$RAWCHUNKS_API/api/editing/history/$(jq -nr --arg v "$SONG_ID" '$v|@uri')" \
-H "x-session-user-address: $USER_ADDRESS"
{
"stems": [
{
"id": "<string>",
"song_id": "<string>",
"name": "<string>",
"url": "<string>",
"volume": 123,
"pan": 123,
"is_muted": true,
"is_solo": true,
"waveform_peaks_url": {},
"created_at": "<string>"
}
],
"takes": [
{
"id": "<string>",
"song_id": "<string>",
"stem_id": {},
"take_number": 123,
"model": "<string>",
"task": "<string>",
"url": "<string>",
"is_active": true,
"prompt": {},
"lyrics": {},
"repainting_start": {},
"repainting_end": {},
"seed": {},
"provenance": {
"target": "<string>",
"targetStemId": {},
"region": {
"start": 123,
"end": 123
},
"regions": [
{
"start": 123,
"end": 123
}
],
"audioOffset": 123,
"outputDuration": {},
"mergedInto": "<string>",
"layerName": "<string>"
},
"created_at": "<string>"
}
],
"commits": [
{
"id": "<string>",
"song_id": "<string>",
"user_address": "<string>",
"parent_commit_id": {},
"message": "<string>",
"timeline_snapshot": {},
"created_at": "<string>"
}
]
}Use
commits[0]?.id ?? null as the current composition revision when merging. A commit snapshot is not a server-side undo command.
Headers and parameters
string
required
Resource ID.
string
required
Selected account address. Required for owner-scoped reads and writes. It identifies the account; your product must authenticate its own users.
Response (200)
Success.object[]
required
object[]
required
Show Properties
Show Properties
string
required
string
required
string | null
integer
string
string
string
required
boolean
required
string | null
string | null
number | null
number | null
integer | null
object | null
Show Properties
Show Properties
string
Values:
master, stem, layer.string | null
object | null
object[]
number
Source-buffer offset for the eligible section, in seconds.
number | null
string
string
string
object[]
required
Errors
Failed JSON responses contain anerror string. Check the HTTP status before reading a successful result. See job handling for interrupted or uncertain submissions.
| Status | Meaning |
|---|---|
400 | Invalid request. |
403 | Account does not match resource. |
404 | Resource not found. |
409 | Resource conflict; reload state or open an editable version. |
500 | Request failed. |
curl --fail-with-body -X GET "$RAWCHUNKS_API/api/editing/history/$(jq -nr --arg v "$SONG_ID" '$v|@uri')" \
-H "x-session-user-address: $USER_ADDRESS"
⌘I