Developer docs

Keep a character

MCP tool
keep_character
CLI
kinetune characters keep
POST/api/v1/character-requests/{request_id}/keep

Not 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.

headerAuthorizationBearer <token>

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

request_id*string

The request id (charreq_…)

Length1 <= length
application/json
  1. body
artist_id?string

It is this artist

Length1 <= length <= 120
owner_artist_id?string

Cast only: the artist whose kit they go in (a project in a Creator workspace)

Length1 <= length <= 120
shared?boolean

Offer them to every other artist's videos too (default false)

name?string

A cast member's name

Length1 <= length <= 60
handle?string

The @handle, without @

Match^[a-z0-9-]{1,40}$
replace?boolean

Replace the artist's character

ai_made?boolean

An AI-made person who looks like no real person (true), or a real person (false)

Response Body

OK

Example Request
curl -X POST 'https://kinetune.com/api/v1/character-requests/string/keep' \
  -H 'Content-Type: application/json' \
  -d '{}'
Example Response
Empty