Developer docs

Create an organization

MCP tool
create_organization
CLI
kinetune organizations create
POST/api/v1/organizations

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

A new organization owned by you, with its own music, videos, Looks and credits

Creates an empty organization (a workspace, in the app) with the signed-in person as its owner; with an API key, the member who created the key (the key needs organizations:write). type artist is for one artist (add that artist next with create_artist; its songs then need no artist_id), label for a roster. It starts with no plan and no credits: the owner chooses a plan in the app before anything can be created in it. These credentials keep acting for their current organization: to work in the new one, sign in again and pick it, or create an API key in it.

Authorization

headerAuthorizationBearer <token>

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

Request Body

application/json
  1. body
name*string

The workspace name, as people see it in the app (an artist workspace usually carries the artist name)

Length2 <= length <= 80
type*string

artist: one artist and its songs; label: a roster of artists

Value in"artist""label"

Response Body

OK

Example Request
curl -X POST 'https://kinetune.com/api/v1/organizations' \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "string",
  "type": "artist"
}'
Example Response
Empty