Input schema (JSON)
{
"type": "object",
"required": [
"format"
],
"properties": {
"name": {
"type": "string",
"description": "Design name shown on the dashboard (max 120 chars)"
},
"text": {
"type": "object",
"properties": {
"year": {
"type": "string"
},
"title": {
"type": "string"
},
"budget": {
"type": "string"
},
"origin": {
"type": "string"
},
"rating": {
"type": "string"
},
"revenue": {
"type": "string"
},
"runtime": {
"type": "string"
},
"tagline": {
"type": "string"
},
"texsOrg": {
"type": "string"
},
"writers": {
"type": "string"
},
"composer": {
"type": "string"
},
"director": {
"type": "string"
},
"overview": {
"type": "string"
},
"producer": {
"type": "string"
},
"starring": {
"type": "string"
},
"seasonEpisode": {
"type": "string"
}
},
"description": "Overrides for the fetched metadata (video formats only — on audio formats these come back as unsupported). Omit a field to keep the provider value.",
"additionalProperties": false
},
"style": {
"type": "object",
"properties": {
"font": {
"type": "string",
"description": "Font family for the whole design (on audio formats, every text section). Curated: Futura, Arial, Times New Roman, Impact, Courier New, Roboto Flex, Bebas Neue, League Gothic, Sofia Sans Extra Condensed, Nunito Sans, Stint Ultra Condensed, EB Garamond…"
},
"finish": {
"enum": [
"worn",
"clean",
"plain"
],
"type": "string",
"description": "'worn' (default) fills the back panel with the title's stills and adds a worn-paper texture; 'clean' is stills without the texture; 'plain' skips both. Video formats and jcard only (on jcard 'worn' is the texture alone); other audio formats report it as unsupported."
},
"useLogo": {
"type": "boolean",
"description": "true paints the provider's logo artwork for the title; false renders your title as text. Defaults to false when you set text.title, so a title you set is visible."
},
"background": {
"type": "object",
"properties": {
"color": {
"type": "string",
"description": "6-digit hex"
}
},
"additionalProperties": false
},
"labelColor": {
"type": "string",
"description": "Label / text color, 6-digit hex, e.g. #e8dcc0"
},
"productionLogos": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 4,
"description": "Video formats: Classic Logo ids (list_decals → classicLogos, e.g. \"rcacolumbia!\") for the spine and studio slot, in order (#1 is the spine). As the whole selection they REPLACE the title's own studio logos; [] removes the studio slot."
},
"productionLogoColor": {
"type": "string",
"description": "6-digit hex the studio logos are painted with ('tint' / 'solid'); absent = the label colour."
},
"productionLogoColorize": {
"enum": [
"off",
"tint",
"solid"
],
"type": "string",
"description": "Video formats: how the studio logos (style.productionLogos or the title's own) are painted. 'solid' (the default) fills them flat in the label colour — a full-colour mark like RCA/Columbia becomes a plain shape; 'off' keeps their original colours; 'tint' recolours while keeping shading."
}
},
"additionalProperties": false
},
"texts": {
"type": "array",
"items": {
"type": "object",
"required": [
"text"
],
"properties": {
"x": {
"type": "number",
"maximum": 100,
"minimum": 0
},
"y": {
"type": "number",
"maximum": 100,
"minimum": 0
},
"font": {
"type": "string",
"description": "Family name — a curated family or any Google font"
},
"side": {
"enum": [
"front",
"back"
],
"type": "string"
},
"size": {
"type": "number",
"maximum": 60,
"minimum": 0.5,
"description": "Font size, percent of the sheet height (default 9)"
},
"text": {
"type": "string",
"description": "The text; newlines allowed"
},
"align": {
"enum": [
"left",
"center",
"right"
],
"type": "string"
},
"color": {
"type": "string",
"description": "6-digit hex (default: the label colour)"
},
"width": {
"type": "integer",
"maximum": 100,
"minimum": 10,
"description": "Percent of the sheet width (default 50)"
},
"italic": {
"type": "boolean"
},
"weight": {
"type": "integer",
"maximum": 900,
"minimum": 100
},
"allCaps": {
"type": "boolean"
},
"rotation": {
"type": "integer",
"maximum": 360,
"minimum": -360
},
"lineHeight": {
"type": "number",
"maximum": 4,
"minimum": 0.5
},
"letterSpacing": {
"type": "number",
"maximum": 50,
"minimum": -20,
"description": "px"
}
},
"additionalProperties": false
},
"maxItems": 24,
"description": "Free text blocks placed on the label (the designer's Text tab). x/y are the block's center in percent of the sheet; width is the percent of the sheet width the block spans (text wraps); size is the font size as percent of the sheet height."
},
"decals": {
"type": "array",
"items": {
"type": "object",
"properties": {
"x": {
"type": "number",
"maximum": 100,
"minimum": 0,
"description": "Center, percent of the sheet width (default 50)"
},
"y": {
"type": "number",
"maximum": 100,
"minimum": 0,
"description": "Center, percent of the sheet height (default 50)"
},
"id": {
"type": "string",
"description": "A decal id from list_decals (e.g. \"rcacolumbia!\", \"04-rounded-rectangle\")"
},
"ref": {
"type": "string",
"pattern": "^upload:",
"description": "An upload ref, instead of id"
},
"side": {
"enum": [
"front",
"back"
],
"type": "string",
"description": "Two-sided formats only"
},
"color": {
"type": "string",
"description": "6-digit hex for colorize (default: the label colour)"
},
"layer": {
"enum": [
"over",
"under",
"background"
],
"type": "string",
"description": "'over' (default), 'under' the label's text and pictures, or 'background'"
},
"scale": {
"type": "integer",
"maximum": 900,
"minimum": 10,
"description": "The designer's size unit (100 = natural width ÷ 4 layout units); use instead of width"
},
"width": {
"type": "number",
"maximum": 200,
"minimum": 1,
"description": "Rendered width as percent of the sheet width (formats with placement.decals.layoutWidthUnits)"
},
"stretch": {
"type": "integer",
"maximum": 1000,
"minimum": 10,
"description": "Horizontal stretch, percent of the natural aspect"
},
"colorize": {
"enum": [
"tint",
"solid"
],
"type": "string",
"description": "Paint the decal one colour: 'tint' keeps its shading, 'solid' flattens it"
},
"rotation": {
"type": "integer",
"maximum": 360,
"minimum": -360
}
},
"additionalProperties": false
},
"maxItems": 24,
"description": "Stickers, graphics, shapes and the user's own images placed on the label. Each entry names a catalog decal by id (list_decals) OR an upload by ref (upload_image; needs the API key). x/y are percent of the sheet (center-anchored; see describe_format → placement for the coordinate space and the size units). Size with `width` (percent of the sheet width) where describe_format accepts it, else `scale`."
},
"format": {
"enum": [
"slipcover",
"side-load-vhs",
"doublevhs",
"betamax",
"compact-tape",
"bluray-cover",
"bluray-slipcover",
"dvd-cover",
"steelcase",
"clamshell",
"polycase",
"cardbox",
"disc",
"cassette",
"cassingle",
"jcard",
"cd",
"cd-tray",
"cd-insert",
"vinyl-label",
"vinyl-jacket",
"vinyl-sleeve",
"minidisc-label",
"minidisc-full-labels",
"minidisc-jcard",
"minidisc-cover",
"minidisc-tray"
],
"type": "string",
"description": "Which packaging format"
},
"images": {
"type": "object",
"properties": {
"logo": {
"type": "string",
"pattern": "^upload:",
"description": "A custom studio / production logo (video formats). It replaces the title's own studio logos on the spine and back panel. Upload a transparent PNG."
},
"panels": {
"type": "object",
"description": "Per-panel images keyed by the panel key describe_format reports (e.g. front, back, spine1). Unknown keys come back as unsupported.",
"additionalProperties": {
"oneOf": [
{
"type": "string",
"pattern": "^upload:"
},
{
"type": "object",
"required": [
"ref"
],
"properties": {
"fit": {
"enum": [
"fit",
"fill",
"stretch"
],
"type": "string"
},
"ref": {
"type": "string"
},
"opacity": {
"type": "number",
"maximum": 100,
"minimum": 0
}
},
"additionalProperties": false
}
]
}
},
"background": {
"oneOf": [
{
"type": "string",
"pattern": "^upload:"
},
{
"type": "object",
"required": [
"ref"
],
"properties": {
"fit": {
"enum": [
"fit",
"fill",
"stretch"
],
"type": "string"
},
"ref": {
"type": "string"
},
"opacity": {
"type": "number",
"maximum": 100,
"minimum": 0
}
},
"additionalProperties": false
}
],
"description": "One image over the whole sheet (all panels)."
}
},
"description": "The user's own artwork by upload ref (from upload_image). Needs the API key that owns the uploads. Single-surface formats only (describe_format → singleSurface). Each value is a ref string or { ref, fit, opacity }.",
"additionalProperties": false
},
"layout": {
"type": "object",
"properties": {
"hide": {
"type": "array",
"items": {
"enum": [
"poster",
"rating",
"texsOrg",
"overview",
"labelOverview",
"fbiWarning",
"rules",
"pullquote",
"pullquoteCredit",
"spineMeta",
"barcode",
"qrCode",
"spineLogo",
"title",
"tagline",
"year",
"origin",
"runtime",
"starring",
"director",
"budget",
"revenue",
"movieId",
"seasonEpisode",
"writers",
"composer",
"producer",
"productionLogos"
],
"type": "string"
},
"description": "Fields to hide on the design (video formats). 'poster' removes the cover art so a panel image or decal can carry the front."
},
"spine2": {
"type": "object",
"required": [
"title"
],
"properties": {
"title": {
"enum": [
"text",
"logo"
],
"type": "string",
"description": "Turns on Dual Spine and gives the second spine its own title: 'text' prints the title as text there, 'logo' paints the provider's wordmark. The first spine keeps style.useLogo / text.title. Formats with a second spine only (slipcover, doublevhs, betamax, compact-tape, bluray-slipcover, cardbox); elsewhere reported unsupported."
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"content": {
"type": "object",
"required": [
"type"
],
"properties": {
"id": {
"type": "string",
"description": "TMDB id (movie/tv) or iTunes collection id (album), if already known"
},
"type": {
"enum": [
"movie",
"tv",
"album"
],
"type": "string"
},
"query": {
"type": "string"
}
},
"description": "What the design is of. Provide a query, or an id from search_content. Video formats take movie/tv; audio formats (cassette, jcard, cd*, vinyl*, minidisc*) take album. For audio, the album alone builds the complete design — cover art, tracklist sides, QR code — and style.font / labelColor / background restyle it.",
"additionalProperties": false
}
},
"additionalProperties": false
}