Keep a character
- MCP tool
keep_character- CLI
kinetune characters keep
/api/v1/character-requests/{request_id}/keepNot sent from the docs: it changes your workspace. Run it with curl, the CLI or its MCP tool.
Keeps the sheet in the kit, as an artist or as named cast
artist_id: it is that artist (one each, in their own kit; replace true takes the place of theirs); or name: cast, with an @handle from the name (or handle), in owner_artist_id's kit (left out: the workspace's only artist, else its first, shared). shared true offers them to every other artist's videos too (default false). ai_made: ask the user whether this is an AI-made person who looks like no real person, or a real person (false: a model that needs a face check shows them once they pass it); never guess it. Left out, they count as real. The uploads are deleted, and replace true deletes the artist's current character for good.
AuthorizationBearer <token>An organization API key (kt_live_…) or an OAuth access token
request_id*stringThe request id (charreq_…)
1 <= lengthapplication/json- body
artist_id?stringIt is this artist
1 <= length <= 120owner_artist_id?stringCast only: the artist whose kit they go in (a project in a Creator workspace)
1 <= length <= 120shared?booleanOffer them to every other artist's videos too (default false)
name?stringA cast member's name
1 <= length <= 60handle?stringThe @handle, without @
^[a-z0-9-]{1,40}$replace?booleanReplace the artist's character
ai_made?booleanAn AI-made person who looks like no real person (true), or a real person (false)
curl -X POST 'https://kinetune.com/api/v1/character-requests/string/keep' \
-H 'Content-Type: application/json' \
-d '{}'