Rewrite a song’s brief from the song
- MCP tool
rewrite_song_brief- CLI
kinetune songs rewrite-brief
/api/v1/songs/{song_id}/briefNot sent from the docs: it changes your workspace. Run it with curl, the CLI or its MCP tool.
Drop the user’s correction and read the song again
Writes the brief again from the song as it is now (its lyrics and analysis), in the background: the answer has status writing; poll get_song until brief.status is ready, usually within half a minute. The user’s correction (brief.edited) is dropped, so ask first. Free; a few times a day per song (429 past that). 409 while the song is being analysed.
AuthorizationBearer <token>An organization API key (kt_live_…) or an OAuth access token
song_id*stringThe song id
1 <= length <= 120application/json- body
OK
application/json- response
status*stringwriting: being written (the fields are null until ready)
"writing""ready"theme*|What the song is about, in a sentence
tone*|Its register, in a few words
story*|The story or situation under the words (null for a mood piece)
mood_arc*array<>How the feeling moves through it, section by section
setting*|An era, a place or a scene it evokes (null when none)
edited*booleanThe user corrected it: directors read their version, and nothing replaces it until rewrite_song_brief
updated_at*string|null[key: string]?unknowncurl -X POST 'https://kinetune.com/api/v1/songs/string/brief' \
-H 'Content-Type: application/json' \
-d '{}'{
"status": "writing",
"theme": "string",
"tone": "string",
"story": "string",
"mood_arc": [
{
"section": "string",
"feeling": "string"
}
],
"setting": "string",
"edited": true,
"updated_at": "string",
"property1": null,
"property2": null
}