Developer docs

Make a video public

MCP tool
share_video
CLI
kinetune videos share
POST/api/v1/videos/{video_id}/share

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

Show a delivered video in the Community, its Look reusable by anyone

Only when the user asks for it, in their own words: ask them first and never make a video public on your own. Public, everyone signed in to Kinetune sees it in the Community, Kinetune may feature it on kinetune.com, and its Look becomes public with it so anyone can reuse it (a music video's concept: its kind, visual style, edit, places and props, never the artist or anyone else in it; a lyric video's Look unless it shows the artist or is Official); the workspace holds the Look's reward credits while it stays public. rights_confirmed (a music video needs it): the user confirms they have the right to show the artist and everyone in it publicly. socials true: the user also lets Kinetune post it on its socials (TikTok, Instagram, YouTube, X), crediting credit_handle. Never set rights_confirmed or socials on your own, and never assume them from an earlier answer: only when the user says so for this video. Sharing again replaces those choices; a video Kinetune's staff hid stays hidden. Only a delivered (completed) video. unshare_video makes it private again; get_video shows sharing.

headerAuthorizationBearer <token>

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

video_id*string

The video id

Length1 <= length <= 120
application/json
  1. body
rights_confirmed?boolean

The user confirmed they have the right to show the artist and everyone in it publicly (required for a music video). Only when they said so

socials?boolean

The user also lets Kinetune post it on its socials, crediting credit_handle (default false). Only when they said so

credit_handle?string

With socials: the @handle to credit (letters, digits, dots and underscores, up to 30), as the user gave it

Match^@?[A-Za-z0-9_.]{1,30}$

Response Body

OK

application/json
  1. response
video_id*string
sharing*|

Its place in the Community, or null while it is private

look*|

Its Look as making it public or private leaves it (a music video's concept, or the lyric video's Look); null when it has none

[key: string]?unknown
Example Request
curl -X POST 'https://kinetune.com/api/v1/videos/string/share' \
  -H 'Content-Type: application/json' \
  -d '{}'
Example Response
{
  "video_id": "string",
  "sharing": {
    "socials": true,
    "credit_handle": "string",
    "shared_at": "string",
    "featured": true,
    "hidden": true
  },
  "look": {
    "type": "music-video",
    "id": "string",
    "name": "string",
    "visibility": "private",
    "reward_credits": 0,
    "shows_artist": true,
    "official": true,
    "property1": null,
    "property2": null
  },
  "property1": null,
  "property2": null
}