Add a kit piece
add_kit_pieceAn outfit, place or prop from an image, a link or a stock photo, cropped The kit is what a music video is made from besides the artist’s character: outfits, places and props. Each is in one artist’s kit (owner_artist_id, a project in a Creator workspace; an outfit’s is its artist_id) and serves their songs; shared true offers it to every other artist’s songs too (owner_name says whose it is). Each has a name and an @handle unique in the workspace; a music video brief (direction) that mentions @handle uses that piece exactly as it is, and the director designs the rest. An outfit needs artist_id (its artist's kit); a place or prop goes in owner_artist_id's kit (left out: the workspace's only artist, else its first, shared). shared true offers it to every other artist's songs too (default false). The image is an upload or file_url (JPEG, PNG or WebP, at least 512 px on its short side, up to 15 MB, with rights_confirmed) or a stock_id from search_stock (credited, no rights needed). crop keeps a rectangle of it (fractions; at least 256 px on its short side), for a prop cut out of a bigger photo. handle follows the name (Blue set → blue-set; -2 when taken) unless given. Needs an active plan (402 plan_required without one; get_account: plan.active) and room in its storage (402 storage_full when it would not fit; get_account: storage).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"kind": "<kind>",
"name": "<name>"
},
"name": "add_kit_piece"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| crop | No | The rectangle to keep, in fractions of the image: {"x","y","w","h"}; the whole image when omitted | |
| kind | Yes | outfit (an artist’s), place or prop | |
| name | Yes | What it is called, e.g. Blue set | |
| handle | No | Its @handle (default: from the name) | |
| shared | No | Offer it to every other artist’s songs too (default false) | |
| file_url | No | A public https URL of the image (a file on your computer: create_upload's file_url, or upload it with the CLI) | |
| stock_id | No | A stock photo id from search_stock instead of an image | |
| artist_id | No | The artist an outfit belongs to (outfits only) | |
| description | No | What it is, for the director (a stock photo’s caption by default) | |
| owner_artist_id | No | A place or prop: the artist whose kit it goes in (a project in a Creator workspace) | |
| rights_confirmed | No | You have the rights to use the image (needed for an upload or file_url) |