Developer docs

List characters

MCP tool
list_characters
CLI
kinetune characters list
GET
/api/v1/characters

Try it with your own API key: it runs on that key's workspace, so a real key reads your real songs, videos and credits. Reads and quotes only; nothing is charged.

The people videos can show: your artists' characters and your cast

Each character is one sheet in the kit (a front close-up, full body front, three-quarter, profile and back, in a plain base outfit), made with start_character. artist_id set: it is that artist (one each); otherwise cast, used by its handle. Each is in one artist's kit (owner_artist_id, owner_name; an artist's character is in their own) and appears in their videos; shared true offers it to every other artist's videos too (update_kit_piece shares it). outfit is the base outfit line it was drawn in; missing lists the views an added sheet doesn't show.

headerAuthorizationBearer <token>

An organization API key (kt_live_…) or an OAuth access token

artist_id?string

Only this artist's character

Length1 <= length <= 120
owner_artist_id?string

Only those in this artist's kit: their own character and the people kept for them

Length1 <= length <= 120
for_artist_id?string

Those a video of this artist's songs can show: theirs first, then those other artists shared

Length1 <= length <= 120

Response Body

OK

Example Request
curl -X GET 'https://kinetune.com/api/v1/characters'
Example Response
Empty