Developer docs

Change a kit piece

MCP tool
update_kit_piece
CLI
kinetune kit update
PATCH/api/v1/kit/{kit_id}

Not sent from the docs: it changes your workspace. Run it with curl, the CLI or its MCP tool.

Rename it, change its handle or description, or crop it again

crop is cut again from the image the piece was added from. Plans already made keep the pieces as they were planned.

Authorization

headerAuthorizationBearer <token>

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

Path Parameters

kit_id*string

The kit piece id

Length1 <= length <= 120

Request Body

application/json
  1. body
name?string
Length1 <= length <= 60
handle?string
Match^[a-z0-9][a-z0-9-]{0,39}$
description?|null
crop?

The new rectangle, in fractions of the source image

Response Body

OK

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